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

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-raster-reclassify.1

@@ -0,0 +1,261 @@
+'\" t
+.\" 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 "GDAL-RASTER-RECLASSIFY" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-reclassify \- Reclassify a raster dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster reclassify [OPTIONS] <INPUT> <OUTPUT>
+
+Reclassify values in a raster dataset
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                      Input raster datasets [required] [not available in pipelines]
+  \-o, \-\-output <OUTPUT>                                    Output raster dataset [required] [not available in pipelines]
+
+Common Options:
+  \-h, \-\-help                                               Display help message and exit
+  \-\-json\-usage                                             Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                                   Configuration option [may be repeated]
+  \-q, \-\-quiet                                              Quiet mode (no progress bar or warning message) [not available in pipelines]
+
+Options:
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>      Output format (\(dqGDALG\(dq allowed) [not available in pipelines]
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                    Creation option [may be repeated] [not available in pipelines]
+  \-\-overwrite                                              Whether overwriting existing output dataset is allowed [not available in pipelines]
+                                                           Mutually exclusive with \-\-append
+  \-\-append                                                 Append as a subdataset to existing output [not available in pipelines]
+                                                           Mutually exclusive with \-\-overwrite
+  \-m, \-\-mapping <MAPPING>                                  Reclassification mappings (or specify a @<filename> to point to a file containing mappings [required]
+  \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>  Output data type. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                      Input formats [may be repeated] [not available in pipelines]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                        Open options [may be repeated] [not available in pipelines]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster reclassify\fP reclassifies values in an input dataset.
+A file (or string) specifies the mapping of input pixel values or ranges to output files.
+.sp
+Ranges of values can be specified using brackets:
+.TS
+box center;
+l|l.
+T{
+Notation
+T}	T{
+Meaning
+T}
+_
+T{
+\fB[a,b]\fP
+T}	T{
+Closed interval, includes both \fBa\fP and \fBb\fP
+T}
+_
+T{
+\fB[a,b)\fP
+T}	T{
+Left\-closed, right\-open, includes \fBa\fP but excludes \fBb\fP
+T}
+_
+T{
+\fB(a,b]\fP
+T}	T{
+Left\-open, right\-closed, excludes \fBa\fP but includes \fBb\fP
+T}
+_
+T{
+\fB(a,b)\fP
+T}	T{
+Open interval, excludes both \fBa\fP and \fBb\fP
+T}
+.TE
+.sp
+An example file is shown below.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+# remap land cover types
+0       = 10      # land
+[2,4]   = 20      # freshwater
+1       = 40      # ocean
+(4,6]   = 50      # forest (excludes 4, includes 5 and 6)
+NO_DATA = NO_DATA # leave NoData pixels unmodified
+.EE
+.UNINDENT
+.UNINDENT
+.sp
+The \fB#\fP character indicates a comment that is ignored by the parser but
+can make the file easier to read.)
+In this case:
+.INDENT 0.0
+.IP \(bu 2
+input values of 0 will be output as 10
+.IP \(bu 2
+input values between 2 and 4 (inclusive) will be output as 20
+.IP \(bu 2
+input values of 1 will be output as 40
+.IP \(bu 2
+input values between 5 and 6 will be output as 50 (4 is excluded)
+.IP \(bu 2
+NoData values will be preserved as NoData
+.UNINDENT
+.sp
+The presence of any other values in the input will cause an error.
+If this is not desired, the input range \fBDEFAULT\fP can be used to specify an output
+value for pixels not covered by any other input range.
+These pixels may be converted unto NoData (\fBDEFAULT = NO_DATA\fP), some other constant value (e.g., \fBDEFAULT = 50\fP), or left unmodified (\fBDEFAULT = PASS_THROUGH\fP).
+.INDENT 0.0
+.INDENT 2.5
+[image]
+Raster dataset before (left) and after (right) reclassification with \fBgdal raster reclassify \-\-mapping \(dq[1,3]= 101; [4, 5)= 102; 7=102; NO_DATA=103; DEFAULT=NO_DATA\(dq\fP\&..UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBgdal raster reclassify\fP supports writing to VRT format; however, VRT
+files generated in this way can only be opened using GDAL 3.11 or greater.
+.UNINDENT
+.UNINDENT
+.SH GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)
+.sp
+This program supports serializing the command line as a JSON file using the \fBGDALG\fP output format.
+The resulting file can then be opened as a raster dataset using the
+\fI\%GDALG: GDAL Streamed Algorithm\fP driver, and apply the specified pipeline in a on\-the\-fly /
+streamed way.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-m, \-\-mapping <MAPPING>
+A definition of mappings between input and output pixel values, as described above.
+The mappings may either be provided as text (with each entry separate by a semicolon),
+or they may be read from a file using \fB@filename.txt\fP\&.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Append input raster as a new subdataset to an existing output file.
+Only works with drivers that support adding subdatasets such as
+\fI\%GTiff \-\- GeoTIFF File Format\fP and \fI\%GPKG \-\- GeoPackage raster\fP
+This also creates the output dataset if it does not exist yet.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional creation options that can be
+used to control particulars about the file created. For instance,
+the GeoTIFF driver supports creation options to control compression,
+and whether the file should be tiled.
+.sp
+May be repeated.
+.sp
+The creation options available vary by format driver, and some
+simple formats have no creation options at all. A list of options
+supported for a format can be listed with the
+\fI\%\-\-formats\fP
+command line option but the documentation for the format is the
+definitive source of information on driver creation options.
+See \fI\%Raster drivers\fP format
+specific documentation for legal creation options for each format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-if, \-\-input\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output raster format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep raster | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>
+Output data type among \fBByte\fP, \fBInt8\fP, \fBUInt16\fP, \fBInt16\fP, \fBUInt32\fP,
+\fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBCInt16\fP, \fBCInt32\fP, \fBFloat32\fP,
+\fBFloat64\fP, \fBCFloat32\fP, \fBCFloat64\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overwrite
+Allow program to overwrite existing target file or dataset.
+Otherwise, by default, \fBgdal\fP errors out if the target file or
+dataset already exists.
+.UNINDENT
+.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 Example 1
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster reclassify \-m \(dq0=10; [2,4]=20; 1=40\(dq \-i wbm.tif \-o typ.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Dan Baston <dbaston@gmail.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.