QGIS API Documentation 3.39.0-Master (9ea1ddbe645)
Loading...
Searching...
No Matches
qgsalgorithmsplitlinesbylength.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmsplitlinesbylength.cpp
3 ---------------------
4 begin : December 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
19#include "qgscurve.h"
20#include "qgslinestring.h"
21#include "qgscircularstring.h"
22#include "qgscompoundcurve.h"
24
26
27QString QgsSplitLinesByLengthAlgorithm::name() const
28{
29 return QStringLiteral( "splitlinesbylength" );
30}
31
32QString QgsSplitLinesByLengthAlgorithm::displayName() const
33{
34 return QObject::tr( "Split lines by maximum length" );
35}
36
37QStringList QgsSplitLinesByLengthAlgorithm::tags() const
38{
39 return QObject::tr( "segments,parts,distance,cut,chop" ).split( ',' );
40}
41
42QString QgsSplitLinesByLengthAlgorithm::group() const
43{
44 return QObject::tr( "Vector geometry" );
45}
46
47QString QgsSplitLinesByLengthAlgorithm::groupId() const
48{
49 return QStringLiteral( "vectorgeometry" );
50}
51
52QString QgsSplitLinesByLengthAlgorithm::shortHelpString() const
53{
54 return QObject::tr( "This algorithm takes a line (or curve) layer and splits each feature into multiple parts, "
55 "where each part is of a specified maximum length.\n\n"
56 "Z and M values at the start and end of the new line substrings are linearly interpolated from existing values." );
57}
58
59QString QgsSplitLinesByLengthAlgorithm::shortDescription() const
60{
61 return QObject::tr( "Splits lines into parts which are no longer than a specified length." );
62}
63
64Qgis::ProcessingAlgorithmDocumentationFlags QgsSplitLinesByLengthAlgorithm::documentationFlags() const
65{
67}
68
69QList<int> QgsSplitLinesByLengthAlgorithm::inputLayerTypes() const
70{
71 return QList<int>() << static_cast< int >( Qgis::ProcessingSourceType::VectorLine );
72}
73
74Qgis::ProcessingSourceType QgsSplitLinesByLengthAlgorithm::outputLayerType() const
75{
77}
78
79QgsSplitLinesByLengthAlgorithm *QgsSplitLinesByLengthAlgorithm::createInstance() const
80{
81 return new QgsSplitLinesByLengthAlgorithm();
82}
83
84void QgsSplitLinesByLengthAlgorithm::initParameters( const QVariantMap & )
85{
86 std::unique_ptr< QgsProcessingParameterDistance > length = std::make_unique< QgsProcessingParameterDistance >( QStringLiteral( "LENGTH" ),
87 QObject::tr( "Maximum line length" ), 10, QStringLiteral( "INPUT" ), false, 0 );
88 length->setIsDynamic( true );
89 length->setDynamicPropertyDefinition( QgsPropertyDefinition( QStringLiteral( "LENGTH" ), QObject::tr( "Maximum length" ), QgsPropertyDefinition::DoublePositive ) );
90 length->setDynamicLayerParameterName( QStringLiteral( "INPUT" ) );
91 addParameter( length.release() );
92}
93
94bool QgsSplitLinesByLengthAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
95{
96 mLength = parameterAsDouble( parameters, QStringLiteral( "LENGTH" ), context );
97 mDynamicLength = QgsProcessingParameters::isDynamic( parameters, QStringLiteral( "LENGTH" ) );
98 if ( mDynamicLength )
99 mLengthProperty = parameters.value( QStringLiteral( "LENGTH" ) ).value< QgsProperty >();
100
101 return true;
102}
103
104QString QgsSplitLinesByLengthAlgorithm::outputName() const
105{
106 return QObject::tr( "Split" );
107}
108
109Qgis::WkbType QgsSplitLinesByLengthAlgorithm::outputWkbType( Qgis::WkbType inputWkbType ) const
110{
111 return QgsWkbTypes::singleType( inputWkbType );
112}
113
114QgsFeatureList QgsSplitLinesByLengthAlgorithm::processFeature( const QgsFeature &f, QgsProcessingContext &context, QgsProcessingFeedback * )
115{
116 if ( !f.hasGeometry() )
117 {
118 return QgsFeatureList() << f;
119 }
120 else
121 {
122 double distance = mLength;
123 if ( mDynamicLength )
124 distance = mLengthProperty.valueAsDouble( context.expressionContext(), distance );
125
126 QgsFeature outputFeature;
127 outputFeature.setAttributes( f.attributes() );
128 QgsFeatureList features;
129 const QgsGeometry inputGeom = f.geometry();
130 for ( auto it = inputGeom.const_parts_begin(); it != inputGeom.const_parts_end(); ++it )
131 {
132 const QgsCurve *part = qgsgeometry_cast< const QgsCurve * >( *it );
133 if ( !part )
134 continue;
135
136 double start = 0.0;
137 double end = distance;
138 const double length = part->length();
139 while ( start < length )
140 {
141 outputFeature.setGeometry( QgsGeometry( part->curveSubstring( start, end ) ) );
142 start += distance;
143 end += distance;
144 features << outputFeature;
145 }
146
147 }
148 return features;
149 }
150}
151
152Qgis::ProcessingFeatureSourceFlags QgsSplitLinesByLengthAlgorithm::sourceFlags() const
153{
155}
156
157QgsFeatureSink::SinkFlags QgsSplitLinesByLengthAlgorithm::sinkFlags() const
158{
160}
161
162
164
165
166
ProcessingSourceType
Processing data source types.
Definition qgis.h:3098
@ VectorLine
Vector line layers.
@ RegeneratesPrimaryKey
Algorithm always drops any existing primary keys or FID values and regenerates them in outputs.
QFlags< ProcessingAlgorithmDocumentationFlag > ProcessingAlgorithmDocumentationFlags
Flags describing algorithm behavior for documentation purposes.
Definition qgis.h:3194
@ SkipGeometryValidityChecks
Invalid geometry checks should always be skipped. This flag can be useful for algorithms which always...
WkbType
The WKB type describes the number of dimensions a geometry has.
Definition qgis.h:201
QFlags< ProcessingFeatureSourceFlag > ProcessingFeatureSourceFlags
Flags which control how QgsProcessingFeatureSource fetches features.
Definition qgis.h:3271
virtual double length() const
Returns the planar, 2-dimensional length of the geometry.
Abstract base class for curved geometry type.
Definition qgscurve.h:35
virtual QgsCurve * curveSubstring(double startDistance, double endDistance) const =0
Returns a new curve representing a substring of this curve.
QFlags< SinkFlag > SinkFlags
@ RegeneratePrimaryKey
This flag indicates, that a primary key field cannot be guaranteed to be unique and the sink should i...
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsAttributes attributes
Definition qgsfeature.h:67
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
QgsGeometry geometry
Definition qgsfeature.h:69
bool hasGeometry() const
Returns true if the feature has an associated geometry.
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
A geometry is the spatial representation of a feature.
QgsAbstractGeometry::const_part_iterator const_parts_begin() const
Returns STL-style const iterator pointing to the first part of the geometry.
QgsAbstractGeometry::const_part_iterator const_parts_end() const
Returns STL-style iterator pointing to the imaginary part after the last part of the geometry.
Contains information about the context in which a processing algorithm is executed.
QgsExpressionContext & expressionContext()
Returns the expression context.
Base class for providing feedback from a processing algorithm.
static bool isDynamic(const QVariantMap &parameters, const QString &name)
Returns true if the parameter with matching name is a dynamic parameter, and must be evaluated once f...
Definition for a property.
Definition qgsproperty.h:45
@ DoublePositive
Positive double value (including 0)
Definition qgsproperty.h:56
A store for object properties.
static Qgis::WkbType singleType(Qgis::WkbType type)
Returns the single type for a WKB type.
Definition qgswkbtypes.h:53
QList< QgsFeature > QgsFeatureList