Geo::TigerLine::Record::1--3pm

Geo::TigerLine::RecordUser3Contributed Perl DocuGeo::TigerLine::Record::1(3pm)



NAME
       Geo::TigerLine::Record::1 - TIGER/Line 2003 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->aianhhfpl();
         $record->aianhhfpr();
         $record->aihhtlil();
         $record->aihhtlir();
         $record->census1();
         $record->census2();
         $record->statel();
         $record->stater();
         $record->countyl();
         $record->countyr();
         $record->cousubl();
         $record->cousubr();
         $record->submcdl();
         $record->submcdr();
         $record->placel();
         $record->placer();
         $record->tractl();
         $record->tractr();
         $record->blockl();
         $record->blockr();
         $record->frlong();
         $record->frlat();
         $record->tolong();
         $record->tolat();

DESCRIPTION
       This is a class representing record type 1 of the TIGER/Line 2003 cen-
       sus 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 sophis-
       ticated (a process you should only have to do once).  As such, it's 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.  It's OO, so consider sub-classing instead.

       Accessors

       These are simple get/set accessors for each field of a record generated
       from the TIGER/Line 2003 data dictionary.  They perform some data vali-
       dation.

       rt
               $data = $record->rt();
               $record->rt($data);

           Record Type.

           Expects alphanumeric data of no more than 1 characters.  $data can-
           not 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 1-Cell 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 Source 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-
           not 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.

       aianhhfpl
               $data = $record->aianhhfpl();
               $record->aianhhfpl($data);

           FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home
           Land), 2000 Left.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       aianhhfpr
               $data = $record->aianhhfpr();
               $record->aianhhfpr($data);

           FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home
           Land), 2000 Right.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       aihhtlil
               $data = $record->aihhtlil();
               $record->aihhtlil($data);

           American Indian/Hawaiian Home Land Trust Land Indicator, 2000 Left.

           Expects alphanumeric data of no more than 1 characters.  $data can
           be blank and should be left justified.

       aihhtlir
               $data = $record->aihhtlir();
               $record->aihhtlir($data);

           American Indian/Hawaiian Home Land Trust Land Indicator, 2000
           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, 2000 Left (always filled both sides, except at
           U.S. boundaries).

           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, 2000 Right (always filled both sides, except at
           U.S. boundaries).

           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, 2000 Left (always filled both sides, except at
           U.S. boundaries).

           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, 2000 Right (always filled both sides, except at
           U.S. boundaries).

           Expects numeric data of no more than 3 characters.  $data can be
           blank and should be left justified.

       cousubl
               $data = $record->cousubl();
               $record->cousubl($data);

           FIPS 55 Code (County Subdivision), 2000 Left.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       cousubr
               $data = $record->cousubr();
               $record->cousubr($data);

           FIPS 55 Code (County Subdivision), 2000 Right.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       submcdl
               $data = $record->submcdl();
               $record->submcdl($data);

           FIPS 55 Code (Subbarrio), 2000 Left.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       submcdr
               $data = $record->submcdr();
               $record->submcdr($data);

           FIPS 55 Code (Subbarrio), 2000 Right.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       placel
               $data = $record->placel();
               $record->placel($data);

           FIPS 55 Code (Place/CDP), 2000 Left.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       placer
               $data = $record->placer();
               $record->placer($data);

           FIPS 55 Code (Place/CDP), 2000 Right.

           Expects numeric data of no more than 5 characters.  $data can be
           blank and should be left justified.

       tractl
               $data = $record->tractl();
               $record->tractl($data);

           Census Tract, 2000 Left.

           Expects numeric data of no more than 6 characters.  $data can be
           blank and should be left justified.

       tractr
               $data = $record->tractr();
               $record->tractr($data);

           Census Tract, 2000 Right.

           Expects numeric data of no more than 6 characters.  $data can be
           blank and should be left justified.

       blockl
               $data = $record->blockl();
               $record->blockl($data);

           Census Block Number, 2000 Left.

           Expects numeric data of no more than 4 characters.  $data can be
           blank and should be left justified.

       blockr
               $data = $record->blockr();
               $record->blockr($data);

           Census Block Number, 2000 Right.

           Expects numeric 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 2003 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 1-Cell Number
           SIDE1     Yes  R   N   16   16  1  Single-Side Source 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      No   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
           AIANHHFPR Yes  L   N  122  126  5  FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home Land), 2000 Right
           AIANHHFPL Yes  L   N  117  121  5  FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home Land), 2000 Left
           AIHHTLIL Yes  L   A   127  127   1 American Indian/Hawaiian Home Land Trust Land Indicator, 2000 Left
           AIHHTLIR Yes  L   A   128  128   1 American Indian/Hawaiian Home Land Trust Land Indicator, 2000 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, 2000 Left (always filled both sides, except at U.S. boundaries)
           STATER   Yes  L   N   133  134   2 FIPS State Code, 2000 Right (always filled both sides, except at U.S. boundaries)
           COUNTYL  Yes  L   N   135  137   3 FIPS County Code, 2000 Left (always filled both sides, except at U.S. boundaries)
           COUNTYR  Yes  L   N   138  140   3 FIPS County Code, 2000 Right (always filled both sides, except at U.S. boundaries)
           COUSUBL  Yes  L   N   141  145   5 FIPS 55 Code (County Subdivision), 2000 Left
           COUSUBR  Yes  L   N   146  150   5 FIPS 55 Code (County Subdivision), 2000 Right
           SUBMCDL  Yes  L   N   151  155   5 FIPS 55 Code (Subbarrio), 2000 Left
           SUBMCDR  Yes  L   N   156  160   5 FIPS 55 Code (Subbarrio), 2000 Right
           PLACEL   Yes  L   N   161  165   5 FIPS 55 Code (Place/CDP), 2000 Left
           PLACER   Yes  L   N   166  170   5 FIPS 55 Code (Place/CDP), 2000 Right
           TRACTL   Yes  L   N   171  176   6 Census Tract, 2000 Left
           TRACTR   Yes  L   N   177  182   6 Census Tract, 2000 Right
           BLOCKL   Yes  L   N   183  186   4 Census Block Number, 2000 Left
           BLOCKR   Yes  L   N   187  190   4 Census Block Number, 2000 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 AT pobox.com>

SEE ALSO
       Geo::TigerLine, mk_parsers



perl v5.8.7                       2004-05-11    Geo::TigerLine::Record::1(3pm)