t.rast3d.extract
Extracts a subset of a space time 3D raster dataset.
t.rast3d.extract [-n] input=name [where=sql_query] [expression=string] output=name [basename=string] [suffix=string] [nprocs=integer] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]
Example:
t.rast3d.extract input=name output=name
grass.script.run_command("t.rast3d.extract", input, where=None, expression=None, output, basename=None, suffix="gran", nprocs=1, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("t.rast3d.extract", input="name", output="name")
Parameters
input=name [required]
Name of the input space time raster3d dataset
where=sql_query
WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
Example: start_time > '2001-01-01 12:30:00'
expression=string
The r3.mapcalc expression assigned to all extracted 3D raster maps
output=name [required]
Name of the output space time raster3d dataset
basename=string
Basename of the new generated 3D raster maps
suffix=string
Suffix to add at basename: set 'gran' for granularity, 'time' for the full time format, 'num' for numerical suffix with a specific number of digits (default %05)
Default: gran
nprocs=integer
Number of r3.mapcalc processes to run in parallel
Default: 1
-n
Register Null maps
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
input : str, required
Name of the input space time raster3d dataset
Used as: input, str3ds, name
where : str, optional
WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
Example: start_time > '2001-01-01 12:30:00'
Used as: sql_query
expression : str, optional
The r3.mapcalc expression assigned to all extracted 3D raster maps
output : str, required
Name of the output space time raster3d dataset
Used as: output, str3ds, name
basename : str, optional
Basename of the new generated 3D raster maps
suffix : str, optional
Suffix to add at basename: set 'gran' for granularity, 'time' for the full time format, 'num' for numerical suffix with a specific number of digits (default %05)
Default: gran
nprocs : int, optional
Number of r3.mapcalc processes to run in parallel
Default: 1
flags : str, optional
Allowed values: n
n
Register Null maps
overwrite: bool, optional
Allow output files to overwrite existing files
Default: False
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
t.rast3d.extract is used to extract a subset of a space time 3D raster dataset and to store that subset in a different space time 3D raster dataset. It has exactly the same functionality as t.rast.extract. The only difference is the that this module works on STR3DS and 3D raster maps.
Please refer to t.rast.extract for documentation and examples.
SEE ALSO
t.rast.extract, t.create, t.info
AUTHOR
Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
SOURCE CODE
Available at: t.rast3d.extract source code
(history)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f