t.unregister

Unregisters raster, vector and raster3d maps from the temporal database or a specific space time dataset.

Command linePython (grass.script)

t.unregister [input=name] [file=name] [type=name] [maps=name [,name,...]] [--verbose] [--quiet] [--qq] [--ui]

Example:

t.unregister

grass.script.run_command("t.unregister", input=None, file=None, type="raster", maps=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("t.unregister")

Parameters

Command linePython (grass.script)

input=name
    Name of the input space time dataset
file=name
    Input file with map names, one per line
type=name
    Type of the input map
    Allowed values: raster, vector, raster_3d
    Default: raster
maps=name [,name,...]
    Name(s) of existing raster, vector or raster3d map(s) to unregister
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, optional
    Name of the input space time dataset
    Used as: input, stds, name
file : str, optional
    Input file with map names, one per line
    Used as: input, file, name
type : str, optional
    Type of the input map
    Used as: name
    Allowed values: raster, vector, raster_3d
    Default: raster
maps : str | list[str], optional
    Name(s) of existing raster, vector or raster3d map(s) to unregister
    Used as: input, map, name
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

The t.unregister module is designed to unregister raster, 3D raster and vector map layers from space time datasets and the temporal database.

Map layer that should be unregistered from the temporal database can be specified as a list of comma separated map names or using a text file, that contains one map layer name per line. By default the map type that should be unregistered is set to raster. The optiontype must be used to specify 3D raster or vector map layer types.

INPUT FILE FORMAT

Specification of map names:

a1
a2
a3
a4
a5
a6

NOTE

In case the input option is used to specify a space time dataset the maps are only unregistered from the space time dataset, but not from the temporal database. The reason is that maps can be registered in multiple space time datasets and there is a need to unregister them from a specific STDS without affecting other STDS.

EXAMPLE

In this example a precipitation map it is registered into temperature dataset, so the wrong map will be unregister.

t.register -i type=raster input=tempmean_monthly@climate_2009_2012 \
    maps=2012_01_precip \
    start="2013-01-01" increment="1 month"

# We unregister raster map 2012_01_precip from a space time dataset,
# the raster maps are still present in the temporal database
t.unregister type=raster input=tempmean_monthly@climate_2009_2012 maps=2012_01_precip

# We unregister raster map 2012_01_precip from the temporal database, hence
# the time stamps are removed
t.unregister type=raster maps=2012_01_precip

AUTHOR

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

SOURCE CODE

Available at: t.unregister source code (history)
Latest change: Tuesday Feb 25 01:48:02 2025 in commit 9013c3d