xenial (1) t.rast.export.1grass.gz

Provided by: grass-doc_7.0.3-1build1_all bug

NAME

       t.rast.export  - Exports space time raster dataset.

KEYWORDS

       temporal, export, raster, time

SYNOPSIS

       t.rast.export
       t.rast.export --help
       t.rast.export   input=name   output=name    [directory=name]     [compression=string]     [format=string]
       [where=sql_query]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

   Flags:
       --overwrite
           Allow output files to overwrite existing files

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       input=name [required]
           Name of the input space time raster dataset

       output=name [required]
           Name of a space time raster dataset archive

       directory=name
           Path to the work directory, default is /tmp
           Default: /tmp

       compression=string
           Compression method of the tar archive
           Options: no, gzip, bzip2
           Default: bzip2

       format=string
           The export format of a single raster map
           Supported are GTiff, AAIGrid via r.out.gdal and the GRASS package format of r.pack
           Options: GTiff, AAIGrid, pack
           Default: GTiff

       where=sql_query
           WHERE conditions of SQL statement without ’where’ keyword used in the temporal GIS framework
           Example: start_time > ’2001-01-01 12:30:00’

DESCRIPTION

       t.rast.export exports a space time raster dataset (strds) as a tar  archive.  The  archive  contains  the
       raster  maps  either  as  GeoTIFF  files or as GRASS binary files exported using r.pack. The map specific
       color tables are exported in case of GeoTIFF files. In addition several metadata files are created in the
       archive  that  describe the temporal layout.  All time stamps are stored in the file "list.txt". For each
       map one row. The name of the map, the start time and the  end  time  are  written.  In  case  of  a  time
       instance,  the  start  time  is equal to the end time. The "init.txt" files stores the temporal type, the
       number of maps, the chosen export format and  some  other  metadata.  The  "proj.txt"  files  stores  the
       projection  information  as proj4 string of the location the space time raster dataset was exported from.
       The file "readme.txt" describes the file format. The output of r.info is stored in "metadata.txt".

       The tar archive can be compressed using the compress option. Gzip and bzip2 (default)  are  available.  A
       where  option can be specified, to export only a subset of the space time dataset. Archives exported with
       t.rast.export can be imported with t.rast.import.

EXAMPLE

       In this example, all the maps of 2012 of "tempmean_monthly" will be exported:
       t.rast.export input=tempmean_monthly output=tempmean_monthly.tar.bzip2 \
                     where="start_time >= ’2012-01-01’ and start_time < ’2013-01-01’"
       tar xvf precipitation_daily.tar
       2012_01_tempmean.tif
       2012_01_tempmean.color
       2012_02_tempmean.tif
       2012_02_tempmean.color
       2012_03_tempmean.tif
       2012_03_tempmean.color
       2012_04_tempmean.tif
       2012_04_tempmean.color
       2012_05_tempmean.tif
       2012_05_tempmean.color
       2012_06_tempmean.tif
       2012_06_tempmean.color
       2012_07_tempmean.tif
       2012_07_tempmean.color
       2012_08_tempmean.tif
       2012_08_tempmean.color
       2012_09_tempmean.tif
       2012_09_tempmean.color
       2012_10_tempmean.tif
       2012_10_tempmean.color
       2012_11_tempmean.tif
       2012_11_tempmean.color
       2012_12_tempmean.tif
       2012_12_tempmean.color
       list.txt
       proj.txt
       init.txt
       readme.txt
       metadata.txt
       cat init.txt
       stds_type=strds
       format=GTiff
       temporal_type=absolute
       semantic_type=mean
       number_of_maps=48
       north=320000.0
       south=10000.0
       east=935000.0
       west=120000.0
       cat proj.txt
       +proj=lcc
       +lat_1=36.16666666666666
       +lat_2=34.33333333333334
       +lat_0=33.75
       +lon_0=-79
       +x_0=609601.22
       +y_0=0
       +no_defs
       +a=6378137
       +rf=298.257222101
       +towgs84=0.000,0.000,0.000
       +to_meter=1
       cat list.txt
       2012_01_tempmean|2012-01-01 00:00:00|2012-02-01 00:00:00
       2012_02_tempmean|2012-02-01 00:00:00|2012-03-01 00:00:00
       2012_03_tempmean|2012-03-01 00:00:00|2012-04-01 00:00:00
       2012_04_tempmean|2012-04-01 00:00:00|2012-05-01 00:00:00
       2012_05_tempmean|2012-05-01 00:00:00|2012-06-01 00:00:00
       2012_06_tempmean|2012-06-01 00:00:00|2012-07-01 00:00:00
       2012_07_tempmean|2012-07-01 00:00:00|2012-08-01 00:00:00
       2012_08_tempmean|2012-08-01 00:00:00|2012-09-01 00:00:00
       2012_09_tempmean|2012-09-01 00:00:00|2012-10-01 00:00:00
       2012_10_tempmean|2012-10-01 00:00:00|2012-11-01 00:00:00
       2012_11_tempmean|2012-11-01 00:00:00|2012-12-01 00:00:00
       2012_12_tempmean|2012-12-01 00:00:00|2013-01-01 00:00:00
       cat readme.txt
       This space time raster dataset was exported with t.rast.export of GRASS GIS 7
       Files:
              *.tif  -- GeoTIFF raster files
            *.color  -- GRASS GIS raster color rules
            proj.txt -- Projection information in PROJ.4 format
            init.txt -- GRASS GIS space time raster dataset information
            list.txt -- Time series file, lists all maps by name with interval
                        time stamps in ISO-Format. Field separator is |
        metadata.txt -- The output of t.info
          readme.txt -- This file

SEE ALSO

        t.rast.import, t.create, t.info, r.out.gdal, r.pack, t.vect.export

AUTHOR

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

       Last changed: $Date: 2015-10-06 17:26:07 +0200 (Tue, 06 Oct 2015) $

       Main index | Temporal index | Topics index | Keywords index | Full index

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual