NAME
r3.out.ascii - Outputs G3D maps in ASCII format.
(GRASS 3D Program)
SYNOPSIS
r3.out.ascii [-h] map=name [output=name]
[dp=value] [null=name]
DESCRIPTION
Outputs G3D maps in ascii format. map is
a valid G3D map in the current mapset. output is the name of
an ascii file which will be written in the current working directory.
If output is not specified then stdout is used. The
-h flag may be used to suppress header information. The module is
sensitive to region settings (set with g3.region).
Flag:
- -h
- Suppress printing of header information
Parameters:
- map
- G3d raster map to be converted to ascii
- output
- Name for ascii output file
- dp
- Number of decimal places for floats (options: 0-20)
- Default: 8
- null
- Char string to represent no data cell
- Default: *
NOTES
The default format for the ascii file is equivalent to that required
by r3.in.ascii. In particular, files output by
r3.out.ascii with header information may be converted back to
G3D maps with r3.in.ascii.
The format for the ascii file is:
|
north: | floating point |
| south: | floating point |
| east: | floating point |
| west: | floating point |
| top: | floating point |
| bottom: | floating point |
| rows: | integer |
| cols: | integer |
| levels: | integer |
The header is followed by cell values in floating point format.
Cell values are output as a series of horizontal slices in row-major
order. That is,
| (x, y, z) | (x + 1, y, z) | ... | (x + cols, y, z) |
| (x, y + 1, z) | (x + 1, y + 1, z) | ... | and so on |
One level maps can be imported with r.in.ascii (Raster 2D) after removing
the header lines "top", "bottom" and "levels".
SEE ALSO
r3.in.ascii
g3.region
AUTHORS
Roman Waupotitsch, Michael Shapiro,
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka