aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/transformations/deformation.rst
diff options
context:
space:
mode:
authorEven Rouault <even.rouault@spatialys.com>2018-08-21 14:38:04 +0200
committerEven Rouault <even.rouault@spatialys.com>2018-08-21 14:57:28 +0200
commite05dcd84ab69e1522c67c1ec9e5b38f45fd77c6e (patch)
tree9ec0e012e8cdd10035a8f7b0286396325004b30b /docs/source/operations/transformations/deformation.rst
parentc1f0673b3335a37eb03900315d6db3f43e3bf64c (diff)
downloadPROJ-e05dcd84ab69e1522c67c1ec9e5b38f45fd77c6e.tar.gz
PROJ-e05dcd84ab69e1522c67c1ec9e5b38f45fd77c6e.zip
[BREAKING] Hermert: add +convention=position_vector/coordinate_frame, forbids +transpose (fixes #1091)
As identified in #1091, Helmert implementation in PROJ 5.0 and 5.1 is confusing. It happens that by default it used the coordinate_frame convention, contrary to the position_vector convention used traditionaly for +towgs84. The documentation of Helmert was also wrongly specifying that the default convention was position_vector. This commit: - bans the confusing +transpose parameter - removes the concept of a default convention, since in practice both are equally found, and requires +convention as soon as a rotational term parameter is present. For translation only, convention is ignored and optional, as having no effect. - fixes all the identified uses of proj=helmert in code, doc and tests This is obviously a breaking change: - users will have to adapt their pipeline expressions - in particular, init files that would use helmert must be adapted However, as designed, the break will be explicit, and not silent.
Diffstat (limited to 'docs/source/operations/transformations/deformation.rst')
-rw-r--r--docs/source/operations/transformations/deformation.rst4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/source/operations/transformations/deformation.rst b/docs/source/operations/transformations/deformation.rst
index 79d9b7b8..87b08453 100644
--- a/docs/source/operations/transformations/deformation.rst
+++ b/docs/source/operations/transformations/deformation.rst
@@ -51,7 +51,7 @@ to the Danish realisation of ETRS89 is in PROJ described as::
# ITRF2008@t_obs -> ITRF2000@t_obs
step init = ITRF2008:ITRF2000
# ITRF2000@t_obs -> ETRF2000@t_obs
- step proj=helmert t_epoch = 2000.0 transpose
+ step proj=helmert t_epoch = 2000.0 convention=position_vector
x = 0.054 rx = 0.000891 drx = 8.1e-05
y = 0.051 ry = 0.00539 dry = 0.00049
z = -0.048 rz = -0.008712 drz = -0.000792
@@ -60,7 +60,7 @@ to the Danish realisation of ETRS89 is in PROJ described as::
xy_grids = ./nkgrf03vel_realigned_xy.ct2
z_grids = ./nkgrf03vel_realigned_z.gtx
# NKG_ETRF@2000.0 -> ETRF92@2000.0
- step proj=helmert transpose s = -0.009420e
+ step proj=helmert convention=position_vector s = -0.009420e
x = 0.03863 rx = 0.00617753
y = 0.147 ry = 5.064e-05
z = 0.02776 rz = 4.729e-05