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

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-mdim-convert.1

@@ -0,0 +1,302 @@
+.\" 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-MDIM-CONVERT" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-mdim-convert \- Convert a multidimensional dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal mdim convert [OPTIONS] <INPUT> <OUTPUT>
+
+Convert a multidimensional dataset.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input raster or multidimensional raster dataset [required]
+  \-o, \-\-output <OUTPUT>                                Output multidimensional raster dataset (created by algorithm) [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
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed
+  \-\-array <ARRAY\-SPEC>                                 Select a single array instead of converting the whole dataset. [may be repeated]
+  \-\-array\-option <KEY>=<VALUE>                         Option passed to GDALGroup::GetMDArrayNames() to filter arrays. [may be repeated]
+  \-\-group <GROUP\-SPEC>                                 Select a single group instead of converting the whole dataset. [may be repeated]
+  \-\-subset <SUBSET\-SPEC>                               Select a subset of the data. [may be repeated]
+  \-\-scale\-axes <SCALEAXES\-SPEC>                        Applies a integral scale factor to one or several dimensions [may be repeated]
+  \-\-strict                                             Turn warnings into failures.
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    Open options [may be repeated]
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  Input formats [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal mdim convert\fP can be used to convert multidimensional data between
+different formats.
+.sp
+The following options are available:
+.SS Standard options
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Select the output format. This can be a format that supports multidimensional
+output (such as \fI\%NetCDF: Network Common Data Form\fP, \fI\%Multidimensional VRT\fP), or a \(dqclassic\(dq 2D formats, if only one single 2D array
+results of the other specified conversion operations. When this option is
+not specified, the format is guessed when possible from the extension of the
+destination filename.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-co, \-\-creation\-option <KEY>=<VALUE>
+Many formats have one or more optional creation options that can be
+used to control particulars about the file created.
+.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\%\-\-format\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.
+.sp
+Array\-level creation options may be passed by prefixing them with \fBARRAY:\fP\&.
+See \fI\%GDALGroup::CopyFrom()\fP for further details regarding such options.
+.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 \-\-array <array_spec>
+Instead of converting the whole dataset, select one array, and possibly
+perform operations on it. This option can be specified several times to
+operate on different arrays.
+.sp
+<array_spec> may be just an array name, potentially using a fully qualified
+syntax (/group/subgroup/array_name). Or it can be a combination of options
+with the syntax:
+name={src_array_name}[,dstname={dst_array_name}][,resample=yes][,transpose=[{axis1},{axis2},...][,view={view_expr}]
+.sp
+The following options are processed in that order:
+.INDENT 7.0
+.IP \(bu 2
+\fBresample=yes\fP asks for the array to run through \fI\%GDALMDArray::GetResampled()\fP\&.
+.IP \(bu 2
+.INDENT 2.0
+.TP
+.B [{axis1},{axis2},...] is the argument of  \fI\%GDALMDArray::Transpose()\fP\&.
+For example, transpose=[1,0] switches the axis order of a 2D array.
+See \fI\%Example 6\fP\&.
+.UNINDENT
+.IP \(bu 2
+{view_expr} is the value of the \fIviewExpr\fP argument of \fI\%GDALMDArray::GetView()\fP\&.
+See \fI\%Example 5\fP\&.
+.UNINDENT
+.sp
+When specifying a view_expr that performs a slicing or subsetting on a dimension, the
+equivalent operation will be applied to the corresponding indexing variable.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-array\-option <NAME>=<VALUE>
+Option passed to \fI\%GDALGroup::GetMDArrayNames()\fP to filter reported
+arrays. Such option is format specific. Consult driver documentation.
+This option may be used several times.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-group <group_spec>
+Instead of converting the whole dataset, select one group, and possibly
+perform operations on it. This option can be specified several times to
+operate on different groups. If only one group is specified, its content will be
+copied directly to the target root group. If several ones are specified,
+they are copied under the target root group
+.sp
+<group_spec> may be just a group name, potentially using a fully qualified
+syntax (/group/subgroup/subsubgroup_name). Or it can be a combination of options
+with the syntax:
+\fBname={src_group_name}[,dstname={dst_group_name}][,recursive=no]\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-subset <subset_spec>
+Performs a subsetting (trimming or slicing) operation along a dimension,
+provided that it is indexed by a 1D variable of numeric or string data type,
+and whose values are monotonically sorted.
+<subset_spec> follows exactly the \X'tty: link https://portal.opengeospatial.org/files/09-147r3'\fI\%OGC WCS 2.0 KVP encoding\fP\X'tty: link'
+for subsetting.
+.sp
+That is \fBdim_name(min_val,max_val)\fP or \fBdim_name(sliced_val)\fP
+The first syntax will subset the dimension \fBdim_name\fP to values in the
+[min_val,max_val] range. The second syntax will slice the dimension dim_name
+to value sliced_val (and this dimension will be removed from the arrays
+that reference to it)
+.sp
+Beware that dimension name is case sensitive.
+.sp
+Several subsetting operations along different dimensions can be specified by repeating the option.
+.sp
+Using \-\-subset is incompatible with specifying a \fIview\fP option in \-\-array.
+.sp
+See \fI\%Example 2\fP or \fI\%Example 3\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-scale\-axes <scaleaxes_spec>
+Applies a integral scale factor to one or several dimensions, that is
+extract 1 value every N values (without resampling).
+.sp
+<scaleaxes_spec> follows exactly the syntax of the KVP encoding of the
+SCALEAXES parameter of
+\X'tty: link https://portal.opengeospatial.org/files/12-039'\fI\%OGC WCS 2.0 Scaling Extension\fP\X'tty: link',
+but limited to integer scale factors.
+.sp
+That is \fB<dim1_name>(<scale_factor>)\fP\&.
+.sp
+Several scaling operations along different dimensions can be specified by repeating the option.
+.sp
+Using \-\-scale\-axes is incompatible with specifying a \fIview\fP option in \-\-array.
+.sp
+See \fI\%Example 4\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-strict
+By default, some failures during the translation are tolerated, such as not
+being able to write group attributes. When setting this option, such
+failures will cause the process to fail.
+.UNINDENT
+.SS Advanced options
+.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 \-\-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
+.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: Convert a netCDF file to a multidimensional VRT file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert in.nc out.vrt
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Extract a 2D slice of a time,Y,X array
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert in.nc out.tif \-\-subset \(dqtime(\e\(dq2010\-01\-01\e\(dq)\(dq \-\-array temperature
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Extract a a 3D chunk from a time\-indexed GRIB file into a multiband GeoTIFF.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert /vsicurl/https://tgftp.nws.noaa.gov/SL.us008001/ST.opnl/DF.gr2/DC.ndfd/AR.conus/VP.001\-003/ds.qpf.bin tst.tif \-\-subset \(dqTIME(1763164800,1763251200)\(dq \-\-array QPF_0\-SFC \-\-co COMPRESS=DEFLATE
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Subsample along x and y axis
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert in.nc out.nc \-\-scale\-axes \(dqx(2),y(2)\(dq
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 5: Reorder the values of an array
+.sp
+Reorder the values of the time,Y,X array along the Y axis from top\-to\-bottom
+to bottom\-to\-top (or the reverse)
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert in.nc out.nc \-\-array \(dqname=temperature,view=[:,::\-1,:]\(dq
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 6: Transpose an array that has X,Y,time dimension order to time,Y,X
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal mdim convert in.nc out.nc \-\-array \(dqname=temperature,transpose=[2,1,0]\(dq
+.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-mdim-info.1

@@ -0,0 +1,312 @@
+.\" 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-MDIM-INFO" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-mdim-info \- Get information on a multidimensional dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal mdim info [OPTIONS] <INPUT>
+
+Return information on a multidimensional dataset.
+
+Positional arguments:
+  \-i, \-\-dataset, \-\-input <INPUT>       Input multidimensional raster dataset [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]
+
+Options:
+  \-\-summary                            Report only group and array hierarchy, without detailed information on attributes or dimensions.
+                                       Mutually exclusive with \-\-detailed
+  \-\-detailed                           Most verbose output. Report attribute data types and array values.
+                                       Mutually exclusive with \-\-summary
+  \-\-array <ARRAY>                      Name of the array, used to restrict the output to the specified array.
+  \-\-limit <LIMIT>                      Number of values in each dimension that is used to limit the display of array values.
+  \-\-array\-option <KEY>=<VALUE>         Option passed to GDALGroup::GetMDArrayNames() to filter reported arrays. [may be repeated]
+  \-\-stats                              Read and display image statistics.
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>    Open options [may be repeated]
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>  Input formats [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal mdim info\fP lists various information about a GDAL supported
+multidimensional dataset, and returns them on the standard output stream when used from the
+command line, or in the \fBoutput\fP parameter when used from the API.
+.sp
+The following items will be reported (when known) as JSON:
+.INDENT 0.0
+.IP \(bu 2
+The format driver used to access the file.
+.IP \(bu 2
+Hierarchy of groups
+.IP \(bu 2
+Group attributes
+.IP \(bu 2
+.INDENT 2.0
+.TP
+.B Arrays:
+.INDENT 7.0
+.IP \(bu 2
+Name
+.IP \(bu 2
+Dimension name, sizes, indexing variable
+.IP \(bu 2
+Data type
+.IP \(bu 2
+Attributes
+.IP \(bu 2
+SRS
+.IP \(bu 2
+Nodata value
+.IP \(bu 2
+Units
+.IP \(bu 2
+Statistics (if requested)
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+The following options are available:
+.SS Standard options
+.INDENT 0.0
+.TP
+.B \-\-summary
+Added in version 3.13.
+
+.sp
+Report only group and array hierarchy, without detailed information on attributes or dimensions.
+Mutually exclusive with \fI\%\-\-detailed\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-detailed
+Most verbose output. Report attribute data types and array values.
+Mutually exclusive with \fI\%\-\-summary\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-array <array_name>
+Name of the array used to restrict the output to the specified array.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+Bash completion for \fI\%\-\-array\fP is possible if the dataset name
+is specified before.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-limit <number>
+Number of values in each dimension that is used to limit the display of
+array values. By default, unlimited. Only taken into account if used with
+\-detailed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-array\-option <NAME>=<VALUE>
+Option passed to \fI\%GDALGroup::GetMDArrayNames()\fP to filter reported
+arrays. Such option is format specific. Consult driver documentation.
+This option may be used several times.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+Bash completion for \fI\%\-\-array\-option\fP is possible if the dataset name
+is specified before.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-stats
+Read and display array statistics. Force computation if no
+statistics are stored in an array.
+.UNINDENT
+.SS Advanced options
+.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 \-\-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
+.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: Getting information on the file netcdf\-4d.nc as JSON output
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal mdim info netcdf\-4d.nc
+.EE
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+{
+  \(dqtype\(dq: \(dqgroup\(dq,
+  \(dqname\(dq: \(dq/\(dq,
+  \(dqattributes\(dq: {
+    \(dqConventions\(dq: \(dqCF\-1.5\(dq
+  },
+  \(dqdimensions\(dq: [
+    {
+      \(dqname\(dq: \(dqlevelist\(dq,
+      \(dqfull_name\(dq: \(dq/levelist\(dq,
+      \(dqsize\(dq: 2,
+      \(dqtype\(dq: \(dqVERTICAL\(dq,
+      \(dqindexing_variable\(dq: \(dq/levelist\(dq
+    },
+    {
+      \(dqname\(dq: \(dqlongitude\(dq,
+      \(dqfull_name\(dq: \(dq/longitude\(dq,
+      \(dqsize\(dq: 10,
+      \(dqtype\(dq: \(dqHORIZONTAL_X\(dq,
+      \(dqdirection\(dq: \(dqEAST\(dq,
+      \(dqindexing_variable\(dq: \(dq/longitude\(dq
+    },
+    {
+      \(dqname\(dq: \(dqlatitude\(dq,
+      \(dqfull_name\(dq: \(dq/latitude\(dq,
+      \(dqsize\(dq: 10,
+      \(dqtype\(dq: \(dqHORIZONTAL_Y\(dq,
+      \(dqdirection\(dq: \(dqNORTH\(dq,
+      \(dqindexing_variable\(dq: \(dq/latitude\(dq
+    },
+    {
+      \(dqname\(dq: \(dqtime\(dq,
+      \(dqfull_name\(dq: \(dq/time\(dq,
+        \(dqsize\(dq: 4,
+      \(dqtype\(dq: \(dqTEMPORAL\(dq,
+      \(dqindexing_variable\(dq: \(dq/time\(dq
+      }
+  ],
+  \(dqarrays\(dq: {
+    \(dqlevelist\(dq: {
+      \(dqdatatype\(dq: \(dqInt32\(dq,
+      \(dqdimensions\(dq: [
+          \(dq/levelist\(dq
+        ],
+      \(dqattributes\(dq: {
+        \(dqlong_name\(dq: \(dqpressure_level\(dq
+      },
+      \(dqunit\(dq: \(dqmillibars\(dq
+    },
+    \(dqlongitude\(dq: {
+      \(dqdatatype\(dq: \(dqFloat32\(dq,
+      \(dqdimensions\(dq: [
+        \(dq/longitude\(dq
+      ],
+      \(dqattributes\(dq: {
+        \(dqstandard_name\(dq: \(dqlongitude\(dq,
+        \(dqlong_name\(dq: \(dqlongitude\(dq,
+        \(dqaxis\(dq: \(dqX\(dq
+      },
+      \(dqunit\(dq: \(dqdegrees_east\(dq
+    },
+    \(dqlatitude\(dq: {
+      \(dqdatatype\(dq: \(dqFloat32\(dq,
+      \(dqdimensions\(dq: [
+        \(dq/latitude\(dq
+      ],
+      \(dqattributes\(dq: {
+        \(dqstandard_name\(dq: \(dqlatitude\(dq,
+        \(dqlong_name\(dq: \(dqlatitude\(dq,
+        \(dqaxis\(dq: \(dqY\(dq
+      },
+      \(dqunit\(dq: \(dqdegrees_north\(dq
+    },
+    \(dqtime\(dq: {
+      \(dqdatatype\(dq: \(dqFloat64\(dq,
+      \(dqdimensions\(dq: [
+        \(dq/time\(dq
+      ],
+      \(dqattributes\(dq: {
+        \(dqstandard_name\(dq: \(dqtime\(dq,
+        \(dqcalendar\(dq: \(dqstandard\(dq
+      },
+      \(dqunit\(dq: \(dqhours since 1900\-01\-01 00:00:00\(dq
+    },
+    \(dqt\(dq: {
+      \(dqdatatype\(dq: \(dqInt32\(dq,
+      \(dqdimensions\(dq: [
+        \(dq/time\(dq,
+        \(dq/levelist\(dq,
+        \(dq/latitude\(dq,
+        \(dq/longitude\(dq
+      ],
+      \(dqnodata_value\(dq: \-32767
+    }
+  },
+  \(dqstructural_info\(dq: {
+    \(dqNC_FORMAT\(dq: \(dqCLASSIC\(dq
+  }
+}
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.