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 mul-
       tipoint 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 shapefiles into a GRASS sites_list.

       _s_._i_n_._s_h_a_p_e  can	be  run with command line options as fol-
       lows:

       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 val-
       ues  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 base-
       name 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 pre-
       sent.  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. Oth-
       erwise  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, basename, 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 sequential 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 pre-
       sent.

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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0					    s.in.shape(1)
