v.reclass.scs(1)	      Grass User's Manual	      v.reclass.scs(1)



NNAAMMEE
       vv..rreeccllaassss  - Changes vector category values for an existing vector map.
       _(_S_C_S _G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..rreeccllaassss
       vv..rreeccllaassss hheellpp
       vv..rreeccllaassss [ --dd] ttyyppee==_n_a_m_e iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e ffiillee==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._r_e_c_l_a_s_s allows a user to create a new vector map based on the reclas-
       sification  of  an  existing vector map.  The user provides the program
       with a category conversion file, input vector map name, an output  vec-
       tor  map  name,	and  the type of input map.  There is an option (d) to
       dissolve common boundaries between adjoining map areas of the same  re-
       classed category value.


       NNoottee::  The  dissolve  option will work on only those areas which are of
       the same conversion category value.  If a map area is inside (island) a
       converted  area	and is NOT converted to the same value, its boundaries
       are output to the resultant map.

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
   FFllaaggss::
       --dd     Dissolve common boundaries (default is no) .






   PPaarraammeetteerrss::
       ttyyppee==_n_a_m_e
	      Select area, line, or site.
	      Options:	area, line, site

       iinnppuutt==_n_a_m_e
	      Vector input map name.

       oouuttppuutt==_n_a_m_e
	      Vector output map name.

       ffiillee==_n_a_m_e
	      Text file name for category conversion.


EEXXAAMMPPLLEE
       vv..rreeccllaassss --dd iinnppuutt==_s_o_i_l_s oouuttppuutt==_s_o_i_l___g_r_o_u_p_a ttyyppee==_a_r_e_a
	       ffiillee==_c_o_n_v_e_r_t_1_,_c_o_n_v_e_r_t_2_,_c_o_n_v_e_r_t_3


       the input map _s_o_i_l_s contains 15 map area categories,
       the conversion files contain :

	 convert1     convert2	convert3
	  1:1		    3:2 	  2:3
	 10:1		    4:2 	  7:3
	 12:1		    5:2 	  8:3
	 15:1		    6:2 	  9:3
		      11:2	    13:3
		   14:3

       Produces a new vector area file _s_o_i_l___g_r_o_u_p_a  containing	'area'	bound-
       aries  from  _s_o_i_l_s_s  with area category values of 1,10,12,15 changed to
       category 1;  values of 3-6,11 changed to  2;   and  values  2,7-9,13-14
       changed to 3.  Any common boundaries are dissolved.


       NOTE:
       The format for "category label" is:

       if NO SPACES in the labels    if SPACES in the labels
		Abc			 area name 1:
		Def1			 area name 2:
		12A			 .    .   .
		WWd		       area name n:




       The format for "category value" is:

	1

	10

	12

	15

IINNTTEERRAACCTTIIVVEE MMOODDEE
       vv..rreeccllaassss
       o  The first question asked is the map type:



       Enter the type of map (area, line, site) [area] :
	      The default is for areas.


       o  The next question is if common boundaries are dissolved :



	Do you want common boundaries dissolved ?(y/n) [n]


       The default is no, meaning all exiting boundaries will be retained.


       o  The next question is an option for using category labels :



	Do you want to use category names ?(y/n) [n]


       The default is no, meaning the user will be using category values.


       o  The next question asks for the name of the input map :



	Enter vector map
	      Enter 'list' for a list of exiting vector files
	      Hit RETURN to cancel request
	      >


       Any map is the user's search list is available.


       o  The next question asks for the name of the output map :



	Enter name for resultant vector map
	      Enter 'list' for a list of exiting vector files
	      Hit RETURN to cancel request
	      >


       If  the	name is for an existing map, the user will be asked if the map
       can be over-written.


       o  The next question asks if a file of labels/categories is to be  used
       :


       If names was selected previously:



	Do you want to use a file of labels?(y/n) [n]


       If names was NOT selected previously:



	Do you want to use a file of categories?(y/n) [n]


       o  At this time the user will be asked for category 1 information:



	1. be asked to enter a file name - if file input was selected, or
	      2. be asked to enter the information manually.


       Then the user will be asked for category 2 information:
       Then the user will be asked for category 3 information:
       Then the user will be asked for category n information:


       o    When no entry is provided the program will begin.





NNOOTTEESS
       This manual-page differs from the v.reclass documentation available via
       _g_._m_a_n_u_a_l from the GRASS prompt (Comment WW).



SSEEEE AALLSSOO
       _v_._e_x_t_r_a_c_t

AAUUTTHHOORR
       R.L. Glenn, USDA, SCS, NHQ-CGIS

       _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						      v.reclass.scs(1)
