NAME

       gdaltransform - Transforms coordinates.

SYNOPSIS

          gdaltransform [--help-general]
              [-i] [-s_srs srs_def] [-t_srs srs_def] [-to "NAME=VALUE"]
              [-ct proj_string] [-order n] [-tps] [-rpc] [-geoloc]
              [-gcp pixel line easting northing [elevation]]* [-output_xy]
              [srcfile [dstfile]]

DESCRIPTION

       The  gdaltransform  utility  reprojects  a  list  of  coordinates into any supported projection,including
       GCP-based transformations.

       -s_srs <srs_def>
              Set source spatial reference.  The coordinate systems that can be passed are anything supported by
              the  OGRSpatialReference.SetFromUserInput()  call,  which  includes  EPSG  PCS  and  GCSes   (i.e.
              EPSG:4296), PROJ.4 declarations (as above), or the name of a .prj file containing well known text.

       -t_srs <srs_def>
              set target spatial reference.  The coordinate systems that can be passed are anything supported by
              the   OGRSpatialReference.SetFromUserInput()  call,  which  includes  EPSG  PCS  and  GCSes  (i.e.
              EPSG:4296), PROJ.4 declarations (as above), or the name of a .prj file containing well known text.

       -ct <string>
              A PROJ string (single step operation or multiple step string starting with +proj=pipeline), a WKT2
              string describing  a  CoordinateOperation,  or  a  urn:ogc:def:coordinateOperation:EPSG::XXXX  URN
              overriding the default transformation from the source to the target CRS. It must take into account
              the axis order of the source and target CRS.

              New in version 3.0.

       -to NAME=VALUE
              set a transformer option suitable to pass to GDALCreateGenImgProjTransformer2().

       -order <n>
              order  of  polynomial used for warping (1 to 3). The default is to select a polynomial order based
              on the number of GCPs.

       -tps   Force use of thin plate spline transformer based on available GCPs.

       -rpc   Force use of RPCs.

       -geoloc
              Force use of Geolocation Arrays.

       -i     Inverse transformation: from destination to source.

       -gcp <pixel> <line> <easting> <northing> [<elevation>]
              Provide a GCP to be used for transformation (generally three or more are required)

       -output_xy
              Restrict output to "x y" instead of "x y z"

       <srcfile>
              File with source projection definition or GCP's. If not given, source projection is read from  the
              command-line -s_srs or -gcp parameters

       <dstfile>
              File with destination projection definition.

       Coordinates  are  read as pairs, triples (for 3D,) or (since GDAL 3.0.0,) quadruplets (for X,Y,Z,time) of
       numbers per line from standard input, transformed, and written out to standard output in  the  same  way.
       All transformations offered by gdalwarp are handled, including gcp-based ones.

       Note  that  input and output must always be in decimal form.  There is currently no support for DMS input
       or output.

       If an input image file is provided, input is in pixel/line coordinates on that image.  If an output  file
       is provided, output is in pixel/line coordinates on that image.

EXAMPLES

   Reprojection Example
       Simple reprojection from one projected coordinate system to another:

          gdaltransform -s_srs EPSG:28992 -t_srs EPSG:31370
          177502 311865

       Produces the following output in meters in the "Belge 1972 / Belgian Lambert 72" projection:

          244510.77404604 166154.532871342 -1046.79270555763

   Image RPC Example
       The  following command requests an RPC based transformation using the RPC model associated with the named
       file.  Because the -i (inverse) flag is used, the transformation is  from  output  georeferenced  (WGS84)
       coordinates back to image coordinates.

          gdaltransform -i -rpc 06OCT20025052-P2AS-005553965230_01_P001.TIF
          125.67206 39.85307 50

       Produces this output measured in pixels and lines on the image:

          3499.49282422381 2910.83892848414 50

   X,Y,Z,time transform
       15-term  time-dependent  Helmert  coordinate  transformation  from ITRF2000 to ITRF93 for a coordinate at
       epoch 2000.0

          gdaltransform -ct "+proj=pipeline +step +proj=unitconvert +xy_in=deg \
          +xy_out=rad +step +proj=cart +step +proj=helmert +convention=position_vector \
          +x=0.0127 +dx=-0.0029 +rx=-0.00039 +drx=-0.00011 +y=0.0065 +dy=-0.0002 \
          +ry=0.00080 +dry=-0.00019 +z=-0.0209 +dz=-0.0006 +rz=-0.00114 +drz=0.00007 \
          +s=0.00195 +ds=0.00001 +t_epoch=1988.0 +step +proj=cart +inv +step \
          +proj=unitconvert +xy_in=rad +xy_out=deg"
          2 49 0 2000

       Produces this output measured in longitude degrees, latitude degrees and ellipsoid height in metre:

          2.0000005420366 49.0000003766711 -0.0222802283242345

AUTHOR

       Frank Warmerdam <warmerdam@pobox.com>, Jan Hartmann <j.l.h.hartmann@uva.nl>

COPYRIGHT

       1998-2021

                                                  Dec 27, 2021                                  GDALTRANSFORM(1)