s.in.shape(1)		      Grass User's Manual		 s.in.shape(1)



NNAAMMEE
       _s_._i_n_._s_h_a_p_e - Read an ArcView Shapefile with points or multipoint shapes

SSYYNNOOPPSSIISS
       ss..iinn..sshhaappee [ --ll ] [ --zz ] [ --mm ] iinn==_n_a_m_e [aattttrriibbuuttee==_a_t_t_r_i_b_u_t_e  _c_a_t_e_g_o_r_y]
       [hheeiigghhtt==_c_o_n_s_t_a_n_t _h_e_i_g_h_t _v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       The  _s_._i_n_._s_h_a_p_e	module imports point and multipoint themed ESRI shape-
       files into a GRASS site_lists.

       _s_._i_n_._s_h_a_p_e can be run with command line options as follows:

       ss..iinn..sshhaappee [ --ll ] [ --zz ] [ --mm ] iinn==_n_a_m_e [aattttrriibbuuttee==_a_t_t_r_i_b_u_t_e  _c_a_t_e_g_o_r_y]
       [hheeiigghhtt==_c_o_n_s_t_a_n_t _h_e_i_g_h_t _v_a_l_u_e]

       Alternatively, an interactive interface can be started:

       ss..iinn..sshhaappee

       In  this case, the user will be prompted for parameter values using the
       standard GRASS user interface described in the manual entry for _p_a_r_s_e_r.

FFEEAATTUURREESS
       Grass  files  created  have the name extracted from the basename of the
       shapefile.

       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.

       A  field  may be chosen as the attribute field, or if not, a sequential
       ID field is created.

       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).

       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.

       An  optional  height record for 3d points can be stored if present as a
       third dimension.

FFLLAAGGSS
       --ll

       --zz List the fields contained in the DBF file associated with the  input
       shapefile, then exit.

       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 _h_e_i_g_h_t option -  see	below.
       --mm  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,
       aanndd  the user specifies this flag. Otherwise it is ignored. If present,
       the measure field will be the second field.



OOPPTTIIOONNSS
       iinn==_n_a_m_e 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, base-
       name, or prefix only will suffice.  hheeiigghhtt==_z_-_v_a_l_u_e  In  the  event  you
       select  the  --zz option, aanndd 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.	 aattttrriibbuuttee==_a___n_a_m_e Name of the field in the dbf
       file to use as the attribute in the sites list. Defaults to  a  sequen-
       tial  index  if	no  attribute  field is given, or the given field is a
       string field.



BBUUGGSS AANNDD CCAAVVEEAATT
       The projection must be set in the mapset before input.

       Some site maps do not display all markers.

       The time stamp facility does not appear to work at present.

SSEEEE AALLSSOO
       _g_._m_a_p_s_e_t_, _g_._r_e_g_i_o_n_, _g_._p_r_o_j_, _v_._i_n_._s_h_a_p_e_.

AAUUTTHHOORRSS
       David D. Gray

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_8_/_2_0 _0_8_:_1_0_:_1_3 _$



GRASS 5.0							 s.in.shape(1)
