The BEAM Graph Processing Tool (gpt)
Usage:
gpt <op>|<graph-file> [options] [<source-file-1> <source-file-2> ...]
Description:
This tool is used to execute BEAM raster data operators in batch-mode. The
operators can be used stand-alone or combined as a directed acyclic graph
(DAG). Processing graphs are represented using XML. More info about
processing graphs, the operator API, and the graph XML format can be found
in the BEAM documentation.
Arguments:
<op> Name of an operator. See below for the list of <op>s.
<graph-file> Operator graph file (XML format).
<source-file-i> The <i>th source product file. The actual number of source
file arguments is specified by <op>. May be optional for
operators which use the -S option.
Options:
-h Displays command usage. If <op> is given, the specific
operator usage is displayed.
-e Displays more detailed error messages. Displays a stack
trace, if an exception occurs.
-t <file> The target file. Default value is './target.dim'.
-f <format> Output file format, e.g. 'GeoTIFF', 'HDF5',
'BEAM-DIMAP'. If not specified, format will be derived
from the target filename extension, if any, otherwise the
default format is 'BEAM-DIMAP'. Ony used, if the graph
in <graph-file> does not specify its own 'Write' operator.
-p <file> A (Java Properties) file containing processing
parameters in the form <name>=<value> or a XML file
containing a a parameter DOM for the operator. Entries in this
file are overwritten by the -P<name>=<value> command-line
option (see below). The following variables are substituted in
the parameters file:
${gpt.operator} (given by the 'op' argument)
${gpt.graphFile} (given by the 'graph-file' argument)
${gpt.parametersFile} (given by the -p option)
${gpt.targetFile} (given by the -t option)
${gpt.targetFormat} (given by the -f option)
-c <cache-size> Sets the tile cache size in bytes. Value can be suffixed
with 'K', 'M' and 'G'. Must be less than maximum
available heap space. If equal to or less than zero, tile
caching will be completely disabled. The default tile
cache size is '512M'.
-q <parallelism> Sets the maximum parallelism used for the computation, i.e.
the maximum number of parallel (native) threads.
The default parallelism is '8'.
-x Clears the internal tile cache after writing a complete
row of tiles to the target product file. This option may
be useful if you run into memory problems.
-T<target>=<file> Defines a target product. Valid for graphs only. <target>
must be the identifier of a node in the graph. The node's
output will be written to <file>.
-S<source>=<file> Defines a source product. <source> is specified by the
operator or the graph. In an XML graph, all occurrences of
${<source>} will be replaced with references to a source
product located at <file>.
-P<name>=<value> Defines a processing parameter, <name> is specific for the
used operator or graph. In an XML graph, all occurrences of
${<name>} will be replaced with <value>. Overwrites
parameter values specified by the '-p' option.
Operators:
BandMaths Create a product with one or more bands using mathematical expressions.
Collocate Collocates two products based on their geo-codings.
EMClusterAnalysis Performs an expectation-maximization (EM) cluster analysis.
KMeansClusterAnalysis Performs a K-Means cluster analysis.
Meris.CorrectRadiometry Performs radiometric corrections on MERIS L1b data products.
Mosaic Creates a mosaic out of a set of source products.
N1Patcher No description available.
PixEx Generates a CSV file from a given pixel location and source products.
Read Reads a product from disk.
Reproject Reprojection of a source product to a target Coordinate Reference System.
Subset Create a spatial and/or spectral subset of data product.
Unmix Performs a linear spectral unmixing.
Write Writes a data product to a file.