GRASS GIS manual: t.rast.out.xyz

Note: This document is for an older version of GRASS GIS that is outdated. You should upgrade, and read the current addon manual page.

NAME

t.rast.out.xyz - Export space time raster dataset to a CSV file.

KEYWORDS

temporal, raster, export, ASCII, conversion

SYNOPSIS

t.rast.out.xyz

t.rast.out.xyz --help

t.rast.out.xyz [-i] strds=name [output=name] [where=sql_query] [separator=character] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-i: Include no data values
--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:

strds=name [required]: Name of the input space time raster dataset
output=name: Name for the output file or "-" in case stdout should be used; Default: -
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'
separator=character: Field separator; Special characters: pipe, comma, space, tab, newline; Default: pipe

DESCRIPTION
NOTES
EXAMPLE
SEE ALSO
AUTHOR

DESCRIPTION

The t.rast.out.xyz module exports a space time raster dataset as a list of x,y,z values into an ASCII text file.

By default, this module does not export x,y coordinates for raster cells containing a NULL value. This includes cells masked by a raster MASK. However, using the flag -i also these raster cells will be included in the exported data. t.rast.out.xyz is simply a front-end for "r.out.xyz".

EXAMPLE

# export strds without NULL cells
t.rast.out.xyz strds=mystrds output=/tmp/mystrds.csv

# export strds including NULL cells and for a certain time period
t.rast.out.xyz -i strds=mystrds output=/tmp/mystrds.csv \
 where="start_time > '2010-01-01 00:00:00'"

AUTHOR

Luca Delucchi, Fondazione Edmund Mach

SOURCE CODE

Available at: t.rast.out.xyz source code (history)