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



NNAAMMEE
       vv..rreeccllaassss   - Changes vector category values for an exist-
       ing 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 reclassification of an existing  vector  map.   The
       user provides the program with a category conversion file,
       input vector map name, an output vector 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 con-
       verted 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' boundaries 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)
