This class implements a geometry check. More...

#include <qgsgeometrycheck.h>

Inheritance diagram for QgsGeometryCheck:

[legend]

Classes
struct	Change
	Descripts a change to fix a geometry. More...

struct	LayerFeatureIds
	A list of layers and feature ids for each of these layers. More...

Public Types
typedef QMap< QString, QMap< QgsFeatureId, QList< QgsGeometryCheck::Change > > >	Changes
	A collection of changes.

enum	ChangeType { ChangeAdded , ChangeRemoved , ChangeChanged }
	Description of the type of a change. More...

enum	ChangeWhat { ChangeFeature , ChangePart , ChangeRing , ChangeNode }
	Description of a change to indicate at which level a change occurred. More...

enum	CheckType { FeatureNodeCheck , FeatureCheck , LayerCheck }
	The type of a check. More...

enum	Flag { AvailableInValidation = 1 << 1 }
	Flags for geometry checks. More...

typedef QFlags< Flag >	Flags

Public Member Functions
	QgsGeometryCheck (const QgsGeometryCheckContext *context, const QVariantMap &configuration)
	Create a new geometry check.

virtual	~QgsGeometryCheck ()=default

virtual QList< QgsGeometryCheckResolutionMethod >	availableResolutionMethods () const
	Returns a list of available resolution methods.

virtual CheckType	checkType () const =0
	Returns the check type.

virtual void	collectErrors (const QMap< QString, QgsFeaturePool * > &featurePools, QList< QgsGeometryCheckError * > &errors, QStringList &messages, QgsFeedback *feedback, const LayerFeatureIds &ids=QgsGeometryCheck::LayerFeatureIds()) const =0
	The main worker method.

virtual QList< Qgis::GeometryType >	compatibleGeometryTypes () const =0
	A list of geometry types for which this check can be performed.

template<class T >
T	configurationValue (const QString &name, const QVariant &defaultValue=QVariant())
	Returns the configuration value with the name, saved in the QGIS settings for this geometry check.

const QgsGeometryCheckContext *	context () const
	Returns the context.

virtual QString	description () const =0
	Returns a human readable description for this check.

virtual void	fixError (const QMap< QString, QgsFeaturePool * > &featurePools, QgsGeometryCheckError *error, int method, const QMap< QString, int > &mergeAttributeIndices, Changes &changes) const
	Fixes the error error with the specified method.

virtual QgsGeometryCheck::Flags	flags () const
	Flags for this geometry check.

virtual QString	id () const =0
	Returns an id for this check.

virtual bool	isCompatible (QgsVectorLayer *layer) const
	Returns if this geometry check is compatible with layer.

virtual void	prepare (const QgsGeometryCheckContext *context, const QVariantMap &configuration)
	Will be run in the main thread before collectErrors() is called (which may be run from a background thread).

virtual Q_DECL_DEPRECATED QStringList	resolutionMethods () const
	Returns a list of descriptions for available resolutions for errors.

Protected Member Functions
QMap< QString, QgsFeatureIds >	allLayerFeatureIds (const QMap< QString, QgsFeaturePool * > &featurePools) const
	Returns all layers and feature ids.

void	deleteFeatureGeometryPart (const QMap< QString, QgsFeaturePool * > &featurePools, const QString &layerId, QgsFeature &feature, int partIdx, Changes &changes) const
	Deletes a part of a feature geometry.

void	deleteFeatureGeometryRing (const QMap< QString, QgsFeaturePool * > &featurePools, const QString &layerId, QgsFeature &feature, int partIdx, int ringIdx, Changes &changes) const
	Deletes a ring in a feature geometry.

void	replaceFeatureGeometryPart (const QMap< QString, QgsFeaturePool * > &featurePools, const QString &layerId, QgsFeature &feature, int partIdx, QgsAbstractGeometry *newPartGeom, Changes &changes) const
	Replaces a part in a feature geometry.

double	scaleFactor (const QPointer< QgsVectorLayer > &layer) const
	Determines the scale factor of a layer to the map coordinate reference system.

Protected Attributes
QVariantMap	mConfiguration

const QgsGeometryCheckContext *	mContext

Detailed Description

This class implements a geometry check.

Geometry checks run over a set of features and can detect errors like topological or other issues which are reported in the geometry validation panel in QGIS and help a user to create valid geometries.

Implementing a custom geometry check consists of the following parts

Writing the check

A new subclass of QgsGeometryCheck needs to be written and at least the following abstract methods need to be implemented:

compatibleGeometryTypes(): A list of geometry types to which this check applies
availableResolutionMethods(): A list of resolution methods that can be used to fix errors of this type
description(): A description for the geometry check.
id(): A unique id for this check.
checkType(): One of QgsGeometryCheck.LayerCheck, QgsGeometryCheck.FeatureCheck, QgsGeometryCheck.FeatureNodeCheck
collectErrors(): This method will be called to validate geometries. All geometries which should be validated are passed into this method with the parameter ids and should be retrieved from the available featurePools to make use of caching. New errors should be appended to the error list and other message strings to messages. The method needs to return a tuple (errors, messages).

Creating a geometry check factory

A Geometry check factory manages meta information for checks. There will always be one single geometry check factory created per check type, but it's possible that multiple QgsGeometryCheck instances are created and used in parallel.

A new subclass of QgsGeometryCheckFactory needs to be written and at least the following abstract methods need to be implemented:

QgsGeometryCheckFactory::createGeometryCheck(): Needs to return a new subclassed QgsGeometryCheck object that has been written in the previous step.
QgsGeometryCheckFactory::id(): A unique id for this geometry check.
QgsGeometryCheckFactory::description(): A description for this geometry check that can be presented to the user for more explanation.
QgsGeometryCheckFactory::isCompatible(): Returns a boolean that determines if this check is available for a given layer. This often checks for the geometry type of the layer.
QgsGeometryCheckFactory::flags(): Returns additional flags for a geometry check. If unsure return QgsGeometryCheck.AvailableInValidation.
QgsGeometryCheckFactory::checkType(): Returns the type of this geometry check.

Registering the geometry check

Finally the geometry check factory needs to be registered in QGIS, so the system is aware of the available geometry checks.

# Make sure you always keep a reference
checkFactory = MyGeometryCheckFactory()
QgsAnalysis.geometryCheckRegistry().registerGeometryCheck(checkFactory)

Note: This class is a technology preview and unstable API.

Since: QGIS 3.4

Definition at line 91 of file qgsgeometrycheck.h.

Member Typedef Documentation

◆ Changes

typedef QMap<QString, QMap<QgsFeatureId, QList<QgsGeometryCheck::Change> > > QgsGeometryCheck::Changes

A collection of changes.

Grouped by layer id and feature id.

Definition at line 220 of file qgsgeometrycheck.h.

◆ Flags

typedef QFlags< Flag > QgsGeometryCheck::Flags

Definition at line 168 of file qgsgeometrycheck.h.

Member Enumeration Documentation

◆ ChangeType

enum QgsGeometryCheck::ChangeType

Description of the type of a change.

Since: Python bindings since QGIS 3.4

Enumerator
ChangeAdded	Something has been added.
ChangeRemoved	Something has been removed.
ChangeChanged	Something has been updated.

Definition at line 142 of file qgsgeometrycheck.h.

◆ ChangeWhat

enum QgsGeometryCheck::ChangeWhat

Description of a change to indicate at which level a change occurred.

Since: Python bindings since QGIS 3.4

Enumerator
ChangeFeature	This change happens on feature level.
ChangePart	This change happens on part level.
ChangeRing	This change happens on ring level.
ChangeNode	This change happens on node level.

Definition at line 129 of file qgsgeometrycheck.h.

◆ CheckType

enum QgsGeometryCheck::CheckType

The type of a check.

Since: Python bindings since QGIS 3.4

Enumerator
FeatureNodeCheck	The check controls individual nodes.
FeatureCheck	The check controls geometries as a whole.
LayerCheck	The check controls a whole layer (topology checks)

Definition at line 154 of file qgsgeometrycheck.h.

◆ Flag

enum QgsGeometryCheck::Flag

Flags for geometry checks.

Enumerator
AvailableInValidation	This geometry check should be available in layer validation on the vector layer peroperties.

Definition at line 164 of file qgsgeometrycheck.h.

Constructor & Destructor Documentation

◆ QgsGeometryCheck()

QgsGeometryCheck::QgsGeometryCheck	(	const QgsGeometryCheckContext *	context,
		const QVariantMap &	configuration
	)

Create a new geometry check.

Definition at line 30 of file qgsgeometrycheck.cpp.

◆ ~QgsGeometryCheck()

virtual QgsGeometryCheck::~QgsGeometryCheck ( )

virtualdefault

Member Function Documentation

◆ allLayerFeatureIds()

QMap< QString, QgsFeatureIds > QgsGeometryCheck::allLayerFeatureIds ( const QMap< QString, QgsFeaturePool * > & featurePools ) const

protected

Returns all layers and feature ids.

Note: Not available in Python bindings

Since: QGIS 3.4

Definition at line 83 of file qgsgeometrycheck.cpp.

◆ availableResolutionMethods()

QList< QgsGeometryCheckResolutionMethod > QgsGeometryCheck::availableResolutionMethods ( ) const

virtual

Returns a list of available resolution methods.

Since: QGIS 3.12

Reimplemented in QgsGeometryGapCheck.

Definition at line 60 of file qgsgeometrycheck.cpp.

◆ checkType()

virtual CheckType QgsGeometryCheck::checkType ( ) const

pure virtual

◆ collectErrors()

virtual void QgsGeometryCheck::collectErrors	(	const QMap< QString, QgsFeaturePool * > &	featurePools,
		QList< QgsGeometryCheckError * > &	errors,
		QStringList &	messages,
		QgsFeedback *	feedback,
		const LayerFeatureIds &	ids = `QgsGeometryCheck::LayerFeatureIds()`
	)		const

pure virtual

The main worker method.

Check all features available from featurePools and write errors found to errors. Other status messages can be written to messages. Progress should be reported to feedback. Only features and layers listed in ids should be checked.

Since: QGIS 3.4

Implemented in QgsGeometryAngleCheck, QgsGeometryAreaCheck, QgsGeometryContainedCheck, QgsGeometryDangleCheck, QgsGeometryDegeneratePolygonCheck, QgsGeometryDuplicateCheck, QgsGeometryDuplicateNodesCheck, QgsGeometryFollowBoundariesCheck, QgsGeometryGapCheck, QgsGeometryHoleCheck, QgsGeometryLineIntersectionCheck, QgsGeometryLineLayerIntersectionCheck, QgsGeometryMissingVertexCheck, QgsGeometryOverlapCheck, QgsGeometryPointCoveredByLineCheck, QgsGeometryPointInPolygonCheck, QgsGeometrySegmentLengthCheck, and QgsSingleGeometryCheck.

◆ compatibleGeometryTypes()

virtual QList< Qgis::GeometryType > QgsGeometryCheck::compatibleGeometryTypes ( ) const

pure virtual

◆ configurationValue()

template<class T >

T QgsGeometryCheck::configurationValue	(	const QString &	name,
		const QVariant &	defaultValue = `QVariant()`
	)

inline

Returns the configuration value with the name, saved in the QGIS settings for this geometry check.

If no configuration could be found, defaultValue is returned.

Definition at line 242 of file qgsgeometrycheck.h.

◆ context()

const QgsGeometryCheckContext * QgsGeometryCheck::context ( ) const

inline

Returns the context.

Since: QGIS 3.4

Definition at line 329 of file qgsgeometrycheck.h.

◆ deleteFeatureGeometryPart()

void QgsGeometryCheck::deleteFeatureGeometryPart	(	const QMap< QString, QgsFeaturePool * > &	featurePools,
		const QString &	layerId,
		QgsFeature &	feature,
		int	partIdx,
		Changes &	changes
	)		const

protected

Deletes a part of a feature geometry.

Note: Not available in Python bindings

Since: QGIS 3.4

Definition at line 116 of file qgsgeometrycheck.cpp.

◆ deleteFeatureGeometryRing()

void QgsGeometryCheck::deleteFeatureGeometryRing	(	const QMap< QString, QgsFeaturePool * > &	featurePools,
		const QString &	layerId,
		QgsFeature &	feature,
		int	partIdx,
		int	ringIdx,
		Changes &	changes
	)		const

protected

Deletes a ring in a feature geometry.

Note: Not available in Python bindings

Since: QGIS 3.4

Definition at line 143 of file qgsgeometrycheck.cpp.

◆ description()

virtual QString QgsGeometryCheck::description ( ) const

pure virtual

◆ fixError()

void QgsGeometryCheck::fixError	(	const QMap< QString, QgsFeaturePool * > &	featurePools,
		QgsGeometryCheckError *	error,
		int	method,
		const QMap< QString, int > &	mergeAttributeIndices,
		QgsGeometryCheck::Changes &	changes
	)		const

virtual

Fixes the error error with the specified method.

Is executed on the main thread.

See also: availableResolutionMethods()

Since: QGIS 3.4

Reimplemented in QgsGeometrySelfContactCheck, QgsGeometryAngleCheck, QgsGeometryAreaCheck, QgsGeometryContainedCheck, QgsGeometryDangleCheck, QgsGeometryDegeneratePolygonCheck, QgsGeometryDuplicateCheck, QgsGeometryDuplicateNodesCheck, QgsGeometryFollowBoundariesCheck, QgsGeometryGapCheck, QgsGeometryHoleCheck, QgsGeometryLineIntersectionCheck, QgsGeometryLineLayerIntersectionCheck, QgsGeometryMissingVertexCheck, QgsGeometryMultipartCheck, QgsGeometryOverlapCheck, QgsGeometryPointCoveredByLineCheck, QgsGeometryPointInPolygonCheck, QgsGeometrySegmentLengthCheck, QgsGeometrySelfIntersectionCheck, and QgsGeometryTypeCheck.

Definition at line 51 of file qgsgeometrycheck.cpp.

◆ flags()

QgsGeometryCheck::Flags QgsGeometryCheck::flags ( ) const

virtual

Flags for this geometry check.

Reimplemented in QgsGeometryGapCheck, QgsGeometryMissingVertexCheck, QgsGeometryOverlapCheck, and QgsGeometrySelfIntersectionCheck.

Definition at line 46 of file qgsgeometrycheck.cpp.

◆ id()

virtual QString QgsGeometryCheck::id ( ) const

pure virtual

◆ isCompatible()

bool QgsGeometryCheck::isCompatible ( QgsVectorLayer * layer ) const

virtual

Returns if this geometry check is compatible with layer.

By default it checks for the geometry type in compatibleGeometryTypes().

Since: QGIS 3.4

Definition at line 41 of file qgsgeometrycheck.cpp.

◆ prepare()

void QgsGeometryCheck::prepare	(	const QgsGeometryCheckContext *	context,
		const QVariantMap &	configuration
	)

virtual

Will be run in the main thread before collectErrors() is called (which may be run from a background thread).

Since: QGIS 3.10

Reimplemented in QgsGeometryGapCheck.

Definition at line 35 of file qgsgeometrycheck.cpp.

◆ replaceFeatureGeometryPart()

void QgsGeometryCheck::replaceFeatureGeometryPart	(	const QMap< QString, QgsFeaturePool * > &	featurePools,
		const QString &	layerId,
		QgsFeature &	feature,
		int	partIdx,
		QgsAbstractGeometry *	newPartGeom,
		Changes &	changes
	)		const

protected

Replaces a part in a feature geometry.

Note: Not available in Python bindings

Since: QGIS 3.4

Definition at line 93 of file qgsgeometrycheck.cpp.

◆ resolutionMethods()

QStringList QgsGeometryCheck::resolutionMethods ( ) const

virtual

Returns a list of descriptions for available resolutions for errors.

The index will be passed as method to

See also: fixError().

Deprecated:: QGIS 3.12. Use availableResolutionMethods() instead.

Since: QGIS 3.4

Reimplemented in QgsGeometryAngleCheck, QgsGeometryAreaCheck, QgsGeometryContainedCheck, QgsGeometryDangleCheck, QgsGeometryDegeneratePolygonCheck, QgsGeometryDuplicateCheck, QgsGeometryDuplicateNodesCheck, QgsGeometryFollowBoundariesCheck, QgsGeometryGapCheck, QgsGeometryHoleCheck, QgsGeometryIsValidCheck, QgsGeometryLineIntersectionCheck, QgsGeometryLineLayerIntersectionCheck, QgsGeometryMissingVertexCheck, QgsGeometryMultipartCheck, QgsGeometryOverlapCheck, QgsGeometryPointCoveredByLineCheck, QgsGeometryPointInPolygonCheck, QgsGeometrySegmentLengthCheck, QgsGeometrySelfContactCheck, QgsGeometrySelfIntersectionCheck, and QgsGeometryTypeCheck.

Definition at line 78 of file qgsgeometrycheck.cpp.

◆ scaleFactor()

double QgsGeometryCheck::scaleFactor ( const QPointer< QgsVectorLayer > & layer ) const

protected

Determines the scale factor of a layer to the map coordinate reference system.

Note: Not available in Python bindings

Since: QGIS 3.4

Definition at line 172 of file qgsgeometrycheck.cpp.

Member Data Documentation

◆ mConfiguration

QVariantMap QgsGeometryCheck::mConfiguration

protected

Definition at line 366 of file qgsgeometrycheck.h.

◆ mContext

const QgsGeometryCheckContext* QgsGeometryCheck::mContext

protected

Definition at line 365 of file qgsgeometrycheck.h.

The documentation for this class was generated from the following files:

/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/analysis/vector/geometry_checker/qgsgeometrycheck.h
/build/qgis-3.41.0+git20241119+45a0abf3bec+99sid/src/analysis/vector/geometry_checker/qgsgeometrycheck.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Writing the check

Creating a geometry check factory

Registering the geometry check

Member Typedef Documentation

◆ Changes

◆ Flags

Member Enumeration Documentation

◆ ChangeType

◆ ChangeWhat

◆ CheckType

◆ Flag

Constructor & Destructor Documentation

◆ QgsGeometryCheck()

◆ ~QgsGeometryCheck()

Member Function Documentation

◆ allLayerFeatureIds()

◆ availableResolutionMethods()

◆ checkType()

◆ collectErrors()

◆ compatibleGeometryTypes()

◆ configurationValue()

◆ context()

◆ deleteFeatureGeometryPart()

◆ deleteFeatureGeometryRing()

◆ description()

◆ fixError()

◆ flags()

◆ id()

◆ isCompatible()

◆ prepare()

◆ replaceFeatureGeometryPart()

◆ resolutionMethods()

◆ scaleFactor()

Member Data Documentation

◆ mConfiguration

◆ mContext