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 geo-
       graphic 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 pro-
       gram 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 cal-
       culated for them.  Then the zone number and region  infor-
       mation 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 out-
       put 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 converted to UTM coordinates using coordinate  conver-
       sion  routines  contained in the GRASS library.	If no UTM
       zone number is supplied by the user,  the  program  calcu-
       lates the appropriate zone(s) based on the input data pro-
       vided.  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
       creating 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
       number, in order to evaluate the region edges of the input
       data set (with the extended zone).

FFIILLEESS
       Source	code   for   RIM   is	located    under    $GIS-
       BASE/../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   $GIS-
       BASE/../src.garden/grass.tiger/v.in.tiger


       Source  code  for  _m_._t_i_g_e_r_._r_e_g_i_o_n  is  located under $GIS-
       BASE/../src.garden/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 _$



