Geo::TigerLine::Record::A(3)

NAME
Geo::TigerLine::Record::A - TIGER/Line 2006 Polygon Geographic Entity Codes: Current Geography

SYNOPSIS
  use Geo::TigerLine::Record::A;

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

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

  $record->rt();
  $record->version();
  $record->file();
  $record->cenid();
  $record->polyid();
  $record->statecu();
  $record->countycu();
  $record->tract();
  $record->block();
  $record->blocksufcu();
  $record->rs_a1();
  $record->aianhhfpcu();
  $record->aianhhcu();
  $record->aihhtlicu();
  $record->anrccu();
  $record->aitscecu();
  $record->aitscu();
  $record->concitcu();
  $record->cousubcu();
  $record->submcdcu();
  $record->placecu();
  $record->sdelmcu();
  $record->sdseccu();
  $record->sdunicu();
  $record->rs_a20();
  $record->rs_a21();
  $record->rs_a22();
  $record->cdcu();
  $record->zcta5cu();
  $record->zcta3cu();
  $record->rs_a4();
  $record->slducu();
  $record->sldlcu();
  $record->rs_a7();
  $record->rs_a8();
  $record->rs_a9();
  $record->cbsacu();
  $record->csacu();
  $record->nectacu();
  $record->cnectacu();
  $record->metdivcu();
  $record->nectadivcu();
  $record->rs_a14();
  $record->uacu();
  $record->urcu();
  $record->rs_a17();
  $record->rs_a18();
  $record->rs_a19();

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

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

    Census File Identification Code.

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

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

    Polygon Identification Code.

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

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

    FIPS State Code, Current.

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

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

    FIPS County Code, Current.

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

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

    Census Tract, 2000.

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

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

    Census Block Number, 2000.

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

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

    Current Suffix for Census 2000 Block Number.

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

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

    Reserved Space A1.

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

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

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

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

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

    Census Code (American Indian/Alaska Native Area/Hawaiian Home Land), Current.

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

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

    American Indian/Hawaiian Home Land Trust Land Indicator, Current.

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

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

    FIPS 55 Code (ANRC), Current.

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

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

    Census Code (American Indian Tribal Subdivision), Current.

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

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

    FIPS 55 Code (American Indian Tribal Subdivision), Current.

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

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

    FIPS 55 Code (Consolidated City), Current.

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

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

    FIPS 55 Code (County Subdivision), Current.

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

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

    FIPS 55 Code (Subbarrio), Current.

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

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

    FIPS 55 Code (Incorporated Place), Current.

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

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

    Elementary School District Code, Current.

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

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

    Secondary School District Code, Current.

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

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

    Unified School District Code, Current.

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

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

    Reserved Space A20.

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

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

    Reserved Space A21.

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

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

    Reserved Space A22.

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

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

    Congressional District Code, Current (108th).

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

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

    5-Digit ZIP Code Tabulation Area, current.

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

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

    3-Digit ZIP Code Tabulation Area, current.

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

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

    Reserved Space A4.

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

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

    State Legislative District Upper, Current (2006).

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

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

    State Legislative District Lower, Current (2006).

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

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

    Reserved Space A7.

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

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

    Reserved Space A8.

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

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

    Reserved Space A9.

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

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

    FIPS Metropolitan Statistical Area/ Micropolitan Statistical Area Code, Current.

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

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

    FIPS Combined Statistical Area Code, Current.

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

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

    FIPS New England City and Town Area Code, Current.

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

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

    FIPS Combined New England City and Town Area Code, Current.

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

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

    FIPS Metropolitan Division Code, Current.

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

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

    FIPS New England City and Town Area Division Code, Current.

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

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

    Reserved Space A14.

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

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

    Urban Area, Current.

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

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

    Urban/Rural Indicator, Current.

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

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

    Reserved Space A17.

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

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

    Reserved Space A18.

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

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

    Reserved Space A19.

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

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

    Record Type A - Polygon Geographic Entity Codes: Current Geography

    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
    CENID      No   L    A   11   15  5  Census File Identification Code
    POLYID     No   R   N    16   25 10  Polygon Identification Code
    STATECU    No   L   N    26   27  2  FIPS State Code, Current
    COUNTYCU   No   L   N    28   30  3  FIPS County Code, Current
    TRACT      No   L    N   31   36  6  Census Tract, 2000
    BLOCK      No   L   N    37   40  4  Census Block Number, 2000
    BLOCKSUFCU Yes  L    A   41   41  1  Current Suffix for Census 2000 Block Number
    RS-A1      Yes  L    A   42   42  1  Reserved Space A1
    AIANHHFPCU Yes  L   N    43   47  5  FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home Land), Current
    AIANHHCU   Yes  L   N    48   51  4  Census Code (American Indian/Alaska Native Area/Hawaiian Home Land), Current
    AIHHTLICU  Yes  L    A   52   52  1  American Indian/Hawaiian Home Land Trust Land Indicator, Current
    ANRCCU     Yes  L    N   53   57  5  FIPS 55 Code (ANRC), Current
    AITSCECU   Yes  L    N   58   60  3  Census Code (American Indian Tribal Subdivision), Current
    AITSCU     Yes  L    N   61   65  5  FIPS 55 Code (American Indian Tribal Subdivision), Current
    CONCITCU   Yes  L   N    66   70  5  FIPS 55 Code (Consolidated City), Current
    COUSUBCU   No   L   N    71   75  5  FIPS 55 Code (County Subdivision), Current
    SUBMCDCU   Yes  L    N   76   80  5  FIPS 55 Code (Subbarrio), Current
    PLACECU    Yes  L    N   81   85  5  FIPS 55 Code (Incorporated Place), Current
    SDELMCU    Yes  L    A   86   90  5  Elementary School District Code, Current
    SDSECCU    Yes  L    A   91   95  5  Secondary School District Code, Current
    SDUNICU    Yes  L    A   96  100  5  Unified School District Code, Current
    RS-A20     Yes  L   N   101  104  4  Reserved Space A20
    RS-A21     Yes  L   N   105  108  4  Reserved Space A21
    RS-A22     Yes  L   N    109 112  4 Reserved Space A22
    CDCU       Yes      R N 113 114  2 Congressional District Code, Current (108th)
    ZCTA5CU    Yes      L A 115 119  5 5-Digit ZIP Code Tabulation Area, current
    ZCTA3CU    Yes      R A 120 122  3 3-Digit ZIP Code Tabulation Area, current
    RS-A4      Yes      R A 123 128  6 Reserved Space A4
    SLDUCU     Yes  R A 129 131  3 State Legislative District Upper, Current (2006)
    SLDLCU     Yes  R A 132 134  3 State Legislative District Lower, Current (2006)
    RS-A7      Yes      R A 135 139  5 Reserved Space A7
    RS-A8      Yes      R A 140 145  6 Reserved Space A8
    RS-A9      Yes      L A 146 151  6 Reserved Space A9
    CBSACU     Yes      L N 152 156  5 FIPS Metropolitan Statistical Area/ Micropolitan Statistical Area Code, Current
    CSACU      Yes      L N 157 159  3 FIPS Combined Statistical Area Code, Current
    NECTACU    Yes      L N 160 164  5 FIPS New England City and Town Area Code, Current
    CNECTACU   Yes      L N 165 167  3 FIPS Combined New England City and Town Area Code, Current
    METDIVCU   Yes L N 168 172  5 FIPS Metropolitan Division Code, Current
    NECTADIVCU Yes L N 173 177  5 FIPS New England City and Town Area Division Code, Current
    RS-A14     Yes L A 178 181  4 Reserved Space A14
    UACU       Yes L N 182 186  5 Urban Area, Current
    URCU       Yes L A 187 187  1 Urban/Rural Indicator, Current
    RS-A17     Yes L A 188 193  6 Reserved Space A17
    RS-A18     Yes L A 194 199  6 Reserved Space A18
    RS-A19     Yes L A 200 210 11 Reserved Space A19

AUTHOR
Michael G Schwern <schwern@pobox.com>

SEE ALSO
Geo::TigerLine, mk_parsers