aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations
diff options
context:
space:
mode:
authorEven Rouault <even.rouault@spatialys.com>2020-04-14 17:17:55 +0200
committerEven Rouault <even.rouault@spatialys.com>2020-04-15 01:07:18 +0200
commit964569728722e9e91f152410a4747a0ba078bd84 (patch)
tree54369133947916e20bbe9004eb16857f3f1b72cd /docs/source/operations
parent5b017a8a78acc1f8b086ae339ecec257ee9d9684 (diff)
downloadPROJ-964569728722e9e91f152410a4747a0ba078bd84.tar.gz
PROJ-964569728722e9e91f152410a4747a0ba078bd84.zip
tmerc/utm: add a +algo=auto/evenden_snyder/poder_engsager parameter
The default remains +alg=poder_engsager. This default value can be changed in proj.ini +algo=auto will use Evenden Synder implementation if the error in doing so remains below 0.1 mm on Earth-sized ellipsoid
Diffstat (limited to 'docs/source/operations')
-rw-r--r--docs/source/operations/projections/tmerc.rst15
-rw-r--r--docs/source/operations/projections/utm.rst15
2 files changed, 30 insertions, 0 deletions
diff --git a/docs/source/operations/projections/tmerc.rst b/docs/source/operations/projections/tmerc.rst
index 2866517b..cf428cff 100644
--- a/docs/source/operations/projections/tmerc.rst
+++ b/docs/source/operations/projections/tmerc.rst
@@ -83,6 +83,21 @@ Parameters
It is faster than the default algorithm, but also diverges faster
as the distance from the central meridian increases.
+.. option:: +algo=auto/evenden_snyder/poder_engsager
+
+ .. versionadded:: 7.1
+
+ Selects the algorithm to use. The hardcoded value and the one defined in
+ :ref:`proj-ini` default to ``poder_engsager``, that is the most precise
+ one.
+
+ When using auto, a heuristics based on the input coordinate to transform
+ is used to determine if the faster Evenden-Snyder method can be used, for
+ faster computation, without causing an error greater than 0.1 mm (for an
+ ellipsoid of the size of Earth)
+
+ Note that :option:`+approx` and :option:`+algo` are mutually exclusive.
+
.. include:: ../options/lon_0.rst
.. include:: ../options/lat_0.rst
diff --git a/docs/source/operations/projections/utm.rst b/docs/source/operations/projections/utm.rst
index b45dafc1..82715a02 100644
--- a/docs/source/operations/projections/utm.rst
+++ b/docs/source/operations/projections/utm.rst
@@ -76,6 +76,21 @@ Optional
Use faster, less accurate algorithm for the Transverse Mercator.
+.. option:: +algo=auto/evenden_snyder/poder_engsager
+
+ .. versionadded:: 7.1
+
+ Selects the algorithm to use. The hardcoded value and the one defined in
+ :ref:`proj-ini` default to ``poder_engsager``, that is the most precise
+ one.
+
+ When using auto, a heuristics based on the input coordinate to transform
+ is used to determine if the faster Evenden-Snyder method can be used, for
+ faster computation, without causing an error greater than 0.1 mm (for an
+ ellipsoid of the size of Earth)
+
+ Note that :option:`+approx` and :option:`+algo` are mutually exclusive.
+
.. include:: ../options/ellps.rst
Further reading