1gdaltransform(1)            General Commands Manual           gdaltransform(1)
2
3
4

NAME

6       gdaltransformTransforms coordinates.
7

SYNOPSIS

9       gdaltransform [--help-general]
10           [-i] [-s_srs srs_def] [-t_srs srs_def] [-to "NAME=VALUE"]
11           [-order n] [-tps] [-rpc] [-geoloc]
12           [-gcp pixel line easting northing [elevation]]* [-output_xy]
13           [srcfile [dstfile]]
14

DESCRIPTION

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       -to NAME=VALUE:
34           set a transformer option suitable to pass to
35           GDALCreateGenImgProjTransformer2().
36
37       -order n:
38           order of polynomial used for warping (1 to 3). The default is to
39           select a polynomial order based on the number of GCPs.
40
41       -tps:
42           Force use of thin plate spline transformer based on available GCPs.
43
44       -rpc:
45           Force use of RPCs.
46
47       -geoloc:
48           Force use of Geolocation Arrays.
49
50       -i  Inverse transformation: from destination to source.
51
52       -gcppixel line easting northing [elevation]:
53           Provide a GCP to be used for transformation (generally three or
54           more are required)
55
56       -output_xy:
57           (GDAL >= 2.0) Restrict output to 'x y' instead of 'x y z'
58
59       srcfile:
60           File with source projection definition or GCP's. If not given,
61           source projection is read from the command-line -s_srs or -gcp
62           parameters
63
64       dstfile:
65           File with destination projection definition.
66
67       Coordinates are read as pairs (or triples) of numbers per line from
68       standard input, transformed, and written out to standard output in the
69       same way. All transformations offered by gdalwarp are handled,
70       including gcp-based ones.
71
72       Note that input and output must always be in decimal form. There is
73       currently no support for DMS input or output.
74
75       If an input image file is provided, input is in pixel/line coordinates
76       on that image. If an output file is provided, output is in pixel/line
77       coordinates on that image.
78

Reprojection Example

80       Simple reprojection from one projected coordinate system to another:
81
82       gdaltransform -s_srs EPSG:28992 -t_srs EPSG:31370
83       177502 311865
84
85       Produces the following output in meters in the 'Belge 1972 / Belgian
86       Lambert 72' projection:
87
88       244510.77404604 166154.532871342 -1046.79270555763
89

Image RPC Example

91       The following command requests an RPC based transformation using the
92       RPC model associated with the named file. Because the -i (inverse) flag
93       is used, the transformation is from output georeferenced (WGS84)
94       coordinates back to image coordinates.
95
96       gdaltransform -i -rpc 06OCT20025052-P2AS-005553965230_01_P001.TIF
97       125.67206 39.85307 50
98
99       Produces this output measured in pixels and lines on the image:
100
101       3499.49282422381 2910.83892848414 50
102
103

AUTHORS

105       Frank Warmerdam warmerdam@pobox.com, Jan Hartmann j.l.h.hartmann@uva.nl
106
107
108
109GDAL                            Wed Oct 3 2018                gdaltransform(1)
Impressum