The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Geo::TigerLine::Record::2 - TIGER/Line 1998 Complete Chain Shape Coordinates

SYNOPSIS

  use Geo::TigerLine::Record::2;

  @records = Geo::TigerLine::Record::2->parse_file($fh);
  @records = Geo::TigerLine::Record::2->parse_file($fh, \&callback);

  $record = Geo::TigerLine::Record::2->new(\%fields);

  $record->rt();
  $record->version();
  $record->tlid();
  $record->rtsq();
  $record->long1();
  $record->lat1();
  $record->long2();
  $record->lat2();
  $record->long3();
  $record->lat3();
  $record->long4();
  $record->lat4();
  $record->long5();
  $record->lat5();
  $record->long6();
  $record->lat6();
  $record->long7();
  $record->lat7();
  $record->long8();
  $record->lat8();
  $record->long9();
  $record->lat9();
  $record->long10();
  $record->lat10();

DESCRIPTION

This is a class representing record type 2 of the TIGER/Line 1998 census geographic database. Each object is one record. It also contains methods to parse TIGER/Line record type 2 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.

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

Record Sequence Number.

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

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

Point 1, Longitude.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

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

Point 1, Latitude.

Expects numeric data of no more than 9 characters. $data cannot be blank and should be right justified.

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

Point 2, Longitude.

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

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

Point 2, Latitude.

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

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

Point 3, Longitude.

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

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

Point 3, Latitude.

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

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

Point 4, Longitude.

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

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

Point 4, Latitude.

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

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

Point 5, Longitude.

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

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

Point 5, Latitude.

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

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

Point 6, Longitude.

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

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

Point 6, Latitude.

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

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

Point 7, Longitude.

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

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

Point 7, Latitude.

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

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

Point 8, Longitude.

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

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

Point 8, Latitude.

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

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

Point 9, Longitude.

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

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

Point 9, Latitude.

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

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

Point 10, Longitude.

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

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

Point 10, Latitude.

Expects numeric data of no more than 9 characters. $data can 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 2 - Complete Chain Shape Coordinates
    
         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
          RTSQ   No    R     N   16   18    3  Record Sequence Number
         LONG1   No    R     N   19   28   10  Point 1, Longitude
          LAT1   No    R     N   29   37    9  Point 1, Latitude
         LONG2  Yes    R     N   38   47   10  Point 2, Longitude
          LAT2  Yes    R     N   48   56    9  Point 2, Latitude
         LONG3  Yes    R     N   57   66   10  Point 3, Longitude
          LAT3  Yes    R     N   67   75    9  Point 3, Latitude
         LONG4  Yes    R     N   76   85   10  Point 4, Longitude
          LAT4  Yes    R     N   86   94    9  Point 4, Latitude
         LONG5  Yes    R     N   95  104   10  Point 5, Longitude
          LAT5  Yes    R     N  105  113    9  Point 5, Latitude
         LONG6  Yes    R     N  114  123   10  Point 6, Longitude
          LAT6  Yes    R     N  124  132    9  Point 6, Latitude
         LONG7  Yes    R     N  133  142   10  Point 7, Longitude
          LAT7  Yes    R     N  143  151    9  Point 7, Latitude
         LONG8  Yes    R     N  152  161   10  Point 8, Longitude
          LAT8  Yes    R     N  162  170    9  Point 8, Latitude
         LONG9  Yes    R     N  171  180   10  Point 9, Longitude
          LAT9  Yes    R     N  181  189    9  Point 9, Latitude
        LONG10  Yes    R     N  190  199   10  Point 10, Longitude
         LAT10  Yes    R     N  200  208    9  Point 10, Latitude
    
    
    

AUTHOR

Michael G Schwern <schwern@pobox.com>

SEE ALSO

Geo::TigerLine, mk_parsers