1gdaltransform(1) General Commands Manual gdaltransform(1)
2
3
4
6 gdaltransformTransforms coordinates.
7
9 gdaltransform [--help-general]
10 [-i] [-s_srs srs_def] [-t_srs srs_def] [-to "NAME=VALUE"]
11 [-ct proj_string] [-order n] [-tps] [-rpc] [-geoloc]
12 [-gcp pixel line easting northing [elevation]]* [-output_xy]
13 [srcfile [dstfile]]
14
16 The gdaltransform utility reprojects a list of coordinates into any
17 supported projection,including GCP-based transformations.
18
19 -s_srs srs def:
20 source spatial reference set. The coordinate systems that can be
21 passed are anything supported by the
22 OGRSpatialReference.SetFromUserInput() call, which includes EPSG
23 PCS and GCSes (i.e. EPSG:4296), PROJ.4 declarations (as above), or
24 the name of a .prj file containing well known text.
25
26 -t_srs srs_def:
27 target spatial reference set. The coordinate systems that can be
28 passed are anything supported by the
29 OGRSpatialReference.SetFromUserInput() call, which includes EPSG
30 PCS and GCSes (i.e. EPSG:4296), PROJ.4 declarations (as above), or
31 the name of a .prj file containing well known text.
32
33 -ct string:
34 (GDAL >= 3.0) A PROJ string (single step operation or multiple step
35 string starting with +proj=pipeline), a WKT2 string describing a
36 CoordinateOperation, or a
37 urn:ogc:def:coordinateOperation:EPSG::XXXX URN overriding the
38 default transformation from the source to the target CRS. It must
39 take into account the axis order of the source and target CRS.
40
41 -to NAME=VALUE:
42 set a transformer option suitable to pass to
43 GDALCreateGenImgProjTransformer2().
44
45 -order n:
46 order of polynomial used for warping (1 to 3). The default is to
47 select a polynomial order based on the number of GCPs.
48
49 -tps:
50 Force use of thin plate spline transformer based on available GCPs.
51
52 -rpc:
53 Force use of RPCs.
54
55 -geoloc:
56 Force use of Geolocation Arrays.
57
58 -i Inverse transformation: from destination to source.
59
60 -gcppixel line easting northing [elevation]:
61 Provide a GCP to be used for transformation (generally three or
62 more are required)
63
64 -output_xy:
65 (GDAL >= 2.0) Restrict output to 'x y' instead of 'x y z'
66
67 srcfile:
68 File with source projection definition or GCP's. If not given,
69 source projection is read from the command-line -s_srs or -gcp
70 parameters
71
72 dstfile:
73 File with destination projection definition.
74
75 Coordinates are read as pairs, triples for 3D or, since GDAL 3.0.0,
76 quadruplets for X,Y,Z,time of numbers per line from standard input,
77 transformed, and written out to standard output in the same way. All
78 transformations offered by gdalwarp are handled, including gcp-based
79 ones.
80
81 Note that input and output must always be in decimal form. There is
82 currently no support for DMS input or output.
83
84 If an input image file is provided, input is in pixel/line coordinates
85 on that image. If an output file is provided, output is in pixel/line
86 coordinates on that image.
87
89 Simple reprojection from one projected coordinate system to another:
90
91 gdaltransform -s_srs EPSG:28992 -t_srs EPSG:31370
92 177502 311865
93
94 Produces the following output in meters in the 'Belge 1972 / Belgian
95 Lambert 72' projection:
96
97 244510.77404604 166154.532871342 -1046.79270555763
98
100 The following command requests an RPC based transformation using the
101 RPC model associated with the named file. Because the -i (inverse) flag
102 is used, the transformation is from output georeferenced (WGS84)
103 coordinates back to image coordinates.
104
105 gdaltransform -i -rpc 06OCT20025052-P2AS-005553965230_01_P001.TIF
106 125.67206 39.85307 50
107
108 Produces this output measured in pixels and lines on the image:
109
110 3499.49282422381 2910.83892848414 50
111
112
114 15-term time-dependent Helmert coordinate transformation from ITRF2000
115 to ITRF93 for a coordinate at epoch 2000.0
116
117 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"
118 2 49 0 2000
119
120 Produces this output measured in longitude degrees, latitude degrees
121 and ellipsoid height in metre:
122
123 2.0000005420366 49.0000003766711 -0.0222802283242345
124
126 Frank Warmerdam warmerdam@pobox.com, Jan Hartmann j.l.h.hartmann@uva.nl
127
128
129
130GDAL Tue Mar 3 2020 gdaltransform(1)