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

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

@@ -0,0 +1,467 @@
+'\" 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-VIEWSHED" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-viewshed \- Compute the viewshed of a raster dataset.
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster viewshed [OPTIONS] <INPUT> <OUTPUT>
+
+Compute the viewshed of 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
+  \-p, \-\-pos, \-\-position <X,Y> or <X,Y,H>               Observer position [2..3 values]
+  \-z, \-\-height <HEIGHT>                                Observer height
+  \-\-sd\-filename <SD\-FILENAME>                          Filename of standard\-deviation raster
+  \-\-target\-height <TARGET\-HEIGHT>                      Height of the target above the DEM surface in the height unit of the DEM. (default: 0)
+  \-\-mode <MODE>                                        Sets what information the output contains.. MODE=normal|DEM|ground|cumulative (default: normal)
+  \-\-max\-distance <MAX\-DISTANCE>                        Maximum distance from observer to compute visibility. It is also used to clamp the extent of the output raster.
+  \-\-min\-distance <MIN\-DISTANCE>                        Mask all cells less than this distance from the observer. Must be less than \(aqmax\-distance\(aq.
+  \-\-start\-angle <START\-ANGLE>                          Mask all cells outside of the arc (\(aqstart\-angle\(aq, \(aqend\-angle\(aq). Clockwise degrees from north. Also used to clamp the extent of the output raster.
+  \-\-end\-angle <END\-ANGLE>                              Mask all cells outside of the arc (\(aqstart\-angle\(aq, \(aqend\-angle\(aq). Clockwise degrees from north. Also used to clamp the extent of the output raster.
+  \-\-high\-pitch <HIGH\-PITCH>                            Mark all cells out\-of\-range where the observable height would be higher than the \(aqhigh\-pitch\(aq angle from the observer. Degrees from horizontal \- positive is up. Must be greater than \(aqlow\-pitch\(aq.
+  \-\-low\-pitch <LOW\-PITCH>                              Bound observable height to be no lower than the \(aqlow\-pitch\(aq angle from the observer. Degrees from horizontal \- positive is up. Must be less than \(aqhigh\-pitch\(aq.
+  \-\-curvature\-coefficient <CURVATURE\-COEFFICIENT>      Coefficient to consider the effect of the curvature and refraction.
+  \-b, \-\-band <BAND>                                    Input band (1\-based index) (default: 1)
+  \-\-visible\-value <VISIBLE\-VALUE>                      Pixel value to set for visible areas (default: 255)
+  \-\-invisible\-value <INVISIBLE\-VALUE>                  Pixel value to set for invisible areas (default: 0)
+  \-\-maybe\-visible\-value <MAYBE\-VISIBLE\-VALUE>          Pixel value to set for potentially visible areas (default: 2)
+  \-\-out\-of\-range\-value <OUT\-OF\-RANGE\-VALUE>            Pixel value to set for the cells that fall outside of the range specified by the observer location and the maximum distance (default: 0)
+  \-\-output\-nodata <OUTPUT\-NODATA>                      The value to be set for the cells in the output raster that have no data.
+  \-\-observer\-spacing <OBSERVER\-SPACING>                Cell Spacing between observers (default: 10)
+  \-j, \-\-num\-threads <NUM\-THREADS>                      Number of jobs (or ALL_CPUS) (default: 3)
+
+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 viewshed\fP creates a binary visibility raster from one band
+of the input raster elevation model (DEM). The output raster will be of type
+Byte. Using the \fBDEM\fP or \fBground\fP values of \fI\%\-\-mode\fP can also
+create a minimum visible height raster of type Float64.
+.sp
+It uses the method defined in \fI\%[Wang2000]\fP for a user defined point.
+.sp
+This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
+(since GDAL 3.12)
+.sp
+Added in version 3.12.
+
+.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.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+However this algorithm is not natively streaming compatible. Consequently a
+temporary dataset will be generated, which may cause significant processing
+time at opening.
+.UNINDENT
+.UNINDENT
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-b, \-\-band <band>
+Select an input band containing the DEM data. Bands are numbered from 1.
+Only a single band can be used. Only the part of the raster within the specified
+maximum distance around the observer point is processed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-curvature\-coefficient <value>
+Coefficient to consider the effect of the curvature and refraction.
+When calculating visibility between two points (i.e. Line Of Sight or Viewshed),
+The magnitude of this effect varies with atmospheric conditions and depends on the wavelength.
+.sp
+Different applications for calculating visibility use different interchangeable notation to describe this phenomena:
+Refraction Coefficient, Curvature Coefficient, and Sphere Diameter Factor.
+gdal_viewshed uses the Curvature Coefficient notation.
+.sp
+.ce
+{CurvCoeff}=1\-{RefractionCoeff}
+.ce 0
+.sp
+Changes in air density curve the light downward causing an observer to see further and the earth to appear less curved,
+as if the sphere (earth) diameter is larger then it actually is.
+The ratio between that imaginary sphere diameter and the actual sphere diameter is given by the formula:
+.sp
+.ce
+{SphereDiameterFactor}=1/{CurvCoeff}=1/(1\-{RefractionCoeff})
+
+
+.ce 0
+.sp
+For visible light, the standard atmospheric refraction coefficient that is generally used is 1/7.
+Thus the default value (since GDAL 3.4) for CurvCoeff that gdal_viewshed uses is 0.85714 (=~ 1\-1/7)
+for Earth CRS. Starting with GDAL 3.6, for non\-Earth CRS (those whole semi\-major axis differs
+by more than 5% with the one of WGS 84), CurvCoeff default value is 1.0, to account for
+the no refraction use case.
+.sp
+The height of the DEM is corrected according to the following formula:
+.sp
+.ce
+Height_{Corrected}=Height_{DEM}\-{CurvCoeff}\efrac{{TargetDistance}^2}{SphereDiameter}
+.ce 0
+.sp
+Typical coefficient values are given in the table below (use Curvature Coeff value for the cc option)
+.TS
+box center;
+l|l|l|l.
+T{
+Use Case
+T}	T{
+Refraction Coeff
+T}	T{
+\fBCurvature Coeff\fP
+T}	T{
+Sphere Diameter Factor
+T}
+_
+T{
+No Refraction
+T}	T{
+0
+T}	T{
+1
+T}	T{
+1
+T}
+_
+T{
+Visible Light
+T}	T{
+1/7
+T}	T{
+6/7 (=~0.85714)
+T}	T{
+7/6 (=~1.1666)
+T}
+_
+T{
+Radio Waves
+T}	T{
+0.25 ~ 0.325
+T}	T{
+0.75 ~ 0.675
+T}	T{
+1.33 ~ 1.48
+T}
+_
+T{
+Flat Earth
+T}	T{
+1
+T}	T{
+0
+T}	T{
+inf
+T}
+.TE
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-end\-angle <value>
+Added in version 3.12.
+
+.sp
+End angle for visibility. Measured clockwise from 0 North, in degree.
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-z, \-\-height <HEIGHT>
+Observer height
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-high\-pitch <value>
+Added in version 3.12.
+
+.sp
+High angle for visibility. Measured up from 0 horizontal, in degree.
+Input values above the high pitch are marked out of range.
+Must be greater than \(aq\-\-low\-pitch\(aq.
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-invisible\-value <value>
+Pixel value to set for invisible areas. (Not supported in cumulative mode) Default: 0
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-low\-pitch <value>
+Added in version 3.12.
+
+.sp
+Low angle for visibility. Measured up from 0 horizontal, in degree.
+Input cell values below the pitch are are clamped to be no lower
+than the intersection of the angle.  Must be less than \(aq\-\-high\-pitch\(aq.
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-max\-distance <value>
+Maximum distance from observer to compute visibility.
+It is also used to clamp the extent of the output raster.
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-min\-distance <value>
+Added in version 3.12.
+
+.sp
+Minimum distance from observer to compute visibility.
+Must be less than \(aq\-\-max\-distance\(aq
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-mode normal|DEM|ground|cumulative
+Sets what information the output contains.
+.INDENT 7.0
+.IP \(bu 2
+\fBnormal\fP (the default) returns a raster of type Byte containing visible locations.
+.IP \(bu 2
+\fBDEM\fP and \fBground\fP return a raster of type Float64 containing the minimum target
+height for the target to be visible from the DEM surface or ground level respectively.
+That is to say, if the minimum target height for the target to be visible at a
+point is \fBh\fP and the value of the input raster at that point is \fBE\fP,
+for \fBDEM\fP, \fBE + h\fP will be the output value.
+For \fBground\fP, \fBh\fP will be output value.
+Options \fB\-\-target\-height\fP, \fB\-\-invisible\-value\fP and \fB\-\-visible\-value\fP will
+be ignored.
+.IP \(bu 2
+\fBcumulative\fP creates an eight bit raster the same size as the input raster
+where each cell represents the relative observability from a grid of observer points.
+See the \fI\%\-\-observer\-spacing\fP option.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-j, \-\-num\-threads <value>
+Number of jobs to run at once. (only supported in cumulative mode).
+Default: 3
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-observer\-spacing <value>
+Cell spacing between observers (only supported in cumulative mode).
+Default: 10
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-out\-of\-range\-value <value>
+Pixel value to set for the cells that fall outside of the range specified by
+the observer location and the maximum distance. (Not supported in cumulative mode) Default: 0
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-nodata <value>
+The value to be set for the cells in the output raster that have no data.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+Currently, no special processing of input cells at a nodata
+value is done (which may result in erroneous results).
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-p, \-\-pos, \-\-position <X,Y> or <X,Y,H>
+The X,Y or X,Y,H(Height) position of the observer (in SRS units for X and Y,
+and in the height unit of the DEM for H).
+If the coordinate is outside of the raster, all space between the observer
+and the raster is assumed not to occlude visibility of the raster. (Not supported in cumulative mode.)
+If H is not specified, it defaults to 2.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-start\-angle <value>
+Added in version 3.12.
+
+.sp
+Start angle for visibility. Measured clockwise from 0 North, in degree.
+(Not supported in cumulative mode)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-target\-height <value>
+The height of the target above the DEM surface in the height unit of the DEM. Default: 0
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-visible\-value <value>
+.INDENT 7.0
+.INDENT 3.5
+Pixel value to set for visible areas. (Not supported in cumulative mode) Default: 255
+.UNINDENT
+.UNINDENT
+.sp
+Added in version 3.13.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-sd\-filename <value>
+Filename of raster containing standard deviations of the input raster values. The raster
+always comes from band 1 and the size must match that of the input raster.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-maybe\-visible\-value <value>
+Pixel value to set for visible areas. (Not supported in cumulative mode) Default: 255
+.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
+.sp
+Screenshot of 2 combined viewshed analysis, with the yellow pixels showing the area that is
+visible from the both observation locations (the green dots), while the small green area is
+only visible from one location.
+.INDENT 0.0
+.INDENT 2.5
+[image]
+.UNINDENT
+.UNINDENT
+.sp
+Create a viewshed raster with a radius of 500 for a person standing at location (\-10147017, 5108065).
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster viewshed \-\-max\-distance=500 \-\-pos=\-10147017,5108065 source.tif destination.tif
+.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-write.1

@@ -0,0 +1,121 @@
+.\" 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-WRITE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-write \- Write a raster dataset (pipeline only)
+.sp
+Added in version 3.11.
+
+.SH DESCRIPTION
+.sp
+The \fBwrite\fP operation is for use in a \fI\%gdal pipeline\fP only, and writes a
+raster dataset. This is the last step of a pipeline.
+.sp
+To write a temporary dataset in the middle of a pipeline, use \fI\%gdal raster materialize\fP\&.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+* write [OPTIONS] <OUTPUT>
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+
+Write a raster dataset.
+
+Positional arguments:
+  \-o, \-\-output <OUTPUT>                                Output raster dataset [required]
+
+Options:
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format (\(dqGDALG\(dq allowed)
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed
+                                                       Mutually exclusive with \-\-append
+  \-\-append                                             Append as a subdataset to existing output
+                                                       Mutually exclusive with \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH STANDARD OPTIONS
+.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 \-\-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 \-\-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
+.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
+.SH EXAMPLES
+.SS Example 1: Write a GeoTIFF file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster pipeline ... [other commands here] ... ! write out.tif \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.