@crossbind/port-gdal-wasi 2.0.0-beta.50

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdaltransform.1

@@ -0,0 +1,345 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDALTRANSFORM" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdaltransform \- Transforms coordinates.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdaltransform [\-\-help] [\-\-help\-general]
+       [\-i] [\-s_srs <srs_def>] [\-t_srs <srs_def>] [\-to >NAME>=<VALUE>]...
+       [\-s_coord_epoch <epoch>] [\-t_coord_epoch <epoch>]
+       [\-ct <proj_string>] [\-order <n>] [\-tps] [\-rpc] [\-geoloc] 
+       [\-gcp <pixel> <line> <easting> <northing> [elevation]]...
+       [\-output_xy] [\-E] [\-field_sep <sep>] [\-ignore_extra_input]
+       [<srcfile> [<dstfile>]]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The gdaltransform utility reprojects a list of coordinates into any supported
+projection,including GCP\-based transformations.
+.INDENT 0.0
+.TP
+.B \-\-help
+Show this help message and exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-help\-general
+Gives a brief usage message for the generic GDAL commandline options and exit.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-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.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-s_coord_epoch <epoch>
+Added in version 3.8.
+
+.sp
+Assign a coordinate epoch, linked with the source SRS. Useful when the
+source SRS is a dynamic CRS. Only taken into account if \fI\%\-s_srs\fP
+is used.
+.sp
+Before PROJ 9.4, \fI\%\-s_coord_epoch\fP and \fI\%\-t_coord_epoch\fP were
+mutually exclusive, due to lack of support for transformations between two dynamic CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-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.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-t_coord_epoch <epoch>
+Added in version 3.8.
+
+.sp
+Assign a coordinate epoch, linked with the output SRS. Useful when the
+output SRS is a dynamic CRS. Only taken into account if \fI\%\-t_srs\fP
+is used.
+.sp
+Before PROJ 9.4, \fI\%\-s_coord_epoch\fP and \fI\%\-t_coord_epoch\fP were
+mutually exclusive, due to lack of support for transformations between two dynamic CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ct <string>
+A PROJ string (single step operation or multiple step string
+starting with +proj=pipeline), a WKT2 string describing a CoordinateOperation,
+or a \fI\%urn:ogc:def:coordinateOperation:EPSG::XXXX\fP 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.
+.sp
+Added in version 3.0.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-to <NAME>=<VALUE>
+set a transformer option suitable to pass to \fI\%GDALCreateGenImgProjTransformer2()\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-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.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-tps
+Force use of thin plate spline transformer based on available GCPs.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-rpc
+Force use of RPCs.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-geoloc
+Force use of Geolocation Arrays.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i
+Inverse transformation: from destination to source.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-gcp <pixel> <line> <easting> <northing> [<elevation>]
+Provide a GCP to be used for transformation (generally three or more are required). Pixel and line need not be integers.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-output_xy
+Restrict output to \(dqx y\(dq instead of \(dqx y z\(dq
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-ignore_extra_input
+Added in version 3.9.
+
+.sp
+Set this flag to avoid extra non\-numeric content at end of input lines to be
+appended to the output lines.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-E
+Added in version 3.9.
+
+.sp
+Enable Echo mode, where input coordinates are prepended to the output lines.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-field_sep <sep>
+Added in version 3.9.
+
+.sp
+Defines the field separator, to separate different values.
+It defaults to the space character.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <srcfile>
+Raster dataset with source projection definition or GCPs. If
+not given, source projection/GCPs are read from the command\-line \fI\%\-s_srs\fP
+or \fI\%\-gcp\fP parameters.
+.sp
+Note that only the SRS and/or GCPs of this input file is taken into account, and not its pixel content.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B <dstfile>
+Raster dataset with destination projection definition.
+.UNINDENT
+.sp
+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.
+.sp
+Starting with GDAL 3.9, additional non\-numeric content (typically point name)
+at the end of an input line will also be appended to the output line, unless
+the \fI\%\-ignore_extra_input\fP is added.
+.sp
+Note that input and output must always be in decimal form.  There is currently
+no support for DMS input or output.
+.sp
+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.
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Reprojection Example
+.sp
+Simple reprojection from one projected coordinate system to another:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdaltransform \-s_srs EPSG:28992 \-t_srs EPSG:31370
+177502 311865
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Produces the following output in meters in the \(dqBelge 1972 / Belgian Lambert
+72\(dq projection:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+244296.724777415 165937.350217148 0
+.EE
+.UNINDENT
+.UNINDENT
+.SS Image RPC Example
+.sp
+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.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdaltransform \-i \-rpc 06OCT20025052\-P2AS\-005553965230_01_P001.TIF
+125.67206 39.85307 50
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Produces this output measured in pixels and lines on the image:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+3499.49282422381 2910.83892848414 50
+.EE
+.UNINDENT
+.UNINDENT
+.SS X,Y,Z,time transform
+.sp
+15\-term time\-dependent Helmert coordinate transformation from ITRF2000 to ITRF93
+for a coordinate at epoch 2000.0
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdaltransform \-ct \(dq+proj=pipeline +step +proj=unitconvert +xy_in=deg \e
++xy_out=rad +step +proj=cart +step +proj=helmert +convention=position_vector \e
++x=0.0127 +dx=\-0.0029 +rx=\-0.00039 +drx=\-0.00011 +y=0.0065 +dy=\-0.0002 \e
++ry=0.00080 +dry=\-0.00019 +z=\-0.0209 +dz=\-0.0006 +rz=\-0.00114 +drz=0.00007 \e
++s=0.00195 +ds=0.00001 +t_epoch=1988.0 +step +proj=cart +inv +step \e
++proj=unitconvert +xy_in=rad +xy_out=deg\(dq
+2 49 0 2000
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Produces this output measured in longitude degrees, latitude degrees and ellipsoid height in meters:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+2.0000005420366 49.0000003766711 \-0.0222802283242345
+.EE
+.UNINDENT
+.UNINDENT
+.SS Ground control points
+.sp
+Task: find one address and assign another.
+We pick Salt Lake City, where road names \fIare\fP their grid values.
+We first establish some ground control points at road intersections.
+We\(aqll use \fI\%\-\-optfile\fP for easy reuse of our GCPs.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+echo \-output_xy \e
+\-gcp 0   0    \-111.89114717 40.76932606 \e
+\-gcp 0   \-500 \-111.89114803 40.75846686 \e
+\-gcp 500 0    \-111.87685039 40.76940631 > optfile.txt
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+Where is the address \(dq370 S. 300 E.\(dq?
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+echo 300 \-370 Address 370 S. 300 E. | gdaltransform \-\-optfile optfile.txt
+\-111.8825697384 40.761338402 Address 370 S. 300 E.
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+(The 370 is protected from being consumed as an elevation by placing a word before it.)
+.sp
+Nearby, a newly constructed building needs an address assigned. We use \fI\%\-i\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+echo \-111.88705 40.76502 Building ABC123 | gdaltransform \-i \-\-optfile optfile.txt
+143.301947786644 \-199.32683635161 Building ABC123
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+(i.e., 143 E. 200 S. Or 144 if across the street.)
+.SH AUTHOR
+Frank Warmerdam <warmerdam@pobox.com>, Jan Hartmann <j.l.h.hartmann@uva.nl>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.