NAME
v.support - Creates GRASS support files for
(binary) GRASS vector data.
(GRASS Vector Program)
SYNOPSIS
v.support
v.support help
v.support [-spr]
map=name
[option=name]
[threshold=value]
DESCRIPTION
v.support builds GRASS support files for (binary)
GRASS vector data files. These support files supply
topology (dig_plus) and category
(dig_att) information that are needed by other
GRASS programs
(e.g., by v.digit,
v.to.rast, etc.).
The program gives the user the options of:
- building topological information (the
dig_plus file) needed by
v.digit for
the vector data file, and/or
- editing the category label (dig_cats) file
associated with the vector data file.
OPTIONS
Program parameters and flags have the following meanings.
Flags:
- -s
- Snap nodes. Valid only with build option.
- -p
- Prompt user for threshold value. Valid only with
build option. This flag is designed to be used
only by the
v.import
program, and can usually be ignore.
- -r
- Reset corners of map region from range of data values.
Parameters:
- map=name
- Name of binary GRASS vector data file for which support
files are to be created or modified. This map layer must
exist in the user's current GRASS mapset.
- option=name
- Build topology information (dig_plus file),
or edit categories (dig_att file) for
map.
Options: build, edit
Default: edit
- threshold=value
- Snapping threshold value to be used when building
topology. Valid only with build option and
-s flag.
The user can run this program non-interactively by
specifying parameter values (and optionally, flag settings)
on the command line.
Alternately, the user can simply type the command
v.support on the command line. In this event, the
program will prompt the user to enter parameter values and
flag settings.
If the build option is chosen, the user may
further specify the -s flag, to snap nodes in the
vector file. If nodes are to be snapped, the user can
either: (1) use the calculated default threshold (based on
the scale of vector data); (2) enter the -p flag, causing
the program to prompt the user for a snapping threshold
value; or (3) enter a specific threshold value on the
command line.
The spatial assignment of category values (found in the
dig_att file) is also performed during building of
file topology.
The edit option allows the user to edit the
category labels to be associated with the category values
attached to the vector data during topology building.
These labels, if created, are then used for raster map
layers derived from their vector counterparts. The labels
are placed in the dig_cats directory.
NOTES
A dig_plus file must be created for each imported vector map
before it can be used in post-GRASS 3.0 versions of digit
(now referred to as v.digit).
Topological information for GRASS vector files can also be built using
option 4 of the
v.import program.
This program will convert pre-4.0 version GRASS vector files to 4.0 format.
v.support creates support files only for binary
vector files located in the user's current mapset.
SEE ALSO
v.digit,
v.import,
v.in.ascii,
v.prune,
v.to.rast
AUTHORS
Dave Gerdes, U.S.Army Construction Engineering
Research Laboratory
Michael Higgins,
U.S.Army Construction Engineering
Research Laboratory