.TH s.in.shape 1
.SH NAME
\fIs.in.shape\fR \- Read an ArcView Shapefile with points or multipoint shapes
.br
.SH SYNOPSIS
\fBs.in.shape \fR[\fB -l \fR] \fR[\fB -z \fR] \fR[\fB -m \fR] \fBin=\fIname
\fR[\fBattribute=\fIattribute category\fR] \fR[\fBheight=\fIconstant height value\fR]
.br 
.SH DESCRIPTION
.LP
The \fIs.in.shape\fR module imports point and multipoint themed ESRI shapefiles
into a GRASS sites_list.
.LP
.br
\fIs.in.shape\fR can be run with command line options as follows:
.LP
.br
\fBs.in.shape \fR[\fB -l \fR] \fR[\fB -z \fR] \fR[\fB -m \fR] \fBin=\fIname
\fR[\fBattribute=\fIattribute category\fR] \fR[\fBheight=\fIconstant height value\fR]
.br
.LP
Alternatively, an interactive interface can be started:
.LP
\fBs.in.shape\fR
.LP
In this case, the user will be prompted for parameter values using the standard
GRASS user interface described in the manual entry for \fIparser\fR.
.br
.SH FEATURES
.LP
Grass files created have the name extracted from the basename of the shapefile.
.LP
All the fields in the associated dbf file are imported, but those not recognised
as INTEGER, DOUBLE OR STRING are simply recorded as INTEGER with a common value
of zero. This is a place-holder for possibly improved type support in the future.
.LP
A field may be chosen as the attribute field, or if not, a sequential ID field
is created.
.LP
Multipoint themes are imported with individual points being each given a separate
record, but the original record number is preserved in a special field. It is always
the first (after the attribute).
.LP
If a measure field is defined in the input theme, this is recorded in a special field.
It will be the second if present. A module or script using these sites lists is expected
to know if this field is present. This fact is not recorded.
.LP
An optional height record for 3d points can be stored if present as a third dimension.
.br
.SH FLAGS
.LP
.IP "\fB-l\fR"
List the fields contained in the DBF file associated with the input shapefile,
then exit.
.IP "\fB-z\fR"
Include a height with each record. The height will only be recorded if this
flag is set, and then will always be given. If the input data does not
contain a height field, a constant value is set, which defaults to 0.
The default can be over-ridden with the \fIheight\fR option - see below.
.IP "\fB-m\fR"
Include a field in the sites file with the measure field from the input theme.
This is only used if the input theme defines this field, \fBand\fR the user
specifies this flag. Otherwise it is ignored. If present, the measure
field will be the second field.
.br
.SH OPTIONS
.LP
.IP "\fBin=\fIname\fR"
Name of input shape file. Provide a full path name or the name of a file in
the current directory. Any of the full pathname, basename, or prefix only
will suffice. 
.IP "\fBheight=\fIz-value\fR"
In the event you select the \fB-z\fR option, \fBand\fR there is no in-built height field
(zval) in the input file, this can provide a constant height value. Otherwise it is
ignored if given.
.IP "\fBattribute=\fIa_name\fR"
Name of the field in the dbf file to use as the attribute in the sites list. 
Defaults to a sequential index if no attribute field is given, or the given field
is a string field.
.br
.SH BUGS AND CAVEAT
.LP
The projection must be set in the mapset before input.
.LP
Some site maps do not display all markers.
.LP
The time stamp facility does not appear to work at present.
.br
.SH SEE ALSO
.br
.I g.mapset,
.I g.region,
.I g.proj,
.I v.in.shape.
.br
.SH AUTHORS
.LP
David D. Gray
.br
.LP