QGIS API Documentation  3.4.15-Madeira (e83d02e274)
qgsalgorithmvectorize.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsalgorithmvectorize.cpp
3  ---------------------
4  begin : June, 2018
5  copyright : (C) 2018 by Nyall Dawson
6  email : nyall dot dawson at gmail dot com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #include "qgsalgorithmvectorize.h"
19 #include "qgis.h"
20 #include "qgsprocessing.h"
21 
23 
24 QString QgsVectorizeAlgorithmBase::group() const
25 {
26  return QObject::tr( "Vector creation" );
27 }
28 
29 QString QgsVectorizeAlgorithmBase::groupId() const
30 {
31  return QStringLiteral( "vectorcreation" );
32 }
33 
34 void QgsVectorizeAlgorithmBase::initAlgorithm( const QVariantMap & )
35 {
36  addParameter( new QgsProcessingParameterRasterLayer( QStringLiteral( "INPUT_RASTER" ),
37  QObject::tr( "Raster layer" ) ) );
38  addParameter( new QgsProcessingParameterBand( QStringLiteral( "RASTER_BAND" ),
39  QObject::tr( "Band number" ), 1, QStringLiteral( "INPUT_RASTER" ) ) );
40  addParameter( new QgsProcessingParameterString( QStringLiteral( "FIELD_NAME" ),
41  QObject::tr( "Field name" ), QStringLiteral( "VALUE" ) ) );
42 
43  addParameter( new QgsProcessingParameterFeatureSink( QStringLiteral( "OUTPUT" ), outputName(), outputType() ) );
44 }
45 
46 bool QgsVectorizeAlgorithmBase::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
47 {
48  QgsRasterLayer *layer = parameterAsRasterLayer( parameters, QStringLiteral( "INPUT_RASTER" ), context );
49 
50  if ( !layer )
51  throw QgsProcessingException( invalidRasterError( parameters, QStringLiteral( "INPUT_RASTER" ) ) );
52 
53  mBand = parameterAsInt( parameters, QStringLiteral( "RASTER_BAND" ), context );
54  if ( mBand < 1 || mBand > layer->bandCount() )
55  throw QgsProcessingException( QObject::tr( "Invalid band number for RASTER_BAND (%1): Valid values for input raster are 1 to %2" ).arg( mBand )
56  .arg( layer->bandCount() ) );
57 
58  mInterface.reset( layer->dataProvider()->clone() );
59  mExtent = layer->extent();
60  mCrs = layer->crs();
61  mRasterUnitsPerPixelX = std::abs( layer->rasterUnitsPerPixelX() );
62  mRasterUnitsPerPixelY = std::abs( layer->rasterUnitsPerPixelY() );
63  mNbCellsXProvider = mInterface->xSize();
64  mNbCellsYProvider = mInterface->ySize();
65  return true;
66 }
67 
68 QVariantMap QgsVectorizeAlgorithmBase::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
69 {
70  const QString fieldName = parameterAsString( parameters, QStringLiteral( "FIELD_NAME" ), context );
71  QgsFields fields;
72  fields.append( QgsField( fieldName, QVariant::Double, QString(), 20, 8 ) );
73 
74  QString dest;
75  std::unique_ptr< QgsFeatureSink > sink( parameterAsSink( parameters, QStringLiteral( "OUTPUT" ), context, dest, fields, sinkType(), mCrs ) );
76  if ( !sink )
77  throw QgsProcessingException( invalidSinkError( parameters, QStringLiteral( "OUTPUT" ) ) );
78 
79 
82 
83  QgsRasterIterator iter( mInterface.get() );
84  iter.startRasterRead( mBand, mNbCellsXProvider, mNbCellsYProvider, mExtent );
85 
86  int nbBlocksWidth = static_cast< int >( std::ceil( 1.0 * mNbCellsXProvider / maxWidth ) );
87  int nbBlocksHeight = static_cast< int >( std::ceil( 1.0 * mNbCellsYProvider / maxHeight ) );
88  int nbBlocks = nbBlocksWidth * nbBlocksHeight;
89 
90  int iterLeft = 0;
91  int iterTop = 0;
92  int iterCols = 0;
93  int iterRows = 0;
94  std::unique_ptr< QgsRasterBlock > rasterBlock;
95  QgsRectangle blockExtent;
96  while ( iter.readNextRasterPart( mBand, iterCols, iterRows, rasterBlock, iterLeft, iterTop, &blockExtent ) )
97  {
98  if ( feedback )
99  feedback->setProgress( 100 * ( ( iterTop / maxHeight * nbBlocksWidth ) + iterLeft / maxWidth ) / nbBlocks );
100  if ( feedback && feedback->isCanceled() )
101  break;
102 
103  double currentY = blockExtent.yMaximum() - 0.5 * mRasterUnitsPerPixelY;
104 
105  for ( int row = 0; row < iterRows; row++ )
106  {
107  if ( feedback && feedback->isCanceled() )
108  break;
109 
110  double currentX = blockExtent.xMinimum() + 0.5 * mRasterUnitsPerPixelX;
111 
112  for ( int column = 0; column < iterCols; column++ )
113  {
114  if ( !rasterBlock->isNoData( row, column ) )
115  {
116  QgsGeometry pixelRectGeometry = createGeometryForPixel( currentX, currentY, mRasterUnitsPerPixelX, mRasterUnitsPerPixelY );
117  double value = rasterBlock->value( row, column );
118 
119  QgsFeature f;
120  f.setGeometry( pixelRectGeometry );
121  f.setAttributes( QgsAttributes() << value );
122  sink->addFeature( f, QgsFeatureSink::FastInsert );
123  }
124  currentX += mRasterUnitsPerPixelX;
125  }
126  currentY -= mRasterUnitsPerPixelY;
127  }
128  }
129 
130  QVariantMap outputs;
131  outputs.insert( QStringLiteral( "OUTPUT" ), dest );
132  return outputs;
133 }
134 
135 //
136 // QgsRasterPixelsToPolygonsAlgorithm
137 //
138 
139 QString QgsRasterPixelsToPolygonsAlgorithm::name() const
140 {
141  return QStringLiteral( "pixelstopolygons" );
142 }
143 
144 QString QgsRasterPixelsToPolygonsAlgorithm::displayName() const
145 {
146  return QObject::tr( "Raster pixels to polygons" );
147 }
148 
149 QStringList QgsRasterPixelsToPolygonsAlgorithm::tags() const
150 {
151  return QObject::tr( "vectorize,polygonize,raster,convert,pixels" ).split( ',' );
152 }
153 
154 QString QgsRasterPixelsToPolygonsAlgorithm::shortHelpString() const
155 {
156  return QObject::tr( "This algorithm converts a raster layer to a vector layer, by creating polygon features "
157  "for each individual pixel's extent in the raster layer.\n\n"
158  "Any nodata pixels are skipped in the output." );
159 }
160 
161 QString QgsRasterPixelsToPolygonsAlgorithm::shortDescription() const
162 {
163  return QObject::tr( "Creates a vector layer of polygons corresponding to each pixel in a raster layer." );
164 }
165 
166 QgsRasterPixelsToPolygonsAlgorithm *QgsRasterPixelsToPolygonsAlgorithm::createInstance() const
167 {
168  return new QgsRasterPixelsToPolygonsAlgorithm();
169 }
170 
171 QString QgsRasterPixelsToPolygonsAlgorithm::outputName() const
172 {
173  return QObject::tr( "Vector polygons" );
174 }
175 
176 QgsProcessing::SourceType QgsRasterPixelsToPolygonsAlgorithm::outputType() const
177 {
179 }
180 
181 QgsWkbTypes::Type QgsRasterPixelsToPolygonsAlgorithm::sinkType() const
182 {
183  return QgsWkbTypes::Polygon;
184 }
185 
186 QgsGeometry QgsRasterPixelsToPolygonsAlgorithm::createGeometryForPixel( double centerX, double centerY, double pixelWidthX, double pixelWidthY ) const
187 {
188  const double hCellSizeX = pixelWidthX / 2.0;
189  const double hCellSizeY = pixelWidthY / 2.0;
190  return QgsGeometry::fromRect( QgsRectangle( centerX - hCellSizeX, centerY - hCellSizeY, centerX + hCellSizeX, centerY + hCellSizeY ) );
191 }
192 
193 
194 //
195 // QgsRasterPixelsToPointsAlgorithm
196 //
197 
198 QString QgsRasterPixelsToPointsAlgorithm::name() const
199 {
200  return QStringLiteral( "pixelstopoints" );
201 }
202 
203 QString QgsRasterPixelsToPointsAlgorithm::displayName() const
204 {
205  return QObject::tr( "Raster pixels to points" );
206 }
207 
208 QStringList QgsRasterPixelsToPointsAlgorithm::tags() const
209 {
210  return QObject::tr( "vectorize,polygonize,raster,convert,pixels,centers" ).split( ',' );
211 }
212 
213 QString QgsRasterPixelsToPointsAlgorithm::shortHelpString() const
214 {
215  return QObject::tr( "This algorithm converts a raster layer to a vector layer, by creating point features "
216  "for each individual pixel's center in the raster layer.\n\n"
217  "Any nodata pixels are skipped in the output." );
218 }
219 
220 QString QgsRasterPixelsToPointsAlgorithm::shortDescription() const
221 {
222  return QObject::tr( "Creates a vector layer of points corresponding to each pixel in a raster layer." );
223 }
224 
225 QgsRasterPixelsToPointsAlgorithm *QgsRasterPixelsToPointsAlgorithm::createInstance() const
226 {
227  return new QgsRasterPixelsToPointsAlgorithm();
228 }
229 
230 QString QgsRasterPixelsToPointsAlgorithm::outputName() const
231 {
232  return QObject::tr( "Vector points" );
233 }
234 
235 QgsProcessing::SourceType QgsRasterPixelsToPointsAlgorithm::outputType() const
236 {
238 }
239 
240 QgsWkbTypes::Type QgsRasterPixelsToPointsAlgorithm::sinkType() const
241 {
242  return QgsWkbTypes::Point;
243 }
244 
245 QgsGeometry QgsRasterPixelsToPointsAlgorithm::createGeometryForPixel( double centerX, double centerY, double, double ) const
246 {
247  return QgsGeometry( new QgsPoint( centerX, centerY ) );
248 }
249 
251 
252 
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition: qgsfeedback.h:54
Use faster inserts, at the cost of updating the passed features to reflect changes made at the provid...
A rectangle specified with double values.
Definition: qgsrectangle.h:40
double rasterUnitsPerPixelY() const
Returns the number of raster units per each raster pixel in Y axis.
Base class for providing feedback from a processing algorithm.
Iterator for sequentially processing raster cells.
double yMaximum() const
Returns the y maximum value (top side of rectangle).
Definition: qgsrectangle.h:171
This class provides qgis with the ability to render raster datasets onto the mapcanvas.
double rasterUnitsPerPixelX() const
Returns the number of raster units per each raster pixel in X axis.
QgsRasterInterface * clone() const override=0
Clone itself, create deep copy.
void setProgress(double progress)
Sets the current progress for the feedback object.
Definition: qgsfeedback.h:63
Container of fields for a vector layer.
Definition: qgsfields.h:42
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:106
void setAttributes(const QgsAttributes &attrs)
Sets the feature&#39;s attributes.
Definition: qgsfeature.cpp:127
A raster band parameter for Processing algorithms.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:55
A feature sink output for processing algorithms.
static QgsGeometry fromRect(const QgsRectangle &rect)
Creates a new geometry from a QgsRectangle.
QgsRasterDataProvider * dataProvider() override
Returns the layer&#39;s data provider.
A raster layer parameter for processing algorithms.
Type
The WKB type describes the number of dimensions a geometry has.
Definition: qgswkbtypes.h:68
int bandCount() const
Returns the number of bands in this layer.
virtual QgsRectangle extent() const
Returns the extent of the layer.
static const int DEFAULT_MAXIMUM_TILE_HEIGHT
Default maximum tile height.
Custom exception class for processing related exceptions.
Definition: qgsexception.h:82
bool append(const QgsField &field, FieldOrigin origin=OriginProvider, int originIndex=-1)
Appends a field. The field must have unique name, otherwise it is rejected (returns false) ...
Definition: qgsfields.cpp:59
Vector polygon layers.
Definition: qgsprocessing.h:50
Encapsulate a field in an attribute table or data source.
Definition: qgsfield.h:48
Point geometry type, with support for z-dimension and m-values.
Definition: qgspoint.h:37
Vector point layers.
Definition: qgsprocessing.h:48
void setGeometry(const QgsGeometry &geometry)
Set the feature&#39;s geometry.
Definition: qgsfeature.cpp:137
SourceType
Data source types enum.
Definition: qgsprocessing.h:44
A vector of attributes.
Definition: qgsattributes.h:57
Contains information about the context in which a processing algorithm is executed.
static const int DEFAULT_MAXIMUM_TILE_WIDTH
Default maximum tile width.
double xMinimum() const
Returns the x minimum value (left side of rectangle).
Definition: qgsrectangle.h:166
A string parameter for processing algorithms.
void startRasterRead(int bandNumber, int nCols, int nRows, const QgsRectangle &extent, QgsRasterBlockFeedback *feedback=nullptr)
Start reading of raster band.
QgsCoordinateReferenceSystem crs
Definition: qgsmaplayer.h:70