# Source: US Census TIGER/Line Geographic Boundaries
# Type: vector
# Catalog: Manual
# Created for: CBGB benchmark problems
# Note: Planetary Computer also hosts US Census data (planetary-computer-us-census)
#       with population/demographic tables. This entry covers the TIGER geographic
#       boundary files directly from Census Bureau.

source:
  id: census-tiger
  name: US Census TIGER/Line Boundaries
  type: vector
  url: https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html
  description: >
    TIGER/Line Shapefiles from the US Census Bureau contain geographic boundary
    data for all census geographic entities including states, counties, census
    tracts, block groups, roads, and other features. TIGER (Topologically
    Integrated Geographic Encoding and Referencing) is the primary geographic
    framework for the US Census. Updated annually with boundary revisions.
    The CBGB benchmarks use states, counties, and roads layers.
  provider: United States Census Bureau
  license: public-domain
  metadata:
    connector_id: null
    tags:
    - Census
    - Boundaries
    - Administrative
    - United States
    - Vector
    - TIGER
    - States
    - Counties
    - Roads
    dataset:
      tier: 1
      thematic_group: Administrative Boundaries
      format: shapefile
      crs: EPSG:4326
      fields:
      - id: STATEFP
        description: State FIPS code
        dtype: string
      - id: STUSPS
        description: State USPS abbreviation
        dtype: string
      - id: NAME
        description: Feature name
        dtype: string
      - id: COUNTYFP
        description: County FIPS code (counties layer)
        dtype: string
      - id: GEOID
        description: Geographic identifier (concatenated FIPS codes)
        dtype: string
      - id: ALAND
        description: Land area (square meters)
        dtype: int64
      - id: AWATER
        description: Water area (square meters)
        dtype: int64
      - id: MTFCC
        description: MAF/TIGER Feature Class Code (roads layer)
        dtype: string
      - id: RTTYP
        description: Route type code (roads layer)
        dtype: string
      temporal:
        range: 2006-01-01/..
        frequency: annual
        type: time_series
        default_range: latest
      quality:
        methodology: >
          Boundaries derived from Census Bureau's Master Address File/TIGER
          database. Updated through the Boundary and Annexation Survey (BAS)
          and decennial census programs. Legal boundaries from state and local
          government submissions.
        accuracy: >
          Positional accuracy varies by feature type. Boundaries generally
          accurate to source document standards. Roads updated from
          multiple federal, state, and local sources.
        coverage: United States (including territories)
      layout:
        type: partitioned
        uri_template: https://www2.census.gov/geo/tiger/TIGER{year}/{layer}/
        parameters:
        - var: year
          description: Data year (e.g., 2018, 2022)
        - var: layer
          description: Feature layer (STATE, COUNTY, ROADS, etc.)
          values:
          - STATE
          - COUNTY
          - ROADS
          - TRACT
          - BG
          - PLACE
      access:
        type: http
        url: https://www2.census.gov/geo/tiger/
        notes: >
          Shapefiles available by year and geography type. Also available via
          Census Bureau API and web services. Google Earth Engine hosts
          2016-2018 vintages (TIGER/2018/States, TIGER/2018/Counties,
          TIGER/2016/Roads). See also planetary-computer-us-census for
          GeoParquet versions with demographic attributes.
      related_sources:
      - planetary-computer-us-census
      original_source_url: https://www2.census.gov/geo/tiger/
      homepage: https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html
      gee_asset_ids:
        states: TIGER/2018/States
        counties: TIGER/2018/Counties
        roads: TIGER/2016/Roads
      cbgb_problems:
      - EBA_A1.5_A1
      - FRC_5
      - EBD_F5.3_C1