aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/transformations/deformation.rst
AgeCommit message (Collapse)Author
2020-01-15Doc: add notes in deformation.rst regarding +xy_grids/+z_grids being ↵Even Rouault
exclusive of new option +grids
2020-01-07Doc: address code review commentsEven Rouault
2019-12-30deformation: add support for +grids= for GeoTIFF gridsEven Rouault
This option is to load grid(s) that have both the horizontal and vertical velocities in the same file. Can be tested with the following grid https://github.com/rouault/sample_proj_gtiff_grids/blob/master/nkgrf03vel_realigned.tif converted from the original .ct2 and .gtx with ``` gdal_translate nkgrf03vel_realigned.vrt nkgrf03vel_realigned.tif -co COMPRESS=DEFLATE -co PREDICTOR=3 -co BLOCKYSIZE=241 -co INTERLEAVE=BAND ``` where nkgrf03vel_realigned.vrt is ``` <VRTDataset rasterXSize="223" rasterYSize="241"> <SRS dataAxisToSRSAxisMapping="2,1">GEOGCRS["Unknown based on GRS80", DATUM["Unknown based on GRS80", ELLIPSOID["GRS 1980",6378137,298.257222101, LENGTHUNIT["metre",1]]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], CS[ellipsoidal,2], AXIS["geodetic latitude (Lat)",north, ORDER[1], ANGLEUNIT["degree",0.0174532925199433]], AXIS["geodetic longitude (Lon)",east, ORDER[2], ANGLEUNIT["degree",0.0174532925199433]]] </SRS> <GeoTransform> 2.9166666666666670e+00, 1.6666666666666666e-01, 0.0000000000000000e+00, 7.3041666666666686e+01, 0.0000000000000000e+00, -8.3333333333333329e-02</GeoTransform> <Metadata> <MDI key="DESCRIPTION"></MDI> <MDI key="area_of_use">Nordic and Baltic countries</MDI> <MDI key="AREA_OR_POINT">Point</MDI> <MDI key="TIFFTAG_COPYRIGHT">The Nordic Geodetic Commission. Creative Commons Attribution 4.0 https://creativecommons.org/licenses/by/4.0/</MDI> <MDI key="TIFFTAG_DATETIME">2019:12:30 00:00:00</MDI> <MDI key="TIFFTAG_IMAGEDESCRIPTION">Deformation model covering the Nordic and Baltic countries. Used in transformations between global reference frames and the local realisations of ETRS89 in the Nordic and Baltic countries</MDI> <MDI key="TYPE">VELOCITY</MDI> </Metadata> <VRTRasterBand dataType="Float32" band="1"> <Description>east_velocity</Description> <UnitType>mm/year</UnitType> <SimpleSource> <SourceFilename relativeToVRT="0">/home/even/proj/proj-datumgrid/europe/nkgrf03vel_realigned_xy.ct2</SourceFilename> <SourceBand>2</SourceBand> <!-- GDAL exposes the first physical component of the file (longitude offset normally, here east velocity) as the second band --> <SrcRect xOff="0" yOff="0" xSize="223" ySize="241" /> <DstRect xOff="0" yOff="0" xSize="223" ySize="241" /> </SimpleSource> </VRTRasterBand> <VRTRasterBand dataType="Float32" band="2"> <Description>north_velocity</Description> <UnitType>mm/year</UnitType> <SimpleSource> <SourceFilename relativeToVRT="0">/home/even/proj/proj-datumgrid/europe/nkgrf03vel_realigned_xy.ct2</SourceFilename> <SourceBand>1</SourceBand> <!-- and the second physical component (latitude offset normally, here north velocity) as the first band --> <SrcRect xOff="0" yOff="0" xSize="223" ySize="241" /> <DstRect xOff="0" yOff="0" xSize="223" ySize="241" /> </SimpleSource> </VRTRasterBand> <VRTRasterBand dataType="Float32" band="3"> <Description>up_velocity</Description> <UnitType>mm/year</UnitType> <SimpleSource> <SourceFilename relativeToVRT="0">/home/even/proj/proj-datumgrid/europe/nkgrf03vel_realigned_z.gtx</SourceFilename> <SourceBand>1</SourceBand> <SrcRect xOff="0" yOff="0" xSize="223" ySize="241" /> <DstRect xOff="0" yOff="0" xSize="223" ySize="241" /> </SimpleSource> </VRTRasterBand> </VRTDataset> ```
2019-02-14deformation: Replace +t_obs with +dtKristian Evers
The +t_obs parameter was confusing for users since it effectively overwrote the observation time in input coordinates. To make it more clear what is the operation is doing, users are now required to directly specify the time span for which they wish to apply a given deformation. The parameter +dt has been added for that purpose. The new parameter is mutually exclusive with +t_epoch. +dt is used when deformation for a set amount of time is needed and +t_epoch is used (in conjunction with the observation time of the input coordinate) when deformation from a specific epoch to the observation time is needed.
2019-02-14Reverse direction of deformation operations/transformations/deformationKristian Evers
Changed the direction of dt-calculation to follow the same convention as helmert. Changed from dt = t_c - t_obs to dt = t_obs - t_c, which effectively reverses the direction of the operation. Existing projstrings using deformation can simply reverse the direction of the operation to achieve the same results as before this commit.
2018-08-21[BREAKING] Hermert: add +convention=position_vector/coordinate_frame, ↵Even Rouault
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.
2018-06-25doc: typo fixEven Rouault
2018-06-10rewrite references using BibTeX and sphinxcontrib-bibtexMike Toews
2018-05-02Fix syntax in RST tablesmwtoews
2018-04-30Refactor operation doc pagesKristian Evers
Extended the use of the :option: directive to all currently written operation doc pages. In the process several more default parameters were added for easy inclusion in other doc pages. Expanded the info tables for each operation with "domain", "alias", "input type" and "output type". Corrected various errors along the way. Mainly formatting errors and references to invalid parameters such as +sym in hatano.
2018-03-30Improve log and documentation regarding t_obs in helmert and deformation ↵Even Rouault
operations
2018-03-06fix a few typos (again)Mike Toews
2018-02-28Move 'Coordinate operations' to top level of docs [skip ci]Kristian Evers