v.in.tig.basic(1)      Grass User's Manual	v.in.tig.basic(1)



NNAAMMEE
       vv..iinn..ttiigg..bbaassiicc  - Create GRASS vector map from TIGER files
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..iinn..ttiigg..bbaassiicc vv..iinn..ttiigg..bbaassiicc hheellpp

       vv..iinn..ttiigg..bbaassiicc  [[--ppqqtt]]  tt11==_T_I_G_E_R_._1   tt22==_T_I_G_E_R_._2	 oouutt==_n_a_m_e
       [zzoonnee==_u_t_m___z_o_n_e]
	      [sspphheerrooiidd==_s_p_h_e_r_o_i_d] [ttlliidd==_f_i_l_e]



DDEESSCCRRIIPPTTIIOONN
       This program creates a GRASS vector  map  in  the  current
       mapset (UTM or Lat-Long locations only) with labelled line
       segments constructed from the end points (nodes) from  the
       Type 1 TIGER file records and shape points from the Type 2
       TIGER file.  The nodes and shape points are matched by the
       TIGER  record  number  (TLID  field).   In  the	attribute
       (label) file which is built (in	the  _d_i_g___a_t_t  directory),
       the  lines  are	given  the  "area boundary" type and line
       labels are the record numbers (9 digits!).


       The Type 1 file may contain the	records  for  a  complete
       county, a subset for a county, or those from more than one
       county concatenated.  The Type 2  file  must  contain  all
       those records corresponding to the Type 1 records, but may
       contain extra records which will not be used.   Typically,
       a  subset of Type 1 records is used and a full county Type
       2 file is used.


       The program should function well independent of the termi-
       nation  character(s)  at the end of each line in the input
       files.  , , neither, one, or both are acceptable.  Differ-
       ent  distribution  media  apparently have different record
       delimiting characters.


       The -p flag should not normally be used.   It  causes  the
       program	to build a disk file pointer table for all of the
       Type 2 records each time the  program  runs,  rather  than
       using  the  table built previously.  Detection, naming and
       verification of the pointer file  are  automatic.   It  is
       created in the "tmp" space in the user's location.



OOPPTTIIOONNSS
       FFllaaggss::

       --pp     Create new disk file for Type 2 pointers every time

       --qq     Perform functions quietly

       --tt     Build topology (dig_plus) file when done (can't  be
	      quiet)



       PPaarraammeetteerrss



       tt11==_n_a_m_e
	      TIGER Type 1 path/file name

       tt22==_n_a_m_e
	      TIGER Type 2 path/file name

       oouutt==_n_a_m_e
	      Name of vector map to create

       zzoonnee==_v_a_l_u_e
	      UTM zone number; default is location zone

	      options: 1-60

	      default: (current zone)

       sspphheerrooiidd==_k_e_y_w_o_r_d
	      Spheroid for LL to UTM conversion; see m.gc.ll

	      default: clark66

       ttlliidd==_n_a_m_e
	      Path/file  for list of TLID numbers to process from
	      TIGER.1 File

	      default: nonE


TTHHEE ttlliidd PPAARRAAMMEETTEERR
       The file specified by the _t_l_i_d parameter  may  be  of  any
       size.   Any  number  at	the  beginning	of a line will be
       interpreted to be the TLID of a Type 1 record which is  to
       be included in the output map.  Other information on these
       lines is ignored, as are lines which do not begin  with	a
       number.	 If  fewer than 5000 numbers are in this file, it
       is only read once and execution speed is greatly enhanced.
       Normally,  a  full Type 1 file will be specified by the _t_1
       parameter when a _t_l_i_d file is used.





BBUUGGSS//RREESSTTRRIICCTTIIOONNSS
       CCaauuttiioonn:: This program will overwrite  an  existing  vector
       map of the same name without warning.


       The  Type  2  input  file  must	be on a device capable of
       "seeking," i.e., not a tape drive. CD-ROM is OK (but  pro-
       gram will run much faster from disk files).


       Input  lines  in a _t_l_i_d file are limited to 300 characters
       in length.  If the system can allocate space to store  all
       the TLID numbers read from this file, it is only read once
       and execution speed is greatly enhanced; on a typical sys-
       tem,  space for more than 10,000 numbers can be allocated.

SSEEEE AALLSSOO
       _v_._a_p_p_l_y_._c_e_n_s_u_s
	will generate polygon labels  for  Census  tracts,  block
       groups, etc., from STF1 or PL94-171 files.

       _m_._i_n_._s_t_f_1_._t_a_p_e
	and/or unix text tools can be used to extract/concatenate
       useful subsets of TIGER Type 1 records  prior  to  running
       vv..iinn..ttiigg..bbaassiicc.



AAUUTTHHOORR
       Dr.  James  Hinthorne,  GIS Laboratory, Central Washington
       University

       _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.in.tig.basic(1)
