Skip to content

t.copy

Creates a copy of a space time raster dataset.

t.copy [-c] input=name [type=name] output=name [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

t.copy input=name output=name

grass.script.run_command("t.copy", input, type="strds", output, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("t.copy", input="name", output="name")

Parameters

input=name [required]
    Name of the input space time dataset
type=name
    Type of the input space time dataset
    Allowed values: strds, str3ds, stvds
    Default: strds
output=name [required]
    Name of the output space time dataset
-c
    Also copy maps of the space-time dataset
    By default the old maps are only registered in the new 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

input : str, required
    Name of the input space time dataset
    Used as: input, stds, name
type : str, optional
    Type of the input space time dataset
    Used as: name
    Allowed values: strds, str3ds, stvds
    Default: strds
output : str, required
    Name of the output space time dataset
    Used as: output, stds, name
flags : str, optional
    Allowed values: c
    c
        Also copy maps of the space-time dataset
        By default the old maps are only registered in the new 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

The purpose of t.copy is to create a copy of a space time dataset. The new space time dataset will be located in the current mapset, whereas the old space time dataset can be located in a different mapset as long as this mapset is in the search path.

If the -c flag is given, the maps of the old space time dataset will also be copied to the current mapset, otherwise the original maps will be simply registered in the temporal database. The new copies will have the same name as the old maps.

NOTES

A fully qualified name for the input space-time dataset is only required if space-time datasets with the same name exist in different mapsets.

EXAMPLE

In the North Carolina sample dataset with the separately available mapset modis_lst included, copy the space-time raster dataset LST_Day_monthly@modis_lst to the current mapset user1:

g.mapsets mapset=modis_lst operation=add
t.copy input=LST_Day_monthly@modis_lst type=strds output=LST_Day_monthly

SEE ALSO

t.rast.extract, t.rast3d.extract, t.vect.extract, t.info

AUTHOR

Markus Metz, mundialis

SOURCE CODE

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