aboutsummaryrefslogtreecommitdiff
path: root/docs/source/usage/operations/transformations/hgridshift.rst
diff options
context:
space:
mode:
authorKristian Evers <kristianevers@gmail.com>2017-09-18 22:21:20 +0200
committerKristian Evers <kristianevers@gmail.com>2017-09-18 22:21:20 +0200
commit6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9 (patch)
tree7bec3d77463fba3ff68ebabcc127ad504da0836d /docs/source/usage/operations/transformations/hgridshift.rst
parent1f60b8c407ac202916cf4570683935fcca451531 (diff)
downloadPROJ-6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9.tar.gz
PROJ-6d1a1ff4e470bb4d26be46bdf01de3d94e6ab8e9.zip
Moved projection list to using chapter and created a list of transformations. Both are grouped in a section called operations.
Diffstat (limited to 'docs/source/usage/operations/transformations/hgridshift.rst')
-rw-r--r--docs/source/usage/operations/transformations/hgridshift.rst32
1 files changed, 32 insertions, 0 deletions
diff --git a/docs/source/usage/operations/transformations/hgridshift.rst b/docs/source/usage/operations/transformations/hgridshift.rst
new file mode 100644
index 00000000..78e46aa9
--- /dev/null
+++ b/docs/source/usage/operations/transformations/hgridshift.rst
@@ -0,0 +1,32 @@
+.. _hgridshift:
+
+================================================================================
+Horizontal grid shift
+================================================================================
+
+Change of horizontal datum by grid shift.
+
++--------------+--------------------------------------------------------------------+
+| **Options** |
++--------------+--------------------------------------------------------------------+
+| `+grids` | Comma-separated list of grids to load. |
++--------------+--------------------------------------------------------------------+
+
+The horizontal grid shift is done by offsetting the planar input coordinates by
+a specific amount determined by the loaded grids. The simplest use case of the
+horizontal grid shift is applying a single grid::
+
+ +hgridshift +grids=nzgr2kgrid0005.gsb
+
+
+More than one grid can be loaded at the same time, for instance in case the
+dataset needs to be transformed spans several countries. In this example grids
+of the continental US, Alaska and Canada is loaded at the same time::
+
+ +hgridshift +grids=@conus,@alaska,@ntv2_0.gsb,@ntv_can.dat
+
+The ``@`` in the above example states that the grid is optional, in case the grid
+is not found in the PROJ.4 search path. The list of grids is prioritized so that
+grids in the start of the list takes presedence over the grids in the back of the
+list.
+