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.  Typi-
       cally, 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 termination charac-
       ter(s) at the end of each line in the input files.  , ,	neither,  one,
       or  both  are acceptable.  Different 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.	Detec-
       tion, 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  num-
       ber  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	infor-
       mation  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 program 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 system, 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  sub-
       sets 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)
