v.in.ascii

NAME

v.in.ascii - Converts ASCII vector map layers into binary vector map layers.
(GRASS Vector Data Import Program)

SYNOPSIS

v.in.ascii
v.in.ascii help
v.in.ascii input=name output=name

DESCRIPTION

v.in.ascii converts a vector map in ASCII format to a vector map in binary format.

OPTIONS

The user can run this program non-interactively by specifying all program options on the command line, in the form:

v.in.ascii input=name output=name

Parameters:

input=name: Name of an ASCII vector file to be converted to binary vector file.
output=name: Name given to binary vector output file.

If the user runs v.in.ascii without giving program arguments on the command line, the program will prompt the user for input and output file names.

NOTES

After running this program, GRASS support files must be built for the binary output file before the user can use the file in v.digit. The user can run v.support to create GRASS support files for the output file.

Example ASCII vector file:

       ORGANIZATION:
       DIGIT DATE:   Apr 24 2001
       DIGIT NAME:   nds_gem
       MAP NAME:     nds_gem
       MAP DATE:
       MAP SCALE:    500000
       OTHER INFO:   /home/neteler/grassdata5/langeoog/PERMANENT/dig_cats
       ZONE:         0
       WEST EDGE:    3326228.1
       EAST EDGE:    3690891.8
       SOUTH EDGE:   5670297.1
       NORTH EDGE:   5987928.8
       MAP THRESH:   381
       VERTI:
       A  1
        5819822.9 3343726.42
        5819801.5 3343947.43
        5820154.9 3344395.23
        5817559.7 3346542.47
       A  2
        5819822.83 3343726.42
        5827223.34 3348523.95
        5827298.34 3348556.25
        5827351.35 3348584.35
       L  3
        5821947.6 3344082.3
        5822086.8 3344101.9
        5822306.2 3344138.2
        5822883.7 3344227.3

The associated dig_cats file needs following format:

       # 3 categories

       0.00 0.00 0.00 0.00
	1:Stade
	2:Cuxhaven
	3:BAB

To (re-)set map metadata like ORGANIZATION etc., v.digit can be used.

The GRASS program v.out.ascii performs the function of v.in.ascii in reverse; i.e., it converts vector files in binary format to ASCII format. These two companion programs are useful both for importing and exporting vector files between GRASS and other software, and for transferring data between machines.

The input from v.in.ascii has to be placed into $LOCATION/dig_ascii (this directory must be created if not existing).

AUTHORS

Michael Higgins, U.S.Army Construction Engineering Research Laboratory
James Westervelt, U.S.Army Construction Engineering Research Laboratory