mirror of
https://github.com/qgis/QGIS.git
synced 2025-11-04 00:04:25 -05:00
314 lines
11 KiB
Plaintext
314 lines
11 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsdistancearea.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
class QgsDistanceArea
|
|
{
|
|
%Docstring
|
|
A general purpose distance and area calculator, capable of performing ellipsoid based calculations.
|
|
|
|
Measurements can either be performed on existing QgsGeometry objects, or using
|
|
lists of points.
|
|
|
|
If a valid ellipsoid() has been set for the QgsDistanceArea, all calculations will be
|
|
performed using ellipsoidal algorithms (e.g. using Vincenty's formulas). If no
|
|
ellipsoid has been set, all calculations will be performed using Cartesian
|
|
formulas only. The behavior can be determined by calling willUseEllipsoid().
|
|
|
|
In order to perform accurate calculations, the source coordinate reference system
|
|
of all measured geometries must first be specified using setSourceCrs().
|
|
|
|
Usually, the measurements returned by QgsDistanceArea are in meters. If no valid
|
|
ellipsoid is set, then the units may not be meters. The units can be retrieved
|
|
by calling lengthUnits() and areaUnits().
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsdistancearea.h"
|
|
%End
|
|
public:
|
|
|
|
QgsDistanceArea();
|
|
%Docstring
|
|
Constructor
|
|
%End
|
|
|
|
bool willUseEllipsoid() const;
|
|
%Docstring
|
|
Returns whether calculations will use the ellipsoid. Calculations will only use the
|
|
ellipsoid if a valid ellipsoid() has been set.
|
|
.. versionadded:: 2.14
|
|
.. seealso:: ellipsoid()
|
|
:rtype: bool
|
|
%End
|
|
|
|
void setSourceCrs( const QgsCoordinateReferenceSystem &srcCRS );
|
|
%Docstring
|
|
Sets source spatial reference system.
|
|
.. versionadded:: 2.2
|
|
.. seealso:: sourceCrs()
|
|
%End
|
|
|
|
QgsCoordinateReferenceSystem sourceCrs() const;
|
|
%Docstring
|
|
Returns the source spatial reference system.
|
|
.. seealso:: setSourceCrs()
|
|
:rtype: QgsCoordinateReferenceSystem
|
|
%End
|
|
|
|
bool setEllipsoid( const QString &ellipsoid );
|
|
%Docstring
|
|
Sets the ``ellipsoid`` by its acronym. Known ellipsoid acronyms can be
|
|
retrieved using QgsEllipsoidUtils.acronyms().
|
|
Calculations will only use the ellipsoid if a valid ellipsoid has been set.
|
|
:return: true if ellipsoid was successfully set
|
|
.. seealso:: ellipsoid()
|
|
.. seealso:: willUseEllipsoid()
|
|
:rtype: bool
|
|
%End
|
|
|
|
bool setEllipsoid( double semiMajor, double semiMinor );
|
|
%Docstring
|
|
Sets ellipsoid by supplied radii. Calculations will only use the ellipsoid if
|
|
a valid ellipsoid been set.
|
|
:return: true if ellipsoid was successfully set
|
|
.. seealso:: ellipsoid()
|
|
.. seealso:: willUseEllipsoid()
|
|
:rtype: bool
|
|
%End
|
|
|
|
QString ellipsoid() const;
|
|
%Docstring
|
|
Returns ellipsoid's acronym. Calculations will only use the
|
|
ellipsoid if a valid ellipsoid has been set.
|
|
.. seealso:: setEllipsoid()
|
|
.. seealso:: willUseEllipsoid()
|
|
:rtype: str
|
|
%End
|
|
|
|
double ellipsoidSemiMajor() const;
|
|
%Docstring
|
|
Returns the ellipsoid's semi major axis.
|
|
.. seealso:: ellipsoid()
|
|
.. seealso:: ellipsoidSemiMinor()
|
|
.. seealso:: ellipsoidInverseFlattening()
|
|
:rtype: float
|
|
%End
|
|
|
|
double ellipsoidSemiMinor() const;
|
|
%Docstring
|
|
Returns ellipsoid's semi minor axis.
|
|
.. seealso:: ellipsoid()
|
|
.. seealso:: ellipsoidSemiMajor()
|
|
.. seealso:: ellipsoidInverseFlattening()
|
|
:rtype: float
|
|
%End
|
|
|
|
double ellipsoidInverseFlattening() const;
|
|
%Docstring
|
|
Returns ellipsoid's inverse flattening.
|
|
The inverse flattening is calculated with invf = a/(a-b).
|
|
.. seealso:: ellipsoid()
|
|
.. seealso:: ellipsoidSemiMajor()
|
|
.. seealso:: ellipsoidSemiMinor()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measureArea( const QgsGeometry &geometry ) const;
|
|
%Docstring
|
|
Measures the area of a geometry.
|
|
\param geometry geometry to measure
|
|
:return: area of geometry. For geometry collections, non surface geometries will be ignored. The units for the
|
|
returned area can be retrieved by calling areaUnits().
|
|
.. versionadded:: 2.12
|
|
.. seealso:: measureLength()
|
|
.. seealso:: measurePerimeter()
|
|
.. seealso:: areaUnits()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measureLength( const QgsGeometry &geometry ) const;
|
|
%Docstring
|
|
Measures the length of a geometry.
|
|
\param geometry geometry to measure
|
|
:return: length of geometry. For geometry collections, non curve geometries will be ignored. The units for the
|
|
returned distance can be retrieved by calling lengthUnits().
|
|
.. versionadded:: 2.12
|
|
.. seealso:: lengthUnits()
|
|
.. seealso:: measureArea()
|
|
.. seealso:: measurePerimeter()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measurePerimeter( const QgsGeometry &geometry ) const;
|
|
%Docstring
|
|
Measures the perimeter of a polygon geometry.
|
|
\param geometry geometry to measure
|
|
:return: perimeter of geometry. For geometry collections, any non-polygon geometries will be ignored. The units for the
|
|
returned perimeter can be retrieved by calling lengthUnits().
|
|
.. versionadded:: 2.12
|
|
.. seealso:: lengthUnits()
|
|
.. seealso:: measureArea()
|
|
.. seealso:: measurePerimeter()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measureLine( const QList<QgsPointXY> &points ) const;
|
|
%Docstring
|
|
Measures the length of a line with multiple segments.
|
|
\param points list of points in line
|
|
:return: length of line. The units for the returned length can be retrieved by calling lengthUnits().
|
|
.. seealso:: lengthUnits()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measureLine( const QgsPointXY &p1, const QgsPointXY &p2 ) const;
|
|
%Docstring
|
|
Measures the distance between two points.
|
|
\param p1 start of line
|
|
\param p2 end of line
|
|
:return: distance between points. The units for the returned distance can be retrieved by calling lengthUnits().
|
|
.. seealso:: lengthUnits()
|
|
:rtype: float
|
|
%End
|
|
|
|
double measureLineProjected( const QgsPointXY &p1, double distance = 1, double azimuth = M_PI / 2, QgsPointXY *projectedPoint /Out/ = 0 ) const;
|
|
%Docstring
|
|
Calculates the distance from one point with distance in meters and azimuth (direction)
|
|
When the sourceCrs() is geographic, computeSpheroidProject() will be called
|
|
otherwise QgsPoint.project() will be called after QgsUnitTypes.fromUnitToUnitFactor() has been applied to the distance
|
|
\note:
|
|
The input Point must be in the coordinate reference system being used
|
|
.. versionadded:: 3.0
|
|
\param p1 start point [can be Cartesian or Geographic]
|
|
\param distance must be in meters
|
|
\param azimuth - azimuth in radians, clockwise from North
|
|
\param projectedPoint calculated projected point
|
|
:return: distance in mapUnits
|
|
.. seealso:: sourceCrs()
|
|
.. seealso:: computeSpheroidProject()
|
|
:rtype: float
|
|
%End
|
|
|
|
QgsUnitTypes::DistanceUnit lengthUnits() const;
|
|
%Docstring
|
|
Returns the units of distance for length calculations made by this object.
|
|
.. versionadded:: 2.14
|
|
.. seealso:: areaUnits()
|
|
:rtype: QgsUnitTypes.DistanceUnit
|
|
%End
|
|
|
|
QgsUnitTypes::AreaUnit areaUnits() const;
|
|
%Docstring
|
|
Returns the units of area for areal calculations made by this object.
|
|
.. versionadded:: 2.14
|
|
.. seealso:: lengthUnits()
|
|
:rtype: QgsUnitTypes.AreaUnit
|
|
%End
|
|
|
|
double measurePolygon( const QList<QgsPointXY> &points ) const;
|
|
%Docstring
|
|
Measures the area of the polygon described by a set of points.
|
|
:rtype: float
|
|
%End
|
|
|
|
double bearing( const QgsPointXY &p1, const QgsPointXY &p2 ) const;
|
|
%Docstring
|
|
Computes the bearing (in radians) between two points.
|
|
:rtype: float
|
|
%End
|
|
|
|
static QString formatDistance( double distance, int decimals, QgsUnitTypes::DistanceUnit unit, bool keepBaseUnit = false );
|
|
%Docstring
|
|
Returns an distance formatted as a friendly string.
|
|
\param distance distance to format
|
|
\param decimals number of decimal places to show
|
|
\param unit unit of distance
|
|
\param keepBaseUnit set to false to allow conversion of large distances to more suitable units, e.g., meters to
|
|
kilometers
|
|
:return: formatted distance string
|
|
.. versionadded:: 2.16
|
|
.. seealso:: formatArea()
|
|
:rtype: str
|
|
%End
|
|
|
|
static QString formatArea( double area, int decimals, QgsUnitTypes::AreaUnit unit, bool keepBaseUnit = false );
|
|
%Docstring
|
|
Returns an area formatted as a friendly string.
|
|
\param area area to format
|
|
\param decimals number of decimal places to show
|
|
\param unit unit of area
|
|
\param keepBaseUnit set to false to allow conversion of large areas to more suitable units, e.g., square meters to
|
|
square kilometers
|
|
:return: formatted area string
|
|
.. versionadded:: 2.14
|
|
.. seealso:: formatDistance()
|
|
:rtype: str
|
|
%End
|
|
|
|
double convertLengthMeasurement( double length, QgsUnitTypes::DistanceUnit toUnits ) const;
|
|
%Docstring
|
|
Takes a length measurement calculated by this QgsDistanceArea object and converts it to a
|
|
different distance unit.
|
|
\param length length value calculated by this class to convert. It is assumed that the length
|
|
was calculated by this class, ie that its unit of length is equal to lengthUnits().
|
|
\param toUnits distance unit to convert measurement to
|
|
:return: converted distance
|
|
.. seealso:: convertAreaMeasurement()
|
|
.. versionadded:: 2.14
|
|
:rtype: float
|
|
%End
|
|
|
|
double convertAreaMeasurement( double area, QgsUnitTypes::AreaUnit toUnits ) const;
|
|
%Docstring
|
|
Takes an area measurement calculated by this QgsDistanceArea object and converts it to a
|
|
different areal unit.
|
|
\param area area value calculated by this class to convert. It is assumed that the area
|
|
was calculated by this class, ie that its unit of area is equal to areaUnits().
|
|
\param toUnits area unit to convert measurement to
|
|
:return: converted area
|
|
.. seealso:: convertLengthMeasurement()
|
|
.. versionadded:: 2.14
|
|
:rtype: float
|
|
%End
|
|
|
|
QgsPointXY computeSpheroidProject( const QgsPointXY &p1, double distance = 1, double azimuth = M_PI / 2 ) const;
|
|
%Docstring
|
|
Given a location, an azimuth and a distance, computes the
|
|
location of the projected point. Based on Vincenty's formula
|
|
for the geodetic direct problem as described in "Geocentric
|
|
Datum of Australia Technical Manual", Chapter 4.
|
|
.. note::
|
|
|
|
code (and documentation) taken from rttopo project
|
|
https://git.osgeo.org/gogs/rttopo/librttopo
|
|
- spheroid_project.spheroid_project(...)
|
|
- Valid bounds checking for degrees (latitude=+- 85.05115) is based values used for
|
|
-> 'WGS84 Web Mercator (Auxiliary Sphere)' calculations
|
|
--> latitudes outside these bounds cause the calculations to become unstable and can return invalid results
|
|
.. versionadded:: 3.0
|
|
\param p1 - location of first geographic (latitude/longitude) point as degrees.
|
|
\param distance - distance in meters.
|
|
\param azimuth - azimuth in radians, clockwise from North
|
|
:return: p2 - location of projected point as longitude/latitude.
|
|
:rtype: QgsPointXY
|
|
%End
|
|
|
|
};
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsdistancearea.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|