Skip to content

t.rast.out.vtk

Exports space time raster dataset as VTK time series.

t.rast.out.vtk [-pcg] input=name directory=string [elevation=name] [where=sql_query] [null=float] [--verbose] [--quiet] [--qq] [--ui]

Example:

t.rast.out.vtk input=name directory=string

grass.script.parse_command("t.rast.out.vtk", input, directory, elevation=None, where=None, null=-99999.99, flags=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.parse_command("t.rast.out.vtk", input="name", directory="string")

Parameters

input=name [required]
    Name of the input space time raster dataset
directory=string [required]
    Path to the export directory
elevation=name
    Name of input elevation raster map
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'
null=float
    Value to represent no data cell
    Default: -99999.99
-p
    Create VTK point data instead of VTK cell data (if no elevation map is given)
-c
    Correct the coordinates to fit the VTK-OpenGL precision
-g
    Export files using the space time dataset granularity for equidistant time between maps, where statement will be ignored
--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 raster dataset
    Used as: input, strds, name
directory : str, required
    Path to the export directory
elevation : str, optional
    Name of input elevation raster map
    Used as: input, raster, 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
null : float, optional
    Value to represent no data cell
    Default: -99999.99
flags : str, optional
    Allowed values: p, c, g
    p
        Create VTK point data instead of VTK cell data (if no elevation map is given)
    c
        Correct the coordinates to fit the VTK-OpenGL precision
    g
        Export files using the space time dataset granularity for equidistant time between maps, where statement will be ignored
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.rast.out.vtk exports all maps registered in a space time raster datasets as VTK legacy files using a numerical numbering scheme. The VTK files can be visualized with any VTK based visualize. Our preferred tool is ParaView. The VTK legacy files are created using r.out.vtk.

EXAMPLE

In this simple example we create several raster maps with random values and one elevation map. The random value raster maps are registered in a space time raster dataset. All maps of this space time raster dataset are exported using t.rast.out.vtk into the directory /tmp/export.

mkdir /tmp/export
t.rast.out.vtk input=precip_abs directory=/tmp/export/ elevation=elevation

ls -1 /tmp/export
000000_tempmean_monthly.vtk
000001_tempmean_monthly.vtk
000002_tempmean_monthly.vtk
000003_tempmean_monthly.vtk
000004_tempmean_monthly.vtk
000005_tempmean_monthly.vtk
000006_tempmean_monthly.vtk
000007_tempmean_monthly.vtk
000008_tempmean_monthly.vtk
000009_tempmean_monthly.vtk
000010_tempmean_monthly.vtk
000011_tempmean_monthly.vtk

SEE ALSO

r.out.vtk, ParaView

AUTHOR

Sören Gebbert, Thünen Institute of Climate-Smart Agriculture

SOURCE CODE

Available at: t.rast.out.vtk source code (history)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f