SJVAir Toolkit
SJVAir Toolkit¶
Command-line tool and Python client for SJVAir — a network of air quality monitors across California’s San Joaquin Valley.
Install¶
pip install sjvair
Map and timelapse generation need the optional maps extra (pip install sjvair[maps]) plus ffmpeg on PATH for timelapse videos — see Map generation.
Where to next¶
Bulk data export, static maps, and timelapse videos from the command line.
Scriptable access to monitors, regions, and every integrated dataset.
Air Quality¶
Beyond SJVAir’s own fleet, the CLI and client can filter monitors by these integrated networks with --device:
Community-operated network of low-cost consumer PM2.5 sensors.
--device PurpleAir
EPA’s national real-time feed of regulatory-grade air monitors.
--device AirNow
CARB’s public viewer aggregating California’s community monitoring networks.
--device AQview
Met One BAM-1022 beta attenuation monitors — regulatory-grade PM.
--device BAM1022
2B Technologies AQLite regulatory-grade ozone (O3) monitors.
--device AQLite
Open-source air quality monitor hardware.
--device AirGradient
Community-deployed air monitors.
--device VOZBox
Other Datasets¶
Beyond SJVAir’s own network of air quality monitors, the CLI and client can pull in several third-party datasets:
OEHHA / CalEPA cumulative pollution-burden scores by census tract.
sjvair calenviroscreen5
CalEPA daily ZIP-code-level heat-risk scores for the San Joaquin Valley.
sjvair calheatscore
CARB permitted stationary emissions sources (facilities).
sjvair ceidars
NOAA satellite-derived smoke plume and fire detections.
sjvair hms
CDPR mandatory agricultural pesticide use reports.
sjvair pesticides
SJVAPCD daily air quality forecasts by San Joaquin Valley county zone.
sjvair forecasts
California’s irrigation-management weather station network — also the source of SJVAir’s meteorological entry types.
--device CIMIS
Released under the MIT License.