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

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

@@ -0,0 +1,206 @@
+.\" 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-OVERVIEW-REFRESH" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-overview-refresh \- Refresh overviews
+.sp
+Added in version 3.12.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster overview refresh [OPTIONS] <INPUT>
+
+Refresh overviews.
+
+Positional arguments:
+  \-i, \-\-dataset, \-\-input <INPUT>     Dataset (to be updated in\-place, unless \-\-external) [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:
+  \-\-external                         Refresh external overviews
+  \-r, \-\-resampling <RESAMPLING>      Resampling method. RESAMPLING=nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode
+  \-\-levels <LEVELS>                  Levels / decimation factors [may be repeated]
+  \-\-bbox <BBOX>                      Bounding box to refresh
+                                     Mutually exclusive with \-\-like, \-\-use\-source\-timestamp
+  \-\-like <LIKE>                      Use extent of dataset(s) [may be repeated]
+                                     Mutually exclusive with \-\-bbox, \-\-use\-source\-timestamp
+  \-\-use\-source\-timestamp             Use timestamp of VRT or GTI sources as refresh criterion
+                                     Mutually exclusive with \-\-bbox, \-\-like
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>  Open options [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster overview refresh\fP can be used to refresh existing overviews
+of a dataset.
+By default all overviews are refreshed, but it is also possible to restrict
+the refreshed overviews by level and/or extent.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-bbox <xmin>,<ymin>,<xmax>,ymax>
+This option performs a partial refresh of existing overviews, in the region
+of interest specified by georeferenced coordinates, in CRS units.
+.sp
+\(aqx\(aq is longitude values for geographic CRS and easting for projected CRS.
+\(aqy\(aq is latitude values for geographic CRS and northing for projected CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-dataset <DATASET>
+Dataset name, to be updated in\-place by default (unless \fI\%\-\-external\fP is specified). Required.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-external
+Refresh external \fB\&.ovr\fP overviews.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-levels <level1,level2,...>
+A list of overview levels to build. Each overview level must be an integer
+value greater or equal to 2.
+.sp
+If not specified all existing overviews are refreshed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-like <filename1>[,<filenameN>]...
+This option performs a partial refresh of existing overviews, in the region
+of interest specified by one or several filenames (names separated by comma).
+Note that the filenames are only used to determine the regions of interest
+to refresh. The reference source pixels are the one of the main dataset.
+By default all existing overview levels will be refreshed, unless explicit
+levels are specified. See \fI\%Example 2\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r, \-\-resampling {nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode}
+Select a resampling algorithm. The default is \fBnearest\fP, which is generally not
+appropriate if sub\-pixel accuracy is desired.
+.sp
+When refreshing existing TIFF overviews, the previously
+used method, as noted in the RESAMPLING metadata item of the overview, will
+be used if \fI\%\-r\fP is not specified.
+.sp
+The available methods are:
+.sp
+\fBnearest\fP applies a nearest neighbour (simple sampling) resampler.
+.sp
+\fBaverage\fP computes the average of all non\-NODATA contributing pixels. This is a weighted average taking into account properly the weight of source pixels not contributing fully to the target pixel.
+.sp
+\fBbilinear\fP applies a bilinear convolution kernel.
+.sp
+\fBcubic\fP applies a cubic convolution kernel.
+.sp
+\fBcubicspline\fP applies a B\-Spline convolution kernel.
+.sp
+\fBlanczos\fP applies a Lanczos windowed sinc convolution kernel.
+.sp
+\fBgauss\fP applies a Gaussian kernel before computing the overview,
+which can lead to better results than simple averaging in e.g case of sharp edges
+with high contrast or noisy patterns. The advised level values should be 2, 4, 8, ...
+so that a 3x3 resampling Gaussian kernel is selected.
+.sp
+\fBaverage_magphase\fP averages complex data in mag/phase space.
+.sp
+\fBrms\fP computes the root mean squared / quadratic mean of all non\-NODATA contributing pixels
+.sp
+\fBmode\fP selects the value which appears most often of all the sampled points.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-use\-source\-timestamp
+This option performs a partial refresh of existing overviews of a
+\fI\%VRT \-\- GDAL Virtual Format\fP or \fI\%GTI \-\- GDAL Raster Tile Index\fP file with an external overview.
+It checks the modification timestamp of all the sources of the VRT
+and regenerate the overview for areas corresponding to sources whose
+timestamp is more recent than the external overview of the VRT.
+By default all existing overview levels will be refreshed, unless explicit
+levels are specified. See \fI\%Example 1\fP\&.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.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: Refresh external overviews of a VRT file using timestamp of source files
+.sp
+This is needed when for sources have been modified after the .vrt.ovr generation:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster mosaic tile1.tif tile2.tif my.vrt               # create VRT
+gdal raster overview add \-\-external \-r cubic my.vrt         # initial overview generation
+touch tile1.tif                                             # simulate update of one of the source tiles
+gdal raster overview refresh \-\-external \-r cubic \e
+                          \-\-use\-source\-timestamp my.vrt     # refresh overviews
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Refresh (internal) overviews of a TIFF file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster mosaic tile1.tif tile2.tif mosaic.tif       # create mosaic
+gdal raster overview add \-r cubic mosaic.tif            # initial overview generation
+gdalwarp tile1_modif.tif mosaic.tif                     # update mosaic
+gdal raster overview refresh \-\-like=tile1.tif my.tif    # refresh overviews
+.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-pansharpen.1

@@ -0,0 +1,266 @@
+.\" 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-PANSHARPEN" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-pansharpen \- Perform a pansharpen operation
+.sp
+Added in version 3.12.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster pansharpen [OPTIONS] <INPUT> <SPECTRAL>... <OUTPUT>
+
+Perform a pansharpen operation.
+
+Positional arguments:
+  \-i, \-\-panchromatic, \-\-input <INPUT>                      Input panchromatic raster dataset [required] [not available in pipelines]
+  \-\-spectral <SPECTRAL>                                    Input spectral band dataset [1.. values] [required]
+  \-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
+  \-r, \-\-resampling <RESAMPLING>                            Resampling algorithm. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (default: cubic)
+  \-\-weights <WEIGHTS>                                      Weight for each input spectral band [may be repeated]
+  \-\-nodata <NODATA>                                        Override nodata value of input bands
+  \-\-bit\-depth <BIT\-DEPTH>                                  Override bit depth of input bands
+  \-\-spatial\-extent\-adjustment <SPATIAL\-EXTENT\-ADJUSTMENT>  Select behavior when bands have not the same extent. SPATIAL\-EXTENT\-ADJUSTMENT=union|intersection|none|none\-without\-warning (default: union)
+  \-j, \-\-num\-threads <NUM\-THREADS>                          Number of jobs (or ALL_CPUS) (default: ALL_CPUS)
+
+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 pansharpen\fP performs a pan\-sharpening operation. It
+can create a \(dqclassic\(dq output dataset (such as GeoTIFF), or a VRT
+dataset describing the pan\-sharpening operation.
+.sp
+It takes as input a one\-band panchromatic dataset and several spectral bands,
+generally at a lower resolution than the panchromatic band. The output is
+a multi\-band dataset (with as many bands as input panchromatic bands), enhanced
+at the resolution of the panchromatic band.
+.sp
+All bands should be in the same coordinate reference system.
+.sp
+More details can be found in the \fI\%Pansharpened VRT\fP section.
+.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 \-\-bit\-depth <val>
+Specify the bit depth of the panchromatic and spectral bands (e.g.
+12). If not specified, the NBITS metadata item from the panchromatic
+band will be used if it exists.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i, \-\-panchromatic, \-\-input <INPUT>
+Dataset with panchromatic band. [required]
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-j, \-\-num\-threads <value>
+Specify number of threads to use to do the resampling and
+pan\-sharpening itself. Can be an integer number or \fBALL_CPUS\fP (the default)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-nodata <val>
+Specify nodata value for bands. Used for the resampling and
+pan\-sharpening computation itself. If not set, deduced from the
+input bands, provided they have a consistent setting.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r, \-\-resampling nearest|bilinear|cubic|cubicspline|lanczos|average
+Select a resampling algorithm. \fBcubic\fP is the default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-spatial\-extent\-adjustment union|intersection|none|none\-without\-warning
+Select behavior when bands have not the same extent. See
+\fISpatialExtentAdjustment\fP documentation in \fI\%Pansharpened VRT\fP
+\fBunion\fP is the default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-spectral <spectral_dataset>[,band=<num>]
+Dataset with one or several spectral bands. [required]
+.sp
+If the band option is not specified, all bands of the dataset are taken
+into account.
+Otherwise, only the specified (num)th band. The same dataset can be
+repeated several times.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-weights <WEIGHTS>
+Specify a weight for the computation of the pseudo panchromatic
+value. There must be as many values as input spectral bands.
+.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: With spectral bands in a single dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pansharpen panchro.tif rgb.tif pansharpened_out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: With a few spectral bands from a single dataset, reordered
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pansharpen panchro.tif bgr.tif,band=3 bgr.tif,band=2 bgr.tif,band=1 pansharpened_out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: With spectral bands in several datasets
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pansharpen panchro.tif red.tif green.tif blue.tif pansharpened_out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Specifying weights
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pansharpen \-w 0.7,0.2,0.1 panchro.tif multispectral.tif pansharpened_out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 5: Select RGB bands from a RGBNir multispectral dataset while computing the pseudo panchromatic intensity on the 4 RGBNir bands
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster pipeline read panchro.tif ! pansharpen rgbnir.tif ! select 1,2,3 ! write pansharpened_out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.