Skip to content

t.create

Creates a space time dataset.

t.create output=name [type=name] [temporaltype=name] semantictype=string title=string description=string [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

t.create output=name semantictype=mean title=string description=string

grass.script.run_command("t.create", output, type="strds", temporaltype="absolute", semantictype="mean", title, description, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("t.create", output="name", semantictype="mean", title="string", description="string")

Parameters

output=name [required]
    Name of the output space time dataset
type=name
    Type of the output space time dataset
    Allowed values: strds, stvds, str3ds
    Default: strds
temporaltype=name
    The temporal type of the space time dataset
    Allowed values: absolute, relative
    Default: absolute
semantictype=string [required]
    Semantic type of the space time dataset
    Allowed values: min, max, sum, mean
    Default: mean
title=string [required]
    Title of the new space time dataset
description=string [required]
    Description of the new space time dataset
--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

output : str, required
    Name of the output space time dataset
    Used as: output, stds, name
type : str, optional
    Type of the output space time dataset
    Used as: name
    Allowed values: strds, stvds, str3ds
    Default: strds
temporaltype : str, optional
    The temporal type of the space time dataset
    Used as: name
    Allowed values: absolute, relative
    Default: absolute
semantictype : str, required
    Semantic type of the space time dataset
    Allowed values: min, max, sum, mean
    Default: mean
title : str, required
    Title of the new space time dataset
description : str, required
    Description of the new space time dataset
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.create is used to create space time datasets of type raster (STRDS), 3D raster (STR3DS) and vector (STVDS).

Space time datasets represent spatio-temporal fields in the temporal GRASS framework. They are designed to collect any amount of time stamped maps with time intervals and time instances. The temporal type of a space time dataset can be absolute (means with a fixed date) or relative (only sequential maps) and must be set during dataset creation along with the name and the description.

Time stamped maps can registered in and unregistered from space time datasets. The spatio-temporal extent as well as the metadata of a space time dataset is derived from its registered maps. Hence the metadata is dependent from the dataset type (raster, 3D raster, vector).

EXAMPLE

Absolute STRDS dataset

Create a raster space time datasets

t.create type=strds temporaltype=absolute \
         output=precipitation_monthly \
         title="Monthly precipitation" \
         description="Dataset with monthly precipitation"

Relative STVDS dataset

Create a vector space time datasets

t.create type=stvds temporaltype=relative \
         output=precipitation_monthly_30y \
         title="Monthly precipitation 30 years" \
         description="Test dataset with monthly average \
         precipitation in the last 30 year"

SEE ALSO

t.register, t.remove, t.info

AUTHOR

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

SOURCE CODE

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