CADCAT PARQUET - S3 DATA CATALOG
================================

Reference geospatial layers for California, including administrative
boundaries, utility territories, and energy infrastructure. The data are
stored as Parquet files in the cadcat S3 bucket under
s3://cadcat/parquet/.


FILES
-----
balancing-authorities.parquet
  Description: California Electric Balancing Authority Areas (retired)
  Source: https://cecgis-caenergy.opendata.arcgis.com/datasets/147c83114a3f4ff8a82225e3d6c24857_0

ca-census-tracts.parquet
  Description: California census tracts
  Source: https://catalog.data.gov/dataset/tiger-line-shapefile-2020-state-california-census-tracts

ca_cities.parquet
  Description: California city boundaries and identifiers
  Source: https://data.ca.gov/dataset/california-city-boundaries-and-identifiers

ca_counties.parquet
  Description: California counties
  Source: https://data.napacounty.gov/Demographics/2020-TIGER-Line-Shapefile-of-Counties-in-Californi/ecpd-rfk2/about_data

demand-forecast-zones.parquet
  Description: Forecast zones for the CEC Commercial End-Use Survey
  Source: https://cecgis-caenergy.opendata.arcgis.com/datasets/86fef50f6f344fabbe545e58aec83edd_0

eia860m_ca_plants.parquet
  Description: California power plants from EIA Form 860M
  Source: https://www.eia.gov/electricity/data/eia860m/

gem_ca_plants.parquet
  Description: California power plants, combined from multiple Global Energy
               Monitor trackers
  Sources:
    https://globalenergymonitor.org/wp-content/uploads/2025/08/Global-Nuclear-Power-Tracker-September-2025.xlsx
    https://globalenergymonitor.org/wp-content/uploads/2025/09/Global-Bioenergy-Power-Tracker-GBPT-V3.xlsx
    https://globalenergymonitor.org/wp-content/uploads/2026/03/Geothermal-Power-Tracker-March-2026-Final.xlsx
    https://globalenergymonitor.org/wp-content/uploads/2026/03/Global-Hydropower-Tracker-March-2026.xlsx
    https://globalenergymonitor.org/wp-content/uploads/2026/02/Global-Wind-Power-Tracker-February-2026.xlsx
    https://globalenergymonitor.org/wp-content/uploads/2026/02/Global-Solar-Power-Tracker-February-2026.xlsx

hifld_ca_substations.parquet
  Description: California electric substations (Homeland Infrastructure
               Foundation-Level Data, HIFLD)
  Source: https://www.arcgis.com/home/item.html?id=83397b209bfb4007a2f4c00e70df8e5d

hifld_ca_transmission.parquet
  Description: California electric transmission lines (Homeland Infrastructure
               Foundation-Level Data, HIFLD)
  Source: https://www.arcgis.com/home/item.html?id=8ac33965336e498cbe35cd238b3f1ee6

huc8_ca_simplified.parquet
  Description: California HUC8 watersheds, simplified
  Source: https://data.ca.gov/dataset/watershed-boundary-dataset-wbd/resource/12a8811a-f7bf-4865-a78e-144dfce63617

osm_ca_power.parquet
  Description: California power infrastructure from OpenStreetMap
  Source: https://wiki.openstreetmap.org/wiki/Overpass_API

tribal-areas.parquet
  Description: Bureau of Indian Affairs tracts: mapped lands in Indian Country
  Source: https://biamaps.geoplatform.gov/server/rest/services/BOGS/RTV_VIEWER/MapServer

usstates.parquet
  Description: U.S. state boundaries
  Source: https://www2.census.gov/geo/tiger/TIGER2020/STATE/

utilities.parquet
  Description: Electric load-serving entities: Investor-Owned (IOU) and
               Publicly Owned (POU) utility service territories in California
  Source: https://cecgis-caenergy.opendata.arcgis.com/datasets/30410214d637434ba1003cbdcc32cf55_0


LOADING A FILE
--------------
import geopandas as gpd

gdf = gpd.read_parquet(
    "s3://cadcat/parquet/ca_counties.parquet",
    storage_options={"anon": True},
)


DATA DETAILS
------------
Format  : Parquet
Extent  : California (usstates.parquet covers the U.S.)
Access  : anonymous read via s3fs (storage_options={"anon": True})
Browse  : https://cadcat.s3.amazonaws.com/index.html#parquet/