Geo::TigerLine::Record::I(3p)

NAME
Geo::TigerLine::Record::I - TIGER/Line 2003 Link Between Complete Chains and Polygons

SYNOPSIS
  use Geo::TigerLine::Record::I;

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

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

  $record->rt();
  $record->version();
  $record->file();
  $record->tlid();
  $record->tzids();
  $record->tzide();
  $record->cenidl();
  $record->polyidl();
  $record->cenidr();
  $record->polyidr();
  $record->source();
  $record->ftseg();
  $record->rs_i1();
  $record->rs_i2();
  $record->rs_i3();

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

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

    File Code.

    Expects numeric data of no more than 5 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.

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

    TIGER ID, Start, Permanent Zero-Cell Number.

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

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

    TIGER ID, End, Permanent Zero-Cell Number.

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

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

    Census File Identification Code, Left.

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

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

    Polygon Identification Code, Left.

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

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

    Census File Identification Code, Right.

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

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

    Polygon Identification Code, Right.

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

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

    TIGER 1-Cell Source Code.

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

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

    FTSeg ID (AAAAA.O.XXXXXXXXX) (Authority-S-ID) FGDC Transportation ID Standard (not filled).

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

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

    Reserved Space I1.

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

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

    Reserved Space I2.

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

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

    Reserved Space I3.

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

  Data dictionary
This is the original TIGER/Line 2003 data dictionary from which this class was generated.

    Record Type I - Link Between Complete Chains and Polygons

    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
    FILE    No   L   N     6  10  5  File Code
    TLID    No   R   N    11  20 10  TIGER/Line ID, Permanent 1-Cell Number
    TZIDS   No   R   N    21  30 10  TIGER ID, Start, Permanent Zero-Cell Number
    TZIDE   No   R   N    31  40 10  TIGER ID, End, Permanent Zero-Cell Number
    CENIDL  Yes  L   A    41  45  5  Census File Identification Code, Left
    POLYIDL Yes  R   N    46  55 10  Polygon Identification Code, Left
    CENIDR  Yes  L   A    56  60  5  Census File Identification Code, Right
    POLYIDR Yes  R   N    61  70 10  Polygon Identification Code, Right
    SOURCE  Yes  L   A    71  80 10  TIGER 1-Cell Source Code
    FTSEG   Yes  L   A    81  97 17  FTSeg ID (AAAAA.O.XXXXXXXXX) (Authority-S-ID) FGDC Transportation ID Standard (not filled)
    RS-I1   Yes  L   A    98 107 10  Reserved Space I1
    RS-I2   Yes  L   A   108 117 10  Reserved Space I2
    RS-I3   Yes  L   A   118 127 10  Reserved Space I3

AUTHOR
Michael G Schwern <schwern@pobox.com>

SEE ALSO
Geo::TigerLine, mk_parsers