NAME
Geo::TigerLine::Record::1 - TIGER/Line 1998 Complete Chain Basic Data Record
SYNOPSIS
use Geo::TigerLine::Record::1;
@records = Geo::TigerLine::Record::1->parse_file($fh);
@records = Geo::TigerLine::Record::1->parse_file($fh, \&callback);
$record = Geo::TigerLine::Record::1->new(\%fields);
$record->rt();
$record->version();
$record->tlid();
$record->side1();
$record->source();
$record->fedirp();
$record->fename();
$record->fetype();
$record->fedirs();
$record->cfcc();
$record->fraddl();
$record->toaddl();
$record->fraddr();
$record->toaddr();
$record->friaddl();
$record->toiaddl();
$record->friaddr();
$record->toiaddr();
$record->zipl();
$record->zipr();
$record->fairl();
$record->fairr();
$record->trustl();
$record->trustr();
$record->census1();
$record->census2();
$record->statel();
$record->stater();
$record->countyl();
$record->countyr();
$record->fmcdl();
$record->fmcdr();
$record->fsmcdl();
$record->fsmcdr();
$record->fpll();
$record->fplr();
$record->ctl();
$record->ctr();
$record->blkl();
$record->blkr();
$record->frlong();
$record->frlat();
$record->tolong();
$record->tolat();
DESCRIPTION
This is a class representing record type 1 of the TIGER/Line 1998 census geographic database. Each object is one record. It also contains methods to parse TIGER/Line record type 1 files and turn them into objects.
This is intended as an intermediate format between pulling the raw data out of the simplistic TIGER/Line data files into something more sophisticated (a process you should only have to do once). As such, its not very fast, but its careful, easy to use and performs some verifications on the data being read.
As this class is autogenerated by mk_parsers, think before you modify this file. Its OO, so consider sub-classing instead.
Accessors
These are simple get/set accessors for each field of a record generated from the TIGER/Line 1998 data dictionary. They perform some data validation.
- rt
-
$data = $record->rt(); $record->rt($data);
Record Type.
Expects alphanumeric data of no more than 1 characters. $data cannot be blank and should be left justified.
- version
-
$data = $record->version(); $record->version($data);
Version Number.
Expects numeric data of no more than 4 characters. $data cannot be blank and should be left justified.
- tlid
-
$data = $record->tlid(); $record->tlid($data);
TIGER/Line ID, Permanent Record Number.
Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.
- side1
-
$data = $record->side1(); $record->side1($data);
Single-Side Complete Chain Code.
Expects numeric data of no more than 1 characters. $data can be blank and should be right justified.
- source
-
$data = $record->source(); $record->source($data);
Linear Segment Source Code.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- fedirp
-
$data = $record->fedirp(); $record->fedirp($data);
Feature Direction, Prefix.
Expects alphanumeric data of no more than 2 characters. $data can be blank and should be left justified.
- fename
-
$data = $record->fename(); $record->fename($data);
Feature Name.
Expects alphanumeric data of no more than 30 characters. $data can be blank and should be left justified.
- fetype
-
$data = $record->fetype(); $record->fetype($data);
Feature Type.
Expects alphanumeric data of no more than 4 characters. $data can be blank and should be left justified.
- fedirs
-
$data = $record->fedirs(); $record->fedirs($data);
Feature Direction, Suffix.
Expects alphanumeric data of no more than 2 characters. $data can be blank and should be left justified.
- cfcc
-
$data = $record->cfcc(); $record->cfcc($data);
Census Feature Class Code.
Expects alphanumeric data of no more than 3 characters. $data can be blank and should be left justified.
- fraddl
-
$data = $record->fraddl(); $record->fraddl($data);
Start Address, Left.
Expects alphanumeric data of no more than 11 characters. $data can be blank and should be right justified.
- toaddl
-
$data = $record->toaddl(); $record->toaddl($data);
End Address, Left.
Expects alphanumeric data of no more than 11 characters. $data can be blank and should be right justified.
- fraddr
-
$data = $record->fraddr(); $record->fraddr($data);
Start Address, Right.
Expects alphanumeric data of no more than 11 characters. $data can be blank and should be right justified.
- toaddr
-
$data = $record->toaddr(); $record->toaddr($data);
End Address, Right.
Expects alphanumeric data of no more than 11 characters. $data can be blank and should be right justified.
- friaddl
-
$data = $record->friaddl(); $record->friaddl($data);
Start Imputed Address Flag, Left.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- toiaddl
-
$data = $record->toiaddl(); $record->toiaddl($data);
End Imputed Address Flag, Left.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- friaddr
-
$data = $record->friaddr(); $record->friaddr($data);
Start Imputed Address Flag, Right.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- toiaddr
-
$data = $record->toiaddr(); $record->toiaddr($data);
End Imputed Address Flag, Right.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- zipl
-
$data = $record->zipl(); $record->zipl($data);
ZIP Code, Left.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- zipr
-
$data = $record->zipr(); $record->zipr($data);
ZIP Code, Right.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fairl
-
$data = $record->fairl(); $record->fairl($data);
FIPS 55 Code (American Indian/Alaska Native Area), Current Left.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fairr
-
$data = $record->fairr(); $record->fairr($data);
FIPS 55 Code (American Indian/Alaska Native Area), Current Right.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- trustl
-
$data = $record->trustl(); $record->trustl($data);
American Indian Trust Land Flag, Current Left.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- trustr
-
$data = $record->trustr(); $record->trustr($data);
American Indian Trust Land Flag, Current Right.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- census1
-
$data = $record->census1(); $record->census1($data);
Census Use 1.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- census2
-
$data = $record->census2(); $record->census2($data);
Census Use 2.
Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.
- statel
-
$data = $record->statel(); $record->statel($data);
FIPS State Code, Current Left.
Expects numeric data of no more than 2 characters. $data can be blank and should be left justified.
- stater
-
$data = $record->stater(); $record->stater($data);
FIPS State Code, Current Right.
Expects numeric data of no more than 2 characters. $data can be blank and should be left justified.
- countyl
-
$data = $record->countyl(); $record->countyl($data);
FIPS County Code, Current Left.
Expects numeric data of no more than 3 characters. $data can be blank and should be left justified.
- countyr
-
$data = $record->countyr(); $record->countyr($data);
FIPS County Code, Current Right.
Expects numeric data of no more than 3 characters. $data can be blank and should be left justified.
- fmcdl
-
$data = $record->fmcdl(); $record->fmcdl($data);
FIPS 55 Code (MCD/CCD) Left, Current.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fmcdr
-
$data = $record->fmcdr(); $record->fmcdr($data);
FIPS 55 Code (MCD/CCD) Right, Current.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fsmcdl
-
$data = $record->fsmcdl(); $record->fsmcdl($data);
FIPS 55 Code (Sub-MCD), Current Left.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fsmcdr
-
$data = $record->fsmcdr(); $record->fsmcdr($data);
FIPS 55 Code (Sub-MCD), Current Right.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fpll
-
$data = $record->fpll(); $record->fpll($data);
FIPS 55 Code (Incorporated Place), Current Left.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- fplr
-
$data = $record->fplr(); $record->fplr($data);
FIPS 55 Code (Incorporated Place), Current Right.
Expects numeric data of no more than 5 characters. $data can be blank and should be left justified.
- ctl
-
$data = $record->ctl(); $record->ctl($data);
Census Tract Code, 1990 Left.
Expects numeric data of no more than 6 characters. $data can be blank and should be left justified.
- ctr
-
$data = $record->ctr(); $record->ctr($data);
Census Tract Code, 1990 Right.
Expects numeric data of no more than 6 characters. $data can be blank and should be left justified.
- blkl
-
$data = $record->blkl(); $record->blkl($data);
Census Block Number, 1990 Left.
Expects alphanumeric data of no more than 4 characters. $data can be blank and should be left justified.
- blkr
-
$data = $record->blkr(); $record->blkr($data);
Census Block Number, 1990 Right.
Expects alphanumeric data of no more than 4 characters. $data can be blank and should be left justified.
- frlong
-
$data = $record->frlong(); $record->frlong($data);
Start Longitude.
Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.
- frlat
-
$data = $record->frlat(); $record->frlat($data);
Start Latitude.
Expects numeric data of no more than 9 characters. $data cannot be blank and should be right justified.
- tolong
-
$data = $record->tolong(); $record->tolong($data);
End Longitude.
Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.
- tolat
-
$data = $record->tolat(); $record->tolat($data);
End Latitude.
Expects numeric data of no more than 9 characters. $data cannot be blank and should be right justified.
Data dictionary
This is the original TIGER/Line 1998 data dictionary from which this class was generated.
Record Type 1 - Complete Chain Basic Data Record
Field BV Fmt Type Beg End Len Description
RT No L A 1 1 1 Record Type
VERSION No L N 2 5 4 Version Number
TLID No R N 6 15 10 TIGER/Line ID, Permanent Record Number
SIDE1 Yes R N 16 16 1 Single-Side Complete Chain Code
SOURCE Yes L A 17 17 1 Linear Segment Source Code
FEDIRP Yes L A 18 19 2 Feature Direction, Prefix
FENAME Yes L A 20 49 30 Feature Name
FETYPE Yes L A 50 53 4 Feature Type
FEDIRS Yes L A 54 55 2 Feature Direction, Suffix
CFCC Yes L A 56 58 3 Census Feature Class Code
FRADDL Yes R A 59 69 11 Start Address, Left
TOADDL Yes R A 70 80 11 End Address, Left
FRADDR Yes R A 81 91 11 Start Address, Right
TOADDR Yes R A 92 102 11 End Address, Right
FRIADDL Yes L A 103 103 1 Start Imputed Address Flag, Left
TOIADDL Yes L A 104 104 1 End Imputed Address Flag, Left
FRIADDR Yes L A 105 105 1 Start Imputed Address Flag, Right
TOIADDR Yes L A 106 106 1 End Imputed Address Flag, Right
ZIPL Yes L N 107 111 5 ZIP Code, Left
ZIPR Yes L N 112 116 5 ZIP Code, Right
FAIRL Yes L N 117 121 5 FIPS 55 Code (American Indian/Alaska Native Area), Current Left
FAIRR Yes L N 122 126 5 FIPS 55 Code (American Indian/Alaska Native Area), Current Right
TRUSTL Yes L A 127 127 1 American Indian Trust Land Flag, Current Left
TRUSTR Yes L A 128 128 1 American Indian Trust Land Flag, Current Right
CENSUS1 Yes L A 129 129 1 Census Use 1
CENSUS2 Yes L A 130 130 1 Census Use 2
STATEL Yes L N 131 132 2 FIPS State Code, Current Left
STATER Yes L N 133 134 2 FIPS State Code, Current Right
COUNTYL Yes L N 135 137 3 FIPS County Code, Current Left
COUNTYR Yes L N 138 140 3 FIPS County Code, Current Right
FMCDL Yes L N 141 145 5 FIPS 55 Code (MCD/CCD) Left, Current
FMCDR Yes L N 146 150 5 FIPS 55 Code (MCD/CCD) Right, Current
FSMCDL Yes L N 151 155 5 FIPS 55 Code (Sub-MCD), Current Left
FSMCDR Yes L N 156 160 5 FIPS 55 Code (Sub-MCD), Current Right
FPLL Yes L N 161 165 5 FIPS 55 Code (Incorporated Place), Current Left
FPLR Yes L N 166 170 5 FIPS 55 Code (Incorporated Place), Current Right
CTL Yes L N 171 176 6 Census Tract Code, 1990 Left
CTR Yes L N 177 182 6 Census Tract Code, 1990 Right
BLKL Yes L A 183 186 4 Census Block Number, 1990 Left
BLKR Yes L A 187 190 4 Census Block Number, 1990 Right
FRLONG No R N 191 200 10 Start Longitude
FRLAT No R N 201 209 9 Start Latitude
TOLONG No R N 210 219 10 End Longitude
TOLAT No R N 220 228 9 End Latitude
AUTHOR
Michael G Schwern <schwern@pobox.com>