m.lulc.USGS(1)		      Grass User's Manual		m.lulc.USGS(1)



NNAAMMEE
       _m_._l_u_l_c_._U_S_G_S   -	Creates  raster map layers from a Composite Theme Grid
       (CTG) file created by _m_._l_u_l_c_._r_e_a_d .  _m_._l_u_l_c_._r_e_a_d extracts the CTG  data
       from  an ASCII landuse/landcover (lulc) CTG format file supplied by the
       USGS.
       _(_G_R_A_S_S _D_a_t_a _I_m_p_o_r_t_/_P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       mm..lluullcc..UUSSGGSS _i_n_p_u_t___f_i_l_e

DDEESSCCRRIIPPTTIIOONN
       _m_._l_u_l_c_._U_S_G_S creates the following raster map layers from the  CTG  file
       created	by  _m_._l_u_l_c_._r_e_a_d  ,  and  places  them  into the user's current
       mapset:


       1. Land Use & Land Cover
       2. Political Units
       3. Census Units
       4. Hydrologic Units
       5. Federal Land Ownership
       6. State Land Ownership



       Since the CTG  file  may  not  contain  all  of	layers	listed	above,
       _m_._l_u_l_c_._U_S_G_S  will extract only the raster map layers which exist in the
       CTG file.


       The CTG file contains all of the geographic region definition  informa-
       tion necessary for creating the raster map layers, including:


       1.  Grid Zone
       2.  Projection Type (UTM)
       3.  Cell Resolution (ew_res = nw_res)
       4.  Multi-byte data formation
       5.  Geographic region coordinates



       _m_._l_u_l_c_._U_S_G_S  will use the geographic region information definition sup-
       plied with the CTG file and NOT the geographic region  definition  cur-
       rently  set for the user's mapset; (note that this is different than is
       the case with many of the other GRASS map development commands).


       When _m_._l_u_l_c_._U_S_G_S is executed, it will check the file  for  a  specified
       layer  and  then  ask  the  user if he wishes to extract the associated
       raster map layer.  The user is then prompted for  the  name  of	a  new
       raster  file  in  which	output is to be placed.  _m_._l_u_l_c_._U_S_G_S will then
       create this raster  file  and  all  supporting  (e.g.,  category,  cell
       header, color table, etc.) files.

EEXXAAMMPPLLEE
       In  the	example below, raster data is extracted from a CTG file (named
       _l_u_l_c) that contains only LAND USE/LAND COVER data:


       mm..lluullcc..UUSSGGSS lluullcc
	    MAP TITLE: DODGE CITY, KS 1:250,000 LU, PB, CN, HU, FO
	    The Composite Theme Grid file contains <1> overlays
	    and has a map code type of <01>

	    Do you Wish to Create <LAND USE/LAND COVER> Raster File (y/n)  [y]
       yy

	    Enter File Name for LAND USE/LAND COVER Overlay
	    Enter 'list' for a list of existing raster files
	    Hit RETURN to cancel request

	    > llaanndduussee


	    Creating <landuse> from <LAND USE/LAND COVER> Overlay: 95%
	    Number of Categories: 76  (UNLABELED)
	    Writing Cell Header Information
	    Writing Color Table Information

	    Conversion is Complete


BBUUGGSS
       _m_._l_u_l_c_._U_S_G_S  does  not  currently extract Census unit data.  Also, only
       the cataloging unit is extracted from the CTG file (see	the  _L_a_n_d  _U_s_e
       _a_n_d _L_a_n_d _C_o_v_e_r _D_a_t_a _U_s_e_r_'_s _G_u_i_d_e supplied by the USGS).

SSEEEE AALLSSOO
       USGS LLaanndd UUssee aanndd LLaanndd CCoovveerr DDaattaa UUsseerr''ss GGuuiiddee


	_g_._r_e_g_i_o_n

	_m_._l_u_l_c_._r_e_a_d

AAUUTTHHOORR
       Kenneth Shepardson Spectrum Sciences & Software, Inc.  (904) 862-3031

       _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_3 _$



GRASS 5.0							m.lulc.USGS(1)
