QGIS API Documentation 3.99.0-Master (357b655ed83)
Loading...
Searching...
No Matches
qgsalgorithmslope.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmslope.cpp
3 ---------------------
4 begin : November 2019
5 copyright : (C) 2019 by Alexander Bruy
6 email : alexander dot bruy 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 "qgsalgorithmslope.h"
19
20#include "qgsrasterfilewriter.h"
21#include "qgsslopefilter.h"
22
23#include <QString>
24
25using namespace Qt::StringLiterals;
26
28
29QString QgsSlopeAlgorithm::name() const
30{
31 return u"slope"_s;
32}
33
34QString QgsSlopeAlgorithm::displayName() const
35{
36 return QObject::tr( "Slope" );
37}
38
39QStringList QgsSlopeAlgorithm::tags() const
40{
41 return QObject::tr( "dem,slope,terrain" ).split( ',' );
42}
43
44QString QgsSlopeAlgorithm::group() const
45{
46 return QObject::tr( "Raster terrain analysis" );
47}
48
49QString QgsSlopeAlgorithm::groupId() const
50{
51 return u"rasterterrainanalysis"_s;
52}
53
54QString QgsSlopeAlgorithm::shortHelpString() const
55{
56 return QObject::tr( "This algorithm calculates the angle of inclination "
57 "of the terrain from an input raster layer. The slope "
58 "is expressed in degrees." );
59}
60
61QString QgsSlopeAlgorithm::shortDescription() const
62{
63 return QObject::tr( "Calculates the angle of inclination of the terrain from an input raster layer." );
64}
65
66QgsSlopeAlgorithm *QgsSlopeAlgorithm::createInstance() const
67{
68 return new QgsSlopeAlgorithm();
69}
70
71void QgsSlopeAlgorithm::initAlgorithm( const QVariantMap & )
72{
73 addParameter( new QgsProcessingParameterRasterLayer( u"INPUT"_s, QObject::tr( "Elevation layer" ) ) );
74
75 auto zFactorParam = std::make_unique<QgsProcessingParameterNumber>( u"Z_FACTOR"_s, QObject::tr( "Z factor" ), Qgis::ProcessingNumberParameterType::Double, 1.0, false, 0.0 );
76 zFactorParam->setHelp( QObject::tr( "Multiplication factor to convert vertical Z units to horizontal XY units." ) );
77 zFactorParam->setMetadata(
78 { QVariantMap( { { u"widget_wrapper"_s, QVariantMap( { { u"decimals"_s, 12 } } ) } } )
79 }
80 );
81 addParameter( zFactorParam.release() );
82
83 auto outputNodataParam = std::make_unique<QgsProcessingParameterNumber>( u"NODATA"_s, QObject::tr( "Output NoData value" ), Qgis::ProcessingNumberParameterType::Double, -9999.0 );
84 outputNodataParam->setFlags( outputNodataParam->flags() | Qgis::ProcessingParameterFlag::Advanced );
85 addParameter( outputNodataParam.release() );
86
87 auto creationOptsParam = std::make_unique<QgsProcessingParameterString>( u"CREATION_OPTIONS"_s, QObject::tr( "Creation options" ), QVariant(), false, true );
88 creationOptsParam->setMetadata( QVariantMap( { { u"widget_wrapper"_s, QVariantMap( { { u"widget_type"_s, u"rasteroptions"_s } } ) } } ) );
89 creationOptsParam->setFlags( creationOptsParam->flags() | Qgis::ProcessingParameterFlag::Advanced );
90 addParameter( creationOptsParam.release() );
91
92 addParameter( new QgsProcessingParameterRasterDestination( u"OUTPUT"_s, QObject::tr( "Slope" ) ) );
93}
94
95bool QgsSlopeAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
96{
97 QgsRasterLayer *layer = parameterAsRasterLayer( parameters, u"INPUT"_s, context );
98 if ( !layer )
99 {
100 throw QgsProcessingException( invalidRasterError( parameters, u"INPUT"_s ) );
101 }
102
103 mLayerSource = layer->source();
104 return true;
105}
106
107QVariantMap QgsSlopeAlgorithm::processAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback *feedback )
108{
109 const double zFactor = parameterAsDouble( parameters, u"Z_FACTOR"_s, context );
110 const QString creationOptions = parameterAsString( parameters, u"CREATION_OPTIONS"_s, context ).trimmed();
111 const double outputNodata = parameterAsDouble( parameters, u"NODATA"_s, context );
112
113 const QString outputFile = parameterAsOutputLayer( parameters, u"OUTPUT"_s, context );
114 const QString outputFormat = parameterAsOutputRasterFormat( parameters, u"OUTPUT"_s, context );
115
116 QgsSlopeFilter slope( mLayerSource, outputFile, outputFormat );
117 if ( !creationOptions.isEmpty() )
118 {
119 slope.setCreationOptions( creationOptions.split( '|' ) );
120 }
121 slope.setOutputNodataValue( outputNodata );
122 slope.setZFactor( zFactor );
123 slope.processRaster( feedback );
124
125 QVariantMap outputs;
126 outputs.insert( u"OUTPUT"_s, outputFile );
127 return outputs;
128}
129
@ Advanced
Parameter is an advanced parameter which should be hidden from users by default.
Definition qgis.h:3834
@ Double
Double/float values.
Definition qgis.h:3875
QString source() const
Returns the source for the layer.
Contains information about the context in which a processing algorithm is executed.
Custom exception class for processing related exceptions.
Base class for providing feedback from a processing algorithm.
A raster layer destination parameter, for specifying the destination path for a raster layer created ...
A raster layer parameter for processing algorithms.
Represents a raster layer.
Calculates slope values in a window of 3x3 cells based on first order derivatives in x- and y- direct...