diff options
| author | Even Rouault <even.rouault@spatialys.com> | 2021-06-18 14:24:38 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-06-18 14:24:38 +0200 |
| commit | a79b5558da1a391a9d7418316c9f507583d41b2a (patch) | |
| tree | fad8a3d7e89f21d9581b6404ec370b0865b989eb /docs/source | |
| parent | 987c8e9a4521c3e80fac73dbaa76ff77747d854b (diff) | |
| parent | 916eaa4349e2f46320d49ae0f9d2993d98a8335d (diff) | |
| download | PROJ-a79b5558da1a391a9d7418316c9f507583d41b2a.tar.gz PROJ-a79b5558da1a391a9d7418316c9f507583d41b2a.zip | |
Merge pull request #2750 from rouault/better_operation_selection
proj_trans/cs2cs: If two operations have the same accuracy, use the one that is contained within a larger one
Diffstat (limited to 'docs/source')
| -rw-r--r-- | docs/source/operations/operations_computation.rst | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/docs/source/operations/operations_computation.rst b/docs/source/operations/operations_computation.rst index 0bc57ff0..5c2596e6 100644 --- a/docs/source/operations/operations_computation.rst +++ b/docs/source/operations/operations_computation.rst @@ -59,9 +59,9 @@ From a code point of view, the entry point of the algorithm is the C++ It combines several strategies: -- look up in the PROJ database for available operations -- consider the pair (source CRS, target CRS) to synthetize operations depending - on the nature of the source and target CRS. + - look up in the PROJ database for available operations + - consider the pair (source CRS, target CRS) to synthetize operations depending + on the nature of the source and target CRS. Geographic CRS to Geographic CRS, with known identifiers -------------------------------------------------------- @@ -156,6 +156,18 @@ performed in the order they are listed below: lexicographic order (e.g. "FOO to BAR (3)" will have higher precedence than "FOO to BAR (2)") +.. note:: + + :c:func:`proj_trans`, on the results returned by :c:func:`proj_create_crs_to_crs`, + will not necessarily use the operation that + is listed in first position due to the above algorithm. :c:func:`proj_trans` + has more context, since it has the coordinate to transform, so it can compare + this coordinate to the area of use of operations. Typically, the above criteria + will favor an operation that has a larger area of use over another one with a + smaller area, due to it being more generally applicable. But once coordinates are known, + :c:func:`proj_trans` can select an operation with a smaller + area of use that applies to the coordinate to transform. + Geodetic/geographic CRS to Geodetic/geographic CRS, without known identifiers ----------------------------------------------------------------------------- |