Input can be entered via standard input or from the file input=name. Each line of input should contain the easting, northing, and either the category value or category label associated with a site. The fs=name option (where name is either a character, a space, or a tab) can be used to specify the use of a particular field separator between these three input fields. This is useful when input is obtained from other programs (see NOTES, below). Output is stored in the vector map output=name.
The GRASS program s.out.ascii can be used to perform the reverse function, converting a file in GRASS vector sites format into an ASCII listing of eastings, northings, and category labels associated with site locations.
s.in.ascii can be run either non-interactively or interactively. The program will be run non-interactively if the user specifies a name to be assigned to the sites file output, the name of an existing ASCII file containing input, and (optionally) a field separator fs appearing in the input file.
Alternately, the user can simply type s.in.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 described in the manual entry for parser. If the user does not specify the name of an input file containing site locations and category attributes, these should be entered to the program via standard input. The d parameter allows the user to specify that more than 2 dimensions will be imported. Otherwise the third (or further) column in the input file will be treated as an attribute.
To define a date (timestamp), several date strings are accepted. Please see r.timestamp for details.
Other GRASS programs can be used to produce output in a format suitable for input to s.in.ascii. For example, the user might pipe output produced by d.where into s.in.ascii to create a site list file called my.sites containing site locations pointed to with the mouse, as illustrated below. In this example it is unnecessary to specify the field separator used in the input, since d.where output separates the easting and northing values with spaces, and spaces are the default field separator assumed by s.in.ascii.
Importing from a spreadsheet
Data may be imported from many spreadsheet programs by saving the spreadsheet as a comma separated variable (.csv) text file, and then using the "fs=," command line parameter with s.in.ascii.
Importing latitude/longitude data
Latitude/longitude data may be imported either in decimal degree format:
8.314824 54.921730 site1
8.897605 54.872353 site2
9.549371 54.834080 site3
or in DMS (degree, minutes, seconds) format:
8:18:53.3664E 54:55:18.228N site1
8:53:51.378E 54:52:20.4708N site2
9:32:57.7356E 54:50:02.688N site3
Time as String Attributes
In this example, we will work with the following site list:
10.8 0 9.8 Fri Sep 13 10:00:00 1986 31.4
11 5.5 9.9 Fri Sep 14 00:20:00 1985 36.4
5.1 3.9 10 Fri Sep 15 00:00:30 1984 28.4
This data has three dimensions (assume easting, northing, and
elevation), five string attributes, and one decimal attribute.
Last changed: $Date$