1r3.out.ascii(1)               Grass User's Manual              r3.out.ascii(1)
2
3
4

NAME

6       r3.out.ascii  - Converts a 3D raster map layer into an ASCII text file
7

KEYWORDS

9       raster3d, voxel
10

SYNOPSIS

12       r3.out.ascii
13       r3.out.ascii help
14       r3.out.ascii   [-hm]   input=string    [output=string]     [dp=integer]
15       [null=string]
16
17   Flags:
18       -h  Suppress printing of header information
19
20       -m  Use G3D mask (if exists) with input map
21
22   Parameters:
23       input=string
24           3dcell map to be converted to ASCII
25
26       output=string
27           Name for ASCII output file
28
29       dp=integer
30           Number of decimal places for floats Options: 0-20 Default: 8
31
32       null=string
33           Char string to represent no data cell Default: *
34

DESCRIPTION

36       Outputs G3D maps in ascii format.  map is a valid G3D map in  the  cur‐
37       rent mapset.  output is the name of an ascii file which will be written
38       in the current working directory.  If output is not specified then std‐
39       out  is  used.  The -h flag may be used to suppress header information.
40       The module is sensitive to region settings (set with g.region).
41

NOTES

43       The default format for the ascii file is equivalent to that required by
44       r3.in.ascii.   In  particular, files output by r3.out.ascii with header
45       information may be converted back to G3D maps with r3.in.ascii.
46
47       The format for the ascii file is:
48       north:   floating point
49       south:   floating point
50       east:    floating point
51       west:    floating point
52       top:     floating point
53       bottom:  floating point
54       rows:    integer
55       cols:    integer
56       levels:  integer
57        The header is followed by cell values in floating point format.   Cell
58       values  are output as a series of horizontal slices in row-major order.
59       That is,
60         (x, y, z)       (x + 1, y, z)     ...     (x + cols, y, z)
61       (x, y + 1, z)   (x + 1, y + 1, z)   ...   (x + cols, y + 1, z)
62         and so on
63
64
65       One level maps can be imported with r.in.ascii (Raster 2D) after remov‐
66       ing the header lines "top", "bottom" and "levels".
67

SEE ALSO

69       r3.in.ascii
70       g.region
71

AUTHORS

73       Roman  Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown, Lubos
74       Mitas, Jaro Hofierka
75
76       Last changed: $Date: 2006/04/20 21:31:24 $
77
78       Full index
79
80
81
82GRASS 6.2.2                                                    r3.out.ascii(1)