easysnowdata.stations.inventory#

easysnowdata.stations.inventory(aoi: Any = None, *, networks: Any = None, daily_only: bool = False, active_only: bool = False, source: str = 'archive', **kwargs: Any) → GeoDataFrame[source]#

Snow stations as a GeoDataFrame, indexed by their global station code.

Parameters:

aoi – Any form easysnowdata.aoi.parse_aoi() accepts; None asks for every station in the chosen networks.
networks – Which networks to list — any of "awdb", "cdec", "databc", "nve", "yukon", "alberta", "hydroquebec", "slf", "snih", "ceaza", "fmi". None (default) means all of them.
daily_only – Keep only stations with a daily-or-better SWE or snow-depth record. On source="archive" this is the probe-verified verdict (global_snow_networks’ DESIGN.md §4: a station counts as daily only once the pipeline has actually retrieved daily values). The live route has no such verdict, so there it filters on what each network advertises about itself, and the frame’s daily column and daily_flag attribute say so.
active_only – Keep only stations the network reports as active. Inactive stations with a long record are usually still worth having.
source – "archive" (default) reads the daily-refreshed inventory global_snow_networks publishes: one HTTP request, normalized columns and probe-verified daily flags, at most a day old. "clients" asks each network’s API for today’s station list instead — one sweep per network (three for SLF’s datasets), slower, and NVE needs its key.
**kwargs – On the archive route, passed to geopandas.read_file (rows=, columns=, …).

Returns:

geopandas.GeoDataFrame – Stations in EPSG:4326 indexed by code ("679_WA_SNTL"), with the native station_id and the columns listed in easysnowdata.stations._frames.INVENTORY_COLUMNS.

Examples

>>> import easysnowdata as esd
>>> aoi = (-121.94, 46.72, -121.54, 46.99)
>>> esd.stations.inventory(aoi, daily_only=True)

Examples using `easysnowdata.stations.inventory`#

Every station network in one call

SNOTEL and snow courses (USDA NRCS AWDB)

California snow pillows and courses (CDEC)

British Columbia snow stations (DataBC)

Norwegian snow stations (NVE HydAPI)

Yukon snow stations (AquaCache)

easysnowdata.stations.inventory#

Examples using easysnowdata.stations.inventory#

Examples using `easysnowdata.stations.inventory`#