m.tiger.region(1)	      Grass User's Manual	     m.tiger.region(1)



NNAAMMEE
       mm..ttiiggeerr..rreeggiioonn	-  Finds geographic region information for U.S. Census
       Bureau TIGER input data.
       _(_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..ttiiggeerr..rreeggiioonn
       mm..ttiiggeerr..rreeggiioonn hheellpp
       mm..ttiiggeerr..rreeggiioonn iinnffiillee==_n_a_m_e _[zzoonnee==_v_a_l_u_e] [sspphheerrooiidd==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _m_._t_i_g_e_r_._r_e_g_i_o_n is a program designed to evaluate a file of raw  type  1
       Census (TIGER) data and determine the geographic region covered by that
       input file.  Output is sent to standard out, and gives the east,  west,
       north, and south boundaries for the given input data file.


       If  the	user  specifies  the input file name and (optionally) the zone
       number or spheroid to be used on the command line, the program will run
       non-interactively;  if  no  zone  number or spheroid name is given, the
       default(s) will be used (see below).  Alternately, the user may	simply
       type _m_._t_i_g_e_r_._r_e_g_i_o_n on the command line; in this case, the program will
       prompt the user for parameter values using the  standard  GRASS	parser
       interface described in the manual entry for _p_a_r_s_e_r.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       iinnffiillee==_n_a_m_e
	      Input file name in which raw TIGER data (type 1) are stored.

       zzoonnee==_v_a_l_u_e
	      Universal Transverse Mercator (UTM) zone for this county.
	      Options:	-60 - 60
	      Default:	0

       sspphheerrooiidd==_n_a_m_e
	      Name of spheroid to be used.
	      Default:	clark66


       Available spheroids are:


       australian bessel clark66 clark80 everest international wgs72 wgs84


       It  is  recommended that the user choose the clark66 (default) spheroid
       when dealing with TIGER data as it is  the  most  consistent  with  the
       original data.




EEXXAAMMPPLLEESS
       If the user typed simply:


       mm..ttiiggeerr..rreeggiioonn iinnffiillee==_i_n_p_u_t_f_i_l_e_n_a_m_e



       program output would look similar to this:


       Number of calculated zones is: 2



	    INFO FOR ZONE 1:
	    zone number:	     13
	    percentage of data points
	    in this zone:	     0.799489
	    regional spread of points
	    within this zone:
	    north:		     5092049.155918
	    south:		     5049238.983803
	    east:		     734139.517650
	    west:		     732514.747908

	    INFO FOR ZONE 2:
	    zone number:	     14
	    percentage of data points
	    in this zone:	     99.200508
	    regional spread of points
	    within this zone:
	    north:		     5092041.463966
	    south:		     5036134.342322
	    east:		     398030.217441
	    west:		     265527.656108



       If  the	user  does not input the UTM zone number, it is calculated for
       them.  Then the zone number and region information are output,  and  if
       the program finds that the input data contains information in more than
       one UTM zone, then the output is given for all applicable zones.




       If instead the user supplies the UTM zone number, the output would look
       like that shown below:



	    REGION FOR THIS DATA FILE:;

	    north border:	     5092049.155918
	    south border:	     5036134.342322
	    east border:	     398030.217441
	    west border:	     265527.656108
	    (zone number:	     14)



NNOOTTEESS
       This command must be compiled separately.  It will not automatically be
       included  in  the  compile  of	the   main   GRASS   code.    Although
       _m_._t_i_g_e_r_._r_e_g_i_o_n  does not need a FORTRAN compiler, it is used to support
       other TIGER data functions (like _v_._d_b_._r_i_m , _v_._i_n_._t_i_g_e_r, and _r_i_m)  which
       do require access to a FORTRAN compiler.


       TIGER  data  are  presented  in latitude/longitude format, and are con-
       verted to UTM coordinates using	coordinate  conversion	routines  con-
       tained  in the GRASS library.  If no UTM zone number is supplied by the
       user, the program calculates the appropriate zone(s) based on the input
       data provided.  The output then provides the UTM zone numbers found (if
       more than one), the geographic region covered within each zone, and the
       percentage  of  data  points  found  in	each zone.  The user must then
       decide which of these UTM zones contains the major  or  most  important
       portion of data values, so that the zone number can be supplied in cre-
       ating the GRASS location to hold the imported data and can be  provided
       to  the	importing  program  (_v_._i_n_._t_i_g_e_r).  Zone edges will be extended
       (reasonably) to include data values lying outside the chosen zone.   If
       desired,  _m_._t_i_g_e_r_._r_e_g_i_o_n  can be re-run, supplying the chosen zone num-
       ber, in order to evaluate the region edges of the input data set  (with
       the extended zone).

FFIILLEESS
       Source code for RIM is located under $GISBASE/../src.related/rim


       The RIM Users manual.

       The RIM reference manual.


       Source code for _v_._d_b_._r_i_m
	is located under $GISBASE/../src.garden/grass.rim/ v.db.rim


       Source  code  for  _v_._i_n_._t_i_g_e_r  is  located  under  $GISBASE/../src.gar-
       den/grass.tiger/v.in.tiger


       Source code for _m_._t_i_g_e_r_._r_e_g_i_o_n is  located  under  $GISBASE/../src.gar-
       den/grass.tiger/m.tiger.region

SSEEEE AALLSSOO
       _G_e_n_._M_a_p_s, _G_e_n_._t_r_a_c_t_m_a_p,

       _g_._r_e_g_i_o_n

	_v_._d_b_._r_i_m

       _v_._i_n_._t_i_g_e_r

       r.info

AAUUTTHHOORR
       Marjorie Larson, U.S. Army Construction Engineering Research Laboratory



       _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.tiger.region(1)
