Skip to content

Commit 3a7a86b

Browse files
committed
Mention derived projected in operations_computation
1 parent 994f5c7 commit 3a7a86b

File tree

2 files changed

+45
-1
lines changed

2 files changed

+45
-1
lines changed

docs/source/operations/operations_computation.rst

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Computation of coordinate operations between two CRS
55
================================================================================
66

77
:Author: Even Rouault
8-
:Last Updated: 2021-02-10
8+
:Last Updated: 2023-08-26
99

1010
Introduction
1111
------------
@@ -785,3 +785,36 @@ Example:
785785
There are other situations with BoundCRS, involving vertical transformations,
786786
or transforming to other objects than a geographic CRS, but the curious reader
787787
will have to inspect the code for the actual gory details.
788+
789+
790+
Using Derived Projected for source or target CRS
791+
---------------------------------------------------------------------------------
792+
793+
The `WKT2` tag ``DERIVEDPROJCRS`` can be useful to define a customized CRS
794+
adding a ``DERIVINGCONVERSION`` to apply a conversion on top of the projection.
795+
It can be also done inside a Compound CRS.
796+
One use case is to describe a local CRS produced in a site calibration,
797+
as explained in :cite:`JimenezShaw2023`.
798+
799+
Using the WKT2 from that paper (stored in wkt2.txt file for readability) we would get this:
800+
801+
.. code-block:: shell
802+
803+
projinfo -s EPSG:6319 -t "`cat wkt2.txt`" -o proj
804+
Candidate operations found: 1
805+
-------------------------------------
806+
Operation No. 1:
807+
808+
unknown id, Inverse of Transformation from Ellipsoid (metre) to NAD83(2011) (ballpark vertical transformation, without ellipsoid height to vertical height correction) + Conv Vertical Offset and Slope + Transverse Mercator + Affine transformation as PROJ-based, unknown accuracy, World, has ballpark transformation
809+
810+
PROJ string:
811+
+proj=pipeline
812+
+step +proj=axisswap +order=2,1
813+
+step +proj=unitconvert +xy_in=deg +xy_out=rad
814+
+step +proj=vertoffset +lat_0=41.2305352787143 +lon_0=-73.1815861874286
815+
+dh=31.0121985701957 +slope_lat=-6.12572852418232
816+
+slope_lon=-2.67487863214139
817+
+step +proj=tmerc +lat_0=41.2305352787143 +lon_0=-73.1815861874286 +k=1 +x_0=0
818+
+y_0=0 +ellps=GRS80
819+
+step +proj=affine +xoff=265262.95287 +yoff=196619.27389 +s11=1.00003994119
820+
+s12=0.00548156923529 +s21=-0.00548156923529 +s22=1.00003994119

docs/source/references.bib

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,17 @@ @Article{Jenny2015
227227
Url = {http://www.cartography.oregonstate.edu/pdf/2015_Jenny_etal_ACompromiseAspect-adaptiveCylindricalProjectionForWorldMaps.pdf}
228228
}
229229

230+
@Article{JimenezShaw2023,
231+
Title = {SITE CALIBRATION WITH PROJ AND WKT2},
232+
Author = {Jimenez Shaw, J. and Hernando, J. and Strecha, C.},
233+
Journal = {The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences},
234+
Volume = {XLVIII-4/W7-2023},
235+
Year = {2023},
236+
Pages = {75--81},
237+
Url = {https://isprs-archives.copernicus.org/articles/XLVIII-4-W7-2023/75/2023/},
238+
Doi = {10.5194/isprs-archives-XLVIII-4-W7-2023-75-2023}
239+
}
240+
230241
@Article{Karney2013,
231242
Title = {Algorithms for geodesics},
232243
Author = {Charles F. F. Karney},

0 commit comments

Comments
 (0)