## DESCRIPTION

The module t.register is designed to register raster, 3D raster and vector maps in the temporal database and in specific space time datasets. This module must be used to assign time stamps to raster, 3D raster and vector maps. The existing timestamp modules r.timestamp, r3.timestamp and v.timestamp should not be used, since they do not register the maps in the temporal database of GRASS.

This module supports absolute and relative time. Maps can be registered by command line argument (a list of comma separated map names) or using an input file. The start time, the end time and a temporal increment can be provided by command line or in the input file. End time and increment are mutual exclusive. The user can register single maps or a list of maps at once. Maps can be registered in several space time datasets using the same time stamp.

Start time and end time with absolute time must be provided using the format yyyy-mm-dd HH:MM:SS +HHMM. It is supported to specify only the date yyyy-mm-dd. In case of relative time the temporal unit (years, months, days, hours, minutes or seconds) must be provided. The relative start time, end time and the increment are integers.

## INPUT FILE FOTMAT

Specification of map names:

    prec_1
    prec_2
    prec_3
    prec_4
    prec_5
    prec_6

Specification of map names and the absolut start time of the time instances:

    prec_1|2001-01-01
    prec_2|2001-02-01
    prec_3|2001-03-01
    prec_4|2001-04-01
    prec_5|2001-05-01
    prec_6|2001-06-01

Specification of the map name and the absolute time interval with start and end time:

    prec_1|2001-01-01|2001-04-01
    prec_2|2001-04-01|2001-07-01
    prec_3|2001-07-01|2001-10-01
    prec_4|2001-10-01|2002-01-01
    prec_5|2002-01-01|2002-04-01
    prec_6|2002-04-01|2002-07-01

## EXAMPLE

In this example we create 6 raster maps that will be registered in a single space time raster dataset named precip_abs using a monthly temporal granularity. The -i flag generates interval time.

    r.mapcalc --o expr="prec_1 = 100"
    r.mapcalc --o expr="prec_2 = 200"
    r.mapcalc --o expr="prec_3 = 300"
    r.mapcalc --o expr="prec_4 = 400"
    r.mapcalc --o expr="prec_5 = 500"
    r.mapcalc --o expr="prec_6 = 600"

    t.create --o type=strds temporaltype=absolute \
        output=precip_abs title="Eexample" \
        descr="Example"

    t.register -i type=rast input=precip_abs \
        maps=prec_1,prec_2,prec_3,prec_4,prec_5,prec_6 \
        start="2001-01-01" increment="1 months"

## SEE ALSO

t.create
t.info

## AUTHOR

Sören Gebbert

Last changed: $Date$