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

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

@@ -0,0 +1,511 @@
+.\" 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-TILE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-tile \- Generate tiles in separate files from a raster dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster tile [OPTIONS] <INPUT> <OUTPUT>
+
+Generate tiles in separate files from a raster dataset.
+
+Positional arguments:
+  \-i, \-\-dataset, \-\-input <INPUT>                                   Input raster datasets [required] [not available in pipelines]
+  \-o, \-\-output <OUTPUT>                                            Output directory [required]
+
+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 (default: PNG)
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                            Creation option [may be repeated]
+  \-\-tiling\-scheme <TILING\-SCHEME>                                  Tiling scheme. TILING\-SCHEME=raster|WebMercatorQuad|WorldCRS84Quad|WorldMercatorWGS84Quad|GoogleCRS84Quad|PseudoTMS_GlobalMercator|GlobalGeodeticOriginLat270|LINZAntarticaMapTilegrid|APSTILE|CBMTILE|NZTM2000 (default: WebMercatorQuad)
+  \-\-min\-zoom <MIN\-ZOOM>                                            Minimum zoom level
+  \-\-max\-zoom <MAX\-ZOOM>                                            Maximum zoom level
+  \-\-min\-x <MIN\-X>                                                  Minimum tile X coordinate
+  \-\-max\-x <MAX\-X>                                                  Maximum tile X coordinate
+  \-\-min\-y <MIN\-Y>                                                  Minimum tile Y coordinate
+  \-\-max\-y <MAX\-Y>                                                  Maximum tile Y coordinate
+  \-\-no\-intersection\-ok                                             Whether dataset extent not intersecting tile matrix is only a warning
+  \-r, \-\-resampling <RESAMPLING>                                    Resampling method for max zoom. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (default: cubic)
+  \-\-overview\-resampling <OVERVIEW\-RESAMPLING>                      Resampling method for overviews. OVERVIEW\-RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
+  \-\-convention <CONVENTION>                                        Tile numbering convention: xyz (from top) or tms (from bottom). CONVENTION=xyz|tms (default: xyz)
+  \-\-tile\-size <TILE\-SIZE>                                          Override default tile size
+  \-\-add\-alpha                                                      Whether to force adding an alpha channel
+                                                                   Mutually exclusive with \-\-no\-alpha
+  \-\-no\-alpha                                                       Whether to disable adding an alpha channel
+                                                                   Mutually exclusive with \-\-add\-alpha
+  \-\-output\-nodata <OUTPUT\-NODATA>                                  Output nodata value
+  \-\-skip\-blank                                                     Do not generate blank tiles
+  \-\-metadata <KEY>=<VALUE>                                         Add metadata item to output tiles [may be repeated]
+  \-\-copy\-src\-metadata                                              Whether to copy metadata from source dataset
+  \-\-aux\-xml                                                        Generate .aux.xml sidecar files when needed
+  \-\-kml                                                            Generate KML files
+  \-\-resume                                                         Generate only missing files
+  \-j, \-\-num\-threads <NUM\-THREADS>                                  Number of jobs (or ALL_CPUS) (default: ALL_CPUS)
+  \-\-parallel\-method <PARALLEL\-METHOD>                              Parallelization method (thread, spawn, fork). PARALLEL\-METHOD=thread|spawn|fork
+
+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]
+
+Advanced Resampling Options:
+  \-\-excluded\-values <EXCLUDED\-VALUES>                              Tuples of values (e.g. <R>,<G>,<B> or (<R1>,<G1>,<B1>),(<R2>,<G2>,<B2>)) that must beignored as contributing source pixels during (average) resampling
+  \-\-excluded\-values\-pct\-threshold <EXCLUDED\-VALUES\-PCT\-THRESHOLD>  Minimum percentage of source pixels that must be set at one of the \-\-excluded\-values to cause the excluded value to be used as the target pixel value (default: 50)
+  \-\-nodata\-values\-pct\-threshold <NODATA\-VALUES\-PCT\-THRESHOLD>      Minimum percentage of source pixels that must be set at one of nodata (or alpha=0 or any other way to express transparent pixelto cause the target pixel value to be transparent (default: 100)
+
+Publication Options:
+  \-\-webviewer <WEBVIEWER>                                          Web viewer to generate. WEBVIEWER=none|all|leaflet|openlayers|mapml|stac (default: all) [may be repeated]
+  \-\-url <URL>                                                      URL address where the generated tiles are going to be published
+  \-\-title <TITLE>                                                  Title of the map
+  \-\-copyright <COPYRIGHT>                                          Copyright for the map
+  \-\-mapml\-template <MAPML\-TEMPLATE>                                Filename of a template mapml file where variables will be substituted
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster tile\fP generates a directory with small tiles and metadata,
+following the OGC WMTS Specification. Simple web pages with viewers based on
+OpenLayers and Leaflet are generated as well \- so anybody can comfortably
+explore your maps on\-line and you do not need to install or configure any
+special software (like MapServer) and the map displays very fast in the
+web browser. You only need to upload the generated directory onto a web server.
+.sp
+It generates PNG files by default, but other output formats can be selected
+(JPEG, WEBP, GTiff, etc.). Note that not all formats support non\-Byte data types.
+JPEG and WEBP only support Byte. PNG supports Byte and UInt16. GeoTiff can
+support all data types.
+.sp
+It can also use a tiling scheme fully adapted to the input raster, in terms of
+origin and resolution, when using the \fBraster\fP tiling scheme. In that scheme,
+tiles at the maximum zoom level will have the same resolution as the raster.
+.sp
+Starting with GDAL 3.12, \fBgdal raster tile\fP can be used as the last
+step of a pipeline.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-aux\-xml
+Generate .aux.xml sidecar files when needed
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-add\-alpha
+Whether to force adding an alpha channel. An alpha channel is added by default,
+unless the source dataset has a nodata value and the output format supports it.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-copy\-src\-metadata
+Whether to copy metadata from source dataset into output tiles.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-convention xyz|tms
+Tile numbering convention:
+.INDENT 7.0
+.IP \(bu 2
+\fBxyz\fP (default): from top, as in OGC Web Map Tiling Specification (WMTS)
+.IP \(bu 2
+\fBtms\fP: from bottom, as in OSGeo Tile Map Service (TMS) Specification.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-nodata <NODATA>
+Output nodata value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i, \-\-input <INPUT>
+Input raster dataset [required]
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-kml
+Generate Google Earth SuperOverlay metadata.
+Not compatible with tiling schemes with non\-power\-of\-two zoom levels.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-max\-x <MAX\-X>
+Maximum tile X coordinate, at maximum zoom level. Can be set to restrict
+the tiling process.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-max\-y <MAX\-Y>
+Maximum tile Y coordinate, at maximum zoom level. Can be set to restrict
+the tiling process.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-max\-zoom <MAX\-ZOOM>
+Maximum zoom level to generate. If not specified, this will be determined by
+comparing the resolution of the input dataset with the closest resolution in
+the list of tile matrix of the tile matrix set.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-metadata <KEY>=<VALUE>
+Add metadata item to output tiles [may be repeated]
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-min\-x <MIN\-X>
+Minimum tile X coordinate, at maximum zoom level. Can be set to restrict
+the tiling process.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-min\-y <MIN\-Y>
+Minimum tile Y coordinate, at maximum zoom level. Can be set to restrict
+the tiling process.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-min\-zoom <MIN\-ZOOM>
+Minimum zoom level to generate. If not specified, equal to \fI\%\-\-max\-zoom\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-alpha
+Disable the creation of an alpha channel.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-intersection\-ok
+Whether the dataset extent not intersecting the tile matrix is only a warning.
+Otherwise, by default, an error will be emitted if that occurs.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-j, \-\-num\-threads <value>
+Number of jobs to run at once.
+Default: number of CPUs detected.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-o, \-\-output <OUTPUT>
+Output directory [required]
+.sp
+The directory will be created if it does not exist, but its parent
+directory must exist.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overview\-resampling nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
+Resampling method used to generate zoom levels lower than the maximum zoom
+level. Defaults to the value of \fI\%\-\-resampling\fP is not specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-parallel\-method thread|spawn|fork
+Added in version GDAL: 3.12
+
+.sp
+Parallelization method:
+.INDENT 7.0
+.IP \(bu 2
+\fBthread\fP uses multi\-threading, i.e. parallelized tasks are run within
+the same process.
+.IP \(bu 2
+\fBspawn\fP launches child \fBgdal\fP sub\-processes.
+\fBspawn\fP can achieve better \(dqscaling\(dq, but requires the \fBgdal\fP binary to be
+available. GDAL will try to locate it, but you can also set the \fBGDAL_PATH\fP
+configuration option to point to the directory where the \fBgdal\fP binary is
+located.
+.IP \(bu 2
+\fBfork\fP is a variant of \fBspawn\fP, using the system call \fBfork\fP, without
+executing the the \fBgdal\fP binary. Such method is not available on
+Windows. On Unix systems where it is available, this method is not recommended
+to be used on multithreaded processes, especially the ones where other threads
+are doing GDAL operation, since it can potentially cause deadlocks.
+.UNINDENT
+.sp
+If \fI\%\-\-parallel\-method\fP is not specified, GDAL will automatically
+decide which of the method is the most appropriate, opting for \fBspawn\fP if
+the \fBgdal\fP binary can be located and a sufficient number of tiles per job
+are generated, and otherwise falling back to \fBfork\fP on Linux, MacOSX or FreeBSD
+(if no other thread is running), and otherwise to \fBthread\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r, \-\-resampling nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
+Resampling method used to generate maximum zoom level, and also lower zoom
+levels if \fI\%\-\-overview\-resampling\fP is not specified.
+Defaults to \fBcubic\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-resume
+Generate only missing files. Can be used when interrupting a previous run
+to restart it.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-blank
+Do not generate fully blank/transparent tiles.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-tile\-size <PIXELS>
+Width and height of a tile, in pixels. Default is 256 for default tiling schemes.
+Setting it to a higher value enables generating higher DPI tile sets.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-tiling\-scheme <TILING\-SCHEME>
+Tile cutting scheme. Defaults to WebMercatorQuad (also known as Google Maps compatible).
+.sp
+The following base profiles are available:
+.INDENT 7.0
+.IP \(bu 2
+\fBraster\fP: CRS = CRS of raster, tile size = 256 pixels, raster coverage at all zoom levels.
+.IP \(bu 2
+\fBWebMercatorQuad\fP: CRS = EPSG:3857 (\(dqWGS 84 / Pseudo\-Mercator\(dq), tile size: 256 pixels, whole world coverage at zoom level 0, one single tile at zoom level 0.
+.IP \(bu 2
+\fBWorldCRS84Quad\fP: CRS = EPSG:4326 (\(dqWGS 84\(dq), tile size: 256 pixels, whole world coverage at zoom level 0, two side\-by\-side tiles at zoom level 0
+.IP \(bu 2
+\fBWorldMercatorWGS84Quad\fP: CRS = EPSG:3395 (\(dqWGS 84 / World Mercator\(dq), tile size: 256 pixels, whole world coverage at zoom level 0, one single tile at zoom level 0. This can be seen as a variant of WebMercatorQuad except that it is fully conformal on the WGS84 ellipsoid.
+.IP \(bu 2
+\fBGoogleCRS84Quad\fP: CRS = EPSG:4326 (\(dqWGS 84\(dq), tile size: 256 pixels, whole world coverage at zoom level 0, one single tile at zoom level 0 whose first and last 64 lines are blank (the top origin of the tile is a pseudo latitude of 180 degree, and its bottom \-180 degree).
+.IP \(bu 2
+\fBPseudoTMS_GlobalMercator\fP: CRS = EPSG:3857 (\(dqWGS 84 / Pseudo\-Mercator\(dq), tile size: 256 pixels, whole world coverage at zoom level 0, 2x2 tiles at zoom level 0. This is equivalent to \fBWebMercatorQuad\fP, but with the zoom level shifted by one.
+.IP \(bu 2
+\fBLINZAntarticaMapTileGrid\fP: LINZ Antarctic Map Tile Grid (Ross Sea Region). See \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/gcore/data/tms_LINZAntarticaMapTileGrid.json'\fI\%tms_LINZAntarticaMapTileGrid.json\fP\X'tty: link'
+.IP \(bu 2
+\fBAPSTILE\fP: Alaska Polar Stereographic\-based tiled coordinate reference system for the Arctic region. See \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/gcore/data/tms_MapML_APSTILE.json'\fI\%tms_MapML_APSTILE.json\fP\X'tty: link'
+.IP \(bu 2
+\fBCBMTILE\fP: Lambert Conformal Conic\-based tiled coordinate reference system for Canada. See \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/gcore/data/tms_MapML_CBMTILE.json'\fI\%tms_MapML_CBMTILE.json\fP\X'tty: link'
+.IP \(bu 2
+\fBNZTM2000\fP: LINZ NZTM2000 Map Tile Grid. See \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/gcore/data/tms_NZTM2000.json'\fI\%tms_NZTM2000.json\fP\X'tty: link'
+.UNINDENT
+.sp
+Additional tiling schemes are discovered from \fBtms_XXXX.json\fP files placed in the GDAL data directory.
+.UNINDENT
+.SS Advanced Resampling Options
+.INDENT 0.0
+.TP
+.B \-\-excluded\-values=<EXCLUDED\-VALUES>
+Comma\-separated tuple of values (thus typically \(dqR,G,B\(dq), that are ignored
+as contributing source pixels during resampling. The number of values in
+the tuple must be the same as the number of bands, excluding the alpha band.
+Several tuples of excluded values may be specified using the \(dq(R1,G1,B2),(R2,G2,B2)\(dq syntax.
+Only taken into account for average resampling.
+This concept is a bit similar to nodata/alpha, but the main difference is
+that pixels matching one of the excluded value tuples are still considered
+as valid, when determining the target pixel validity/density.
+.UNINDENT
+.sp
+Added in version 3.11.1.
+
+.INDENT 0.0
+.TP
+.B \-\-excluded\-values\-pct\-threshold=<EXCLUDED\-VALUES\-PCT\-THRESHOLD>
+Minimum percentage of source pixels that must be set at one of the \-\-excluded\-values to cause the excluded
+value, that is in majority among source pixels, to be used as the target pixel value. Default value is 50(%)
+.UNINDENT
+.sp
+Added in version 3.11.1.
+
+.INDENT 0.0
+.TP
+.B \-\-nodata\-values\-pct\-threshold=<NODATA\-VALUES\-PCT\-THRESHOLD>
+Minimum percentage of source pixels that must be at nodata (or alpha=0 or any
+other way to express transparent pixel) to cause the target pixel value to
+be transparent. Default value is 100 (%), which means that a target pixel is
+transparent only if all contributing source pixels are transparent.
+Only taken into account for average resampling.
+.UNINDENT
+.sp
+Added in version 3.11.1.
+
+.SS Publication Options
+.INDENT 0.0
+.TP
+.B \-\-webviewer none|all|leaflet|openlayers|mapml|stac
+Web viewer to generate. Defaults to \fBall\fP\&. Those web viewers are created
+at the root of the output directory.
+.sp
+\fBstac\fP generates a \fBstacta.json\fP file, following the
+Spatio\-Temporal Asset Catalog Tiled Assets specification, and that can
+be opened by the \fI\%STACTA driver\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-url
+URL address where the generated tiles are going to be published.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-title <TITLE>
+Title of the map.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-copyright <COPYRIGHT>
+Copyright for the map.
+.UNINDENT
+.SS MapML options
+.sp
+MapML webviewer can only be generated if \fI\%\-\-convention\fP is set to the
+default value \fBxyz\fP\&.
+.sp
+The following profiles are supported:
+.INDENT 0.0
+.IP \(bu 2
+\fBWebMercatorQuad\fP: mapped to OSMTILE MapML tiling scheme
+.IP \(bu 2
+\fBGoogleCRS84Quad\fP: mapped to WGS84 MapML tiling scheme
+.IP \(bu 2
+\fBAPSTILE\fP: from the tms_MapML_APSTILE.json data file
+.IP \(bu 2
+\fBCBMTILE\fP: from the tms_MapML_CBMTILE.json data file
+.UNINDENT
+.sp
+The generated MapML file in the output directory is \fBmapml.mapl\fP
+.sp
+Available options are:
+.INDENT 0.0
+.TP
+.B \-\-mapml\-template <filename>
+Filename of a template mapml file where variables will
+be substituted. If not specified, the generic
+template_tiles.mapml file from GDAL data resources
+will be used
+.UNINDENT
+.sp
+The \fI\%\-\-url\fP option is also used to substitute \fB${URL}\fP in the template MapML file.
+.SH STANDARD OPTIONS
+.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
+.sp
+Defaults to PNG.
+.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: Generate PNG tiles with WebMercatorQuad tiling scheme for zoom levels 2 to 5.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster tile \-\-min\-zoom=2 \-\-max\-zoom=5 input.tif output_folder
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Retile a raster using its origin and resolution
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster tile \-\-tiling\-scheme raster input.tif output_folder
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Creating a tiled dataset, compatible of the Spatio\-Temporal Asset Catalog Tiled Assets specification, using Cloud\-Optimized GeoTIFF metatiles of dimension 4096x4096.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster tile \-\-format COG \-\-tile\-size 4096 input.tif output_folder
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Mosaic on\-the\-fly several input files and tile that mosaic.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pipeline ! mosaic input*.tif ! tile output_folder
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

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

@@ -0,0 +1,184 @@
+.\" 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-TPI" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-tpi \- Generate a Topographic Position Index (TPI) map
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster tpi [OPTIONS] <INPUT> <OUTPUT>
+
+Generate a Topographic Position Index (TPI) map
+
+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
+  \-b, \-\-band <BAND>                                    Input band (1\-based index) (default: 1)
+  \-\-no\-edges                                           Do not try to interpolate values at dataset edges or close to nodata values
+
+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 tpi\fP generates a single\-band raster with values computed
+from the elevation. TPI stands for Topographic Position Index, which is defined
+as the difference between a central pixel and the mean of its surrounding cells
+(see Wilson et al 2007, Marine Geodesy 30:3\-35).
+.sp
+This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
+.sp
+Value \-9999 is used as the nodata value.
+.sp
+A nodata value in the target dataset will also be emitted if at least one pixel set to the nodata value is found in the
+3x3 window centered around each source pixel. By default, the algorithm will
+compute values at image edges or if a nodata value is found in the 3x3 window,
+by interpolating missing values, unless \fI\%\-\-no\-edges\fP is specified, in
+which case a 1\-pixel border around the image will be set with the nodata value.
+.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 \-b, \-\-band <BAND>
+Index (starting at 1) of the band to which the TPI must be computed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-edges
+Do not try to interpolate values at dataset edges or close to nodata values
+.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 \-\-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: Generates a Topographic Position Index (TPI) map from a DTED0 file.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster tpi n43.dt0 out.tif \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.