t.rast.import

Imports space time raster dataset.

Command linePython (grass.script)

t.rast.import [-rleoc] input=name output=name [basename=string] directory=name [title=string] [description=string] [project=string] [memory=memory in MB] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

t.rast.import input=name output=name directory=/tmp

grass.script.run_command("t.rast.import", input, output, basename=None, directory="/tmp", title=None, description=None, project=None, memory=300, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("t.rast.import", input="name", output="name", directory="/tmp")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input file
output=name [required]
    Name of the output space time raster dataset
basename=string
    Basename of the new generated output maps
    A numerical suffix separated by an underscore will be attached to create a unique identifier
directory=name [required]
    Path to the extraction directory
    Default: /tmp
title=string
    Title of the new space time dataset
description=string
    Description of the new space time dataset
project=string
    Create a new project and import the data into it. Do not run this module in parallel or interrupt it when a new project should be created
memory=memory in MB
    Maximum memory to be used (in MB)
    Cache size for raster rows
    Default: 300
-r
    Set the current region from the last map that was imported
-l
    Link the raster files using r.external
-e
    Extend project extents based on new dataset
-o
    Override projection check (use current projects's CRS)
    Assume that the dataset has same coordinate reference system as the current location
-c
    Create the project specified by the "project" parameter and exit. Do not import the space time raster datasets.
--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 input file
    Used as: input, file, name
output : str, required
    Name of the output space time raster dataset
    Used as: output, strds, name
basename : str, optional
    Basename of the new generated output maps
    A numerical suffix separated by an underscore will be attached to create a unique identifier
directory : str, required
    Path to the extraction directory
    Used as: input, dir, name
    Default: /tmp
title : str, optional
    Title of the new space time dataset
description : str, optional
    Description of the new space time dataset
project : str, optional
    Create a new project and import the data into it. Do not run this module in parallel or interrupt it when a new project should be created
memory : int, optional
    Maximum memory to be used (in MB)
    Cache size for raster rows
    Used as: memory in MB
    Default: 300
flags : str, optional
    Allowed values: r, l, e, o, c
    r
        Set the current region from the last map that was imported
    l
        Link the raster files using r.external
    e
        Extend project extents based on new dataset
    o
        Override projection check (use current projects's CRS)
        Assume that the dataset has same coordinate reference system as the current location
    c
        Create the project specified by the "project" parameter and exit. Do not import the space time raster datasets.
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.rast.import imports a space time raster dataset archive that was exported with t.rast.export.

NOTES

Optionally a base map name can be provided to avoid that existing raster maps are overwritten by the map names that are used in the STRDS archive.

The directory is used as work directory in case of import but can also be used as a data directory when using GeoTIFF for the data exchange.

EXAMPLE

The North Carolina space time dataset contains a data package called lst_daily.tar.bzip2 with daily data from MODIS LST. Import it by running:

t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
              basename=lst directory=/tmp

AUTHOR

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

SOURCE CODE

Available at: t.rast.import source code (history)
Latest change: Wednesday Apr 02 17:48:37 2025 in commit 571253a