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

NAME
Geo::TigerLine::Record::S - TIGER/Line 2006 Polygon Additional Geographic Entity Codes

SYNOPSIS
  use Geo::TigerLine::Record::S;

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

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

  $record->rt();
  $record->version();
  $record->file();
  $record->cenid();
  $record->polyid();
  $record->state();
  $record->county();
  $record->tract();
  $record->block();
  $record->blkgrp();
  $record->aianhhfp();
  $record->aianhh();
  $record->aihhtli();
  $record->anrc();
  $record->aitsce();
  $record->aits();
  $record->concit();
  $record->cousub();
  $record->submcd();
  $record->place();
  $record->sdelm();
  $record->sdsec();
  $record->sduni();
  $record->msacmsa();
  $record->pmsa();
  $record->necma();
  $record->cd106();
  $record->cd108();
  $record->puma5();
  $record->puma1();
  $record->zcta5();
  $record->zcta3();
  $record->taz();
  $record->tazcomb();
  $record->ua();
  $record->ur();
  $record->vtd();
  $record->sldu();
  $record->sldl();
  $record->uga();

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

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

    FIPS State Code, 2000.

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

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

    FIPS County Code, 2000.

    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.

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

    Census Block Group, 2000.

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

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

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

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

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

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

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

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

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

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

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

    FIPS 55 Code (ANRC), 2000.

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

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

    Census Code (American Indian Tribal Subdivision), 2000.

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

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

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

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

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

    FIPS 55 Code (Consolidated City), 2000.

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

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

    FIPS 55 Code (County Subdivision), 2000.

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

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

    FIPS 55 Code (Subbarrio), 2000.

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

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

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

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

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

    Elementary School District Code, 2000.

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

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

    Secondary School District Code, 2000.

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

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

    Unified School District Code, 2000.

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

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

    FIPS Consolidated Metropolitan Statistical Area/Metropolitan Statistical Area Code, 2000.

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

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

    FIPS Primary Metropolitan Statistical Area Code, 2000.

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

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

    FIPS New England County Metropolitan Area (NECMA) Code, 2000.

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

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

    Congressional District Code, 106th.

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

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

    Congressional District Code, 108th.

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

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

    Public Use Microdata Area 5% File, 2000.

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

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

    Public Use Microdata Area 1% File, 2000.

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

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

    5-Digit ZIP Code Tabulation Area, 2000.

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

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

    3-Digit ZIP Code Tabulation Area, 2000.

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

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

    Traffic Analysis Zone Code, 2000.

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

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

    Traffic Analysis Zone Code-State Combined, 2000 (not filled).

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

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

    Urban Area, 2000.

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

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

    Urban/Rural Indicator, 2000.

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

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

    Census Voting District Code, 2000.

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

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

    State Legislative District Code (Upper Chamber), 2000.

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

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

    State Legislative District Code (Lower Chamber), 2000.

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

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

    Oregon Urban Growth Area, 2000.

    Expects alphanumeric data of no more than 5 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 S - Polygon Additional Geographic Entity Codes

    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
    STATE    No    L  N    26  27   2 FIPS State Code, 2000
    COUNTY   No    L  N    28  30   3 FIPS County Code, 2000
    TRACT    No    L  N    31  36   6 Census Tract, 2000
    BLOCK    No    L  N    37  40   4 Census Block Number, 2000
    BLKGRP   No    L  N    41  41   1 Census Block Group, 2000
    AIANHHFP Yes   L  N    42  46   5 FIPS 55 Code (American Indian/Alaska Native Area/Hawaiian Home Land), 2000
    AIANHH   Yes   L  N    47  50   4 Census Code (American Indian/ Alaska Native Area/Hawaiian Home Land), 2000
    AIHHTLI  Yes   L  A    51  51   1 American Indian/Hawaiian Home Land Trust Land Indicator, 2000
    ANRC     Yes   L  N    52  56   5 FIPS 55 Code (ANRC), 2000
    AITSCE   Yes   L  N    57  59   3 Census Code (American Indian Tribal Subdivision), 2000
    AITS     Yes   L  N    60  64   5 FIPS 55 Code (American Indian Tribal Subdivision), 2000
    CONCIT   Yes   L  N    65  69   5 FIPS 55 Code (Consolidated City), 2000
    COUSUB   No    L  N    70  74   5 FIPS 55 Code (County Subdivision), 2000
    SUBMCD   Yes   L  N    75  79   5 FIPS 55 Code (Subbarrio), 2000
    PLACE    Yes   L  N    80  84   5 FIPS 55 Code (Incorporated Place/CDP), 2000
    SDELM    Yes   L  N    85  89   5 Elementary School District Code, 2000
    SDSEC    Yes   L  N    90  94   5 Secondary School District Code, 2000
    SDUNI    Yes  L   N    95  99   5 Unified School District Code, 2000
    MSACMSA  Yes  L   N   100 103   4 FIPS Consolidated Metropolitan Statistical Area/Metropolitan Statistical Area Code, 2000
    PMSA     Yes  L   N   104 107   4 FIPS Primary Metropolitan Statistical Area Code, 2000
    NECMA    Yes  L   N   108 111   4 FIPS New England County Metropolitan Area (NECMA) Code, 2000
    CD106    No   R   N   112 113   2 Congressional District Code, 106th
    CD108    Yes  R   N   114 115   2 Congressional District Code, 108th
    PUMA5    Yes  L   N   116 120   5 Public Use Microdata Area  5% File, 2000
    PUMA1    Yes  L   N   121 125   5 Public Use Microdata Area  1% File, 2000
    ZCTA5   Yes L A 126 130 5 5-Digit ZIP Code Tabulation Area, 2000
    ZCTA3   Yes L A 131 133 3 3-Digit ZIP Code Tabulation Area, 2000
    TAZ     Yes L A 134 139 6 Traffic Analysis Zone Code, 2000
    TAZCOMB Yes L A 140 145 6 Traffic Analysis Zone Code-State Combined, 2000 (not filled)
    UA      Yes L N 146 150 5 Urban Area, 2000
    UR      Yes L A 151 151 1 Urban/Rural Indicator, 2000
    VTD     Yes R A 152 157 6 Census Voting District Code, 2000
    SLDU    Yes R A 158 160 3 State Legislative District Code (Upper Chamber), 2000
    SLDL    Yes R A 161 163 3 State Legislative District Code (Lower Chamber), 2000
    UGA     Yes L A 164 168 5 Oregon Urban Growth Area, 2000

AUTHOR
Michael G Schwern <schwern@pobox.com>

SEE ALSO
Geo::TigerLine, mk_parsers