NAME

r.out.ascii - Converts a raster map layer into an ASCII text file.
(GRASS Raster Data Export Program)

SYNOPSIS

r.out.ascii
r.out.ascii help
r.out.ascii [-h] map=name [digits=value]

DESCRIPTION

r.out.ascii converts a user-specified raster map layer (map=name) into an ASCII text file suitable for export to other computer systems. The digits=value option (where value is a number of the user's choice) can be used to request that numbers in the ouput be equally-spaced (i.e., columnar output). Each category value in the ASCII map layer will then take up value number of spaces. However, to use this, the user should know the maximum number of digits that will occur in the output file, and add one to this number (to leave a space between each column). The user can find the maximum number of digits occurring in the output file by running r.out.ascii without the digits=value option.

The GRASS program r.in.ascii can be used to perform the reverse function, converting an ASCII file in suitable format to GRASS raster file format.

OPTIONS

Flags:

-h
Suppress printing of header information.

Parameters:

map=name
Name of an existing raster map layer.
digits=value
The minimum number of digits (per cell) to be printed.
r.out.ascii can be run either non-interactively or interactively. The program will be run non-interactively if the user specifies the name of a raster map layer and (optionally) a value for digits, using the form
r.out.ascii map=name [digits=value]
where name is the name of a raster map layer to be converted to ASCII format, and value is the minimum number of digits (per cell) to be printed to output. The user can also the -h option to suppress the output of file header information.

Alternately, the user can simply type r.out.ascii on the command line, without program arguments. In this case, the user will be prompted for parameter values using the standard GRASS parser interface.

NOTES

The output from r.out.ascii may be placed into a file by using the UNIX redirection mechanism; e.g.:
r.out.ascii map=soils > out.file
The output file out.file can then be printed or copied onto a magnetic tape or floppy disk for export purposes.

SEE ALSO

r.in.ascii
parser

AUTHOR

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory