NAME

s.out.ascii - Converts a GRASS site list file into an ASCII listing of site locations and their descriptions.
(GRASS Sites Program)

SYNOPSIS

s.out.ascii
s.out.ascii help
s.out.ascii [-ad] sites=name [fs=character|space|tab]

DESCRIPTION

s.out.ascii converts an existing site list file (sites=name) into an ASCII listing of site locations and (optionally) their category labels, in a format suitable for input to other programs (e.g., d.points, m.u2ll, etc.).

Each line of output consists of the easting, northing, and category label for a site listed in the named sites file. The fs=name option (where name is either a character, a space, or a tab) can be used to place a particular field separator between these three output fields. This is useful when output is to be manipulated by other programs, like awk or sed.

The GRASS program s.in.ascii can be used to perform the reverse function, converting a UNIX file containing eastings, northings, and category labels associated with site locations into GRASS site list file format.

OPTIONS

Flags:

-a
Output all sites found in the named sites file, rather than limiting output to sites falling within the current geographic region.
-d
Include site descriptions (category labels) in the output.

Parameters:

sites=name
Name of an existing site list file.
fs=character|space|tab
The field separator to be placed between the easting, northing, and (optionally) category label on each line of output. The field separator can be a character, a space, or a tab.
Default: space
s.out.ascii can be run either non-interactively or interactively. The program will be run non-interactively if the user specifies the name of an existing site list file and (optionally) a value for fs, using the form

s.out.ascii [-ad] sites=name [fs=character|space|tab]
where name is the name of an existing site list file to be converted to a brief ASCII listing, and fs is the field separator to be placed between output fields. The user can also the -a and -d options to use all sites in the named sites file and to include site descriptions in the output.

Alternately, the user can simply type s.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 s.out.ascii may be placed into a file by using the UNIX redirection mechanism; e.g.:

s.out.ascii sites=archsites > out.file
s.out.ascii output may also be redirected into other programs; e.g.:

s.out.ascii sites=archsites | d.points color=red size=10 type=diamond

SEE ALSO

d.points
d.sites
m.ll2u
m.u2ll
s.in.ascii
parser

AUTHOR

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