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 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 defini-
       tion  information  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  supplied  with  the	CTG file and NOT the geo-
       graphic region definition currently  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>  Over-
       lay: 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)
