#include <qgsmeshcalculator.h>

Public Types
enum	Result { Success = 0, Canceled, CreateOutputError, InputLayerError, ParserError, InvalidDatasets, EvaluateError, MemoryError }
	Result of the calculation. More...

Public Member Functions
	QgsMeshCalculator (const QString &formulaString, const QString &outputDriver, const QString &outputGroupName, const QString &outputFile, const QgsGeometry &outputMask, double startTime, double endTime, QgsMeshLayer *layer)
	Creates calculator with geometry mask. More...

	QgsMeshCalculator (const QString &formulaString, const QString &outputDriver, const QString &outputGroupName, const QString &outputFile, const QgsRectangle &outputExtent, double startTime, double endTime, QgsMeshLayer *layer)
	Creates calculator with bounding box (rectangular) mask. More...

Q_DECL_DEPRECATED	QgsMeshCalculator (const QString &formulaString, const QString &outputFile, const QgsGeometry &outputMask, double startTime, double endTime, QgsMeshLayer *layer)
	Creates calculator with geometry mask. More...

Q_DECL_DEPRECATED	QgsMeshCalculator (const QString &formulaString, const QString &outputFile, const QgsRectangle &outputExtent, double startTime, double endTime, QgsMeshLayer *layer)
	Creates calculator with bounding box (rectangular) mask. More...

Result	processCalculation (QgsFeedback *feedback=nullptr)
	Starts the calculation, writes new dataset group to file and adds it to the mesh layer. More...

Static Public Member Functions
static Q_DECL_DEPRECATED Result	expression_valid (const QString &formulaString, QgsMeshLayer *layer)
	Returns whether formula is valid for particular mesh layer. More...

static Result	expressionIsValid (const QString &formulaString, QgsMeshLayer *layer, QgsMeshDriverMetadata::MeshDriverCapability &requiredCapability)
	Returns whether formula is valid for particular mesh layer. More...

Detailed Description

Performs mesh layer calculations.

Mesh calculator can do various mathematical operations between dataset groups from a single mesh layer. Resulting dataset group is added to the mesh layer. Result can be filtered by extent or a vector layer mask spatially and by selection of times.

Resulting dataset is always scalar

Since: QGIS 3.6

Definition at line 51 of file qgsmeshcalculator.h.

Member Enumeration Documentation

◆ Result

enum QgsMeshCalculator::Result

Result of the calculation.

Enumerator
Success	Calculation successful.
Canceled	Calculation canceled.
CreateOutputError	Error creating output data file.
InputLayerError	Error reading input layer.
ParserError	Error parsing formula.
InvalidDatasets	Datasets with different time outputs or not part of the mesh.
EvaluateError	Error during evaluation.
MemoryError	Error allocating memory for result.

Definition at line 56 of file qgsmeshcalculator.h.

Constructor & Destructor Documentation

◆ QgsMeshCalculator() [1/4]

QgsMeshCalculator::QgsMeshCalculator	(	const QString &	formulaString,
		const QString &	outputFile,
		const QgsRectangle &	outputExtent,
		double	startTime,
		double	endTime,
		QgsMeshLayer *	layer
	)

Creates calculator with bounding box (rectangular) mask.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
outputFile	file to store the resulting dataset group data
outputExtent	spatial filter defined by rectangle
startTime	time filter defining the starting dataset
endTime	time filter defining the ending dataset
layer	mesh layer with dataset groups references in formulaString

Deprecated:: QGIS 3.12

Definition at line 28 of file qgsmeshcalculator.cpp.

◆ QgsMeshCalculator() [2/4]

QgsMeshCalculator::QgsMeshCalculator	(	const QString &	formulaString,
		const QString &	outputFile,
		const QgsGeometry &	outputMask,
		double	startTime,
		double	endTime,
		QgsMeshLayer *	layer
	)

Creates calculator with geometry mask.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
outputFile	file to store the resulting dataset group data
outputMask	spatial filter defined by geometry
startTime	time filter defining the starting dataset
endTime	time filter defining the ending dataset
layer	mesh layer with dataset groups references in formulaString

Deprecated:: QGIS 3.12

Definition at line 47 of file qgsmeshcalculator.cpp.

◆ QgsMeshCalculator() [3/4]

QgsMeshCalculator::QgsMeshCalculator	(	const QString &	formulaString,
		const QString &	outputDriver,
		const QString &	outputGroupName,
		const QString &	outputFile,
		const QgsRectangle &	outputExtent,
		double	startTime,
		double	endTime,
		QgsMeshLayer *	layer
	)

Creates calculator with bounding box (rectangular) mask.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
outputDriver	output driver name
outputGroupName	output group name
outputFile	file to store the resulting dataset group data
outputExtent	spatial filter defined by rectangle
startTime	time filter defining the starting dataset
endTime	time filter defining the ending dataset
layer	mesh layer with dataset groups references in formulaString

Since: QGIS 3.12

Definition at line 67 of file qgsmeshcalculator.cpp.

◆ QgsMeshCalculator() [4/4]

QgsMeshCalculator::QgsMeshCalculator	(	const QString &	formulaString,
		const QString &	outputDriver,
		const QString &	outputGroupName,
		const QString &	outputFile,
		const QgsGeometry &	outputMask,
		double	startTime,
		double	endTime,
		QgsMeshLayer *	layer
	)

Creates calculator with geometry mask.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
outputDriver	output driver name
outputGroupName	output group name
outputFile	file to store the resulting dataset group data
outputMask	spatial filter defined by geometry
startTime	time filter defining the starting dataset
endTime	time filter defining the ending dataset
layer	mesh layer with dataset groups references in formulaString

Since: QGIS 3.12

Definition at line 87 of file qgsmeshcalculator.cpp.

Member Function Documentation

◆ expression_valid()

QgsMeshCalculator::Result QgsMeshCalculator::expression_valid	(	const QString &	formulaString,
		QgsMeshLayer *	layer
	)

static

Returns whether formula is valid for particular mesh layer.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
layer	mesh layer with dataset groups references in formulaString

Returns: QgsMeshCalculator::Success in case of success

Deprecated:: QGIS 3.12 - use expressionIsValid

Definition at line 107 of file qgsmeshcalculator.cpp.

◆ expressionIsValid()

QgsMeshCalculator::Result QgsMeshCalculator::expressionIsValid	(	const QString &	formulaString,
		QgsMeshLayer *	layer,
		QgsMeshDriverMetadata::MeshDriverCapability &	requiredCapability
	)

static

Returns whether formula is valid for particular mesh layer.

Parameters

formulaString	formula/expression to evaluate. Consists of dataset group names, operators and numbers
layer	mesh layer with dataset groups references in formulaString
requiredCapability	returns required capability of driver to store results of the calculation

Returns: QgsMeshCalculator::Success in case of success

Since: QGIS 3.12

Definition at line 115 of file qgsmeshcalculator.cpp.

◆ processCalculation()

QgsMeshCalculator::Result QgsMeshCalculator::processCalculation ( QgsFeedback * feedback = nullptr )

Starts the calculation, writes new dataset group to file and adds it to the mesh layer.

Parameters

feedback The optional feedback argument for progress reporting and cancellation support

Returns: QgsMeshCalculator::Success in case of success

Definition at line 136 of file qgsmeshcalculator.cpp.

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

/build/qgis-3.14.0+99unstable/src/analysis/mesh/qgsmeshcalculator.h
/build/qgis-3.14.0+99unstable/src/analysis/mesh/qgsmeshcalculator.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ Result

Constructor & Destructor Documentation

◆ QgsMeshCalculator() [1/4]

◆ QgsMeshCalculator() [2/4]

◆ QgsMeshCalculator() [3/4]

◆ QgsMeshCalculator() [4/4]

Member Function Documentation

◆ expression_valid()

◆ expressionIsValid()

◆ processCalculation()