Name of the input field to use as the category label in dig_cats. Only
writes out results if a meaningful category field is given, otherwise no action
is taken. If the same attribute is re-assigned a new category, the value is
over-written.
BUGS AND CAVEAT
There is no support for projection since the projection information is not
stored in SHAPE files.
Multipatch data is not yet supported. Point data is now imported, but in
the GRASS 5.0.x vector model, these vector 'points' have limited utility.The
module s.in.shape imports
site data in a form that may be found more useful.
The filtration process creates a large temp file to store the imported data
and a significant amount of metadata about the imported points. This can be
large
in large files. It is deleted if the import proceeds in a normal fashion, but will
be left 'dangling' on abnormal termination. This however is a quite general problem in the
current GRASS environment model. If disk space is available, this module will now import
an unlimited size of map, though it is currently slow on large maps, as there are many
disk read/write operations. This is compounded by the lengthy build process, which however
affects all vector map builds.
Area and perimeter fields in input data may no longer
be quite correct if the lines have been adjusted to correct topology problems.
But if the user has not modified the file, the values should be correct. If in
doubt, GRASS's own modules may be used to generate dimensional data, for example
v.report
EXAMPLE
Example:
v.in.shape in=map.shp out=map attribute=OBJART label=ALIASFOLIE scale=25000
This command imports the shape file "map" into GRASS at scale of 1:25000
(since the scale is not stored in the shape file). "attribute" is the field
name containing the record ID (if not set, internal numbering will be done).
"label" is the field containing the associated text labels. Use the "-d"
flag to get the list of fields from the "map.dbf" file.
SEE ALSO
m.in.e00,
g.mapsets,
g.region,
v.digit,
v.proj,
s.in.shape,
v.support,
v.to.rast,
v.out.shape
v.extract
v.report
AUTHORS
Frank Warmerdam (warmerda@home.com)
Based on Shapelib (http://gdal.velocet.ca/projects/shapelib/).
Markus Neteler
added category support
David Gray
preprocessing to provide correct handling of polygon
edges, labels and correction of some topological errors. Also some new
options q.v.
Spring 2002: Rewrite of most of the code.
Last changed: $Date: 2002/06/12 00:17:34 $