v.out.shape(1)		      Grass User's Manual		v.out.shape(1)



NNAAMMEE
       _v_._o_u_t_._s_h_a_p_e - export GRASS vector files to ESRI Shapefile

SSYYNNOOPPSSIISS
       vv..oouutt..sshhaappee   [-valA]   map=_n_a_m_e   type=_a_r_e_a_,_l_i_n_e_,_p_o_i_n_t	 [mapset=_n_a_m_e]
       [cats=_[_n_o_n_e_]_,_s_t_r_i_n_g_,_i_n_t_e_g_e_r_,_f_l_o_a_t]  [prefix=_n_a_m_e]  [log=_f_i_l_e_n_a_m_e]  [ta-
       ble=_n_a_m_e] [key=_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       vv..oouutt..sshhaappee will export GRASS vectors files to ESRI Shapefile format.

OOPPTTIIOONNSS
   FFllaaggss::
       _-_v Verbose messages


       _-_a Restrict lines exported to arcs of type area-edge


       _-_l Restrict lines exported to arcs of type line


       _-_A Output all area rings (include unlabelled areas)



   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      name  of	input  vector  map.  Must  be  level  2.(Run v.support
	      option=build)

       ttyyppee==_o_p_t_i_o_n
	      coverage type.
	      OOppttiioonnss: area, line, point

       mmaappsseett==_n_a_m_e
	      name of mapset containing vector file (default current).

       ccaattss==_o_p_t_i_o_n
	      If category support is available, a  third  field  is  generated
	      containing data of the selected type. Note `float' uses a double
	      precision number. Otherwise ignored.
	      OOppttiioonnss: none(default),string,integer,float.

       pprreeffiixx==_n_a_m_e
	      prefix for SHAPE output filenames. Default  is  name  of	vector
	      map.

       lloogg==_f_i_l_e_n_a_m_e
	      choose  a  logfile. If the file cannot be opened, standard error
	      stream is used.

       ttaabbllee==_n_a_m_e
	      name of database table used as attributes source.

       kkeeyy==_n_a_m_e
	      key column in table used for linking rows to shapes.


NNOOTTEESS
       The vector file export program, v.out.shape, will prompt you  to  enter
       the name of a GRASS vector file to be exported to SHAPE and for various
       options, see above.


       A GRASS vector file to be exported to SHAPE may contain POINT, LINE and
       POLYGON	coverage. If you select more types for conversion, more layers
       will be produced with the appended suffixes __lliinnee,  __ppooiinntt  and	__aarreeaa.
       Lines used as area edges however are not duplicated in the lines layer.
       If one layer is empty the unused files are deleted.


       If _t_a_b_l_e_= option is specified, dbf table structure and data is used for
       output  dbf  table.  _k_e_y_= option is name of column used as link between
       table rows and GRASS categories. Database  connection  must  be	estab-
       lished  by  db.connect  first.  Supported  column types are numbers and
       strings (int, double, char, varchar,...). Time and other types are  not
       supported.


       When  exporting	area  features,  the _-_A flag specifies that all areas,
       whether labelled or not,  should  be  exported.	 This  may  result  in
       exporting  area	features  that	really represent "holes" in other area
       features.

BBUUGGSS
       If data are read from table, problem with char and varchar column types
       may occur. For example for MySQL column width is set according to first
       record instead of column size. PostgreSQL tables are OK. Problem is  in
       ODBC driver and database specific drivers.

SSEEEE AALLSSOO
       _v_._i_n_._s_h_a_p_e_,   _m_._i_n_._e_0_0_,	 _v_._o_u_t_._e_0_0_,  _v_._i_n_._a_r_c_,	_v_._o_u_t_._a_r_c_,  _v_._o_u_t_._d_l_g_,
       _d_b_._c_o_n_n_e_c_t


AAUUTTHHOORR
       David D. Gray



       Depends on shapelib-1.2.8 or later by Frank Warmerdam.


       DBMI support by Radim Blazek



GRASS 5.0							v.out.shape(1)
