Pythonic interface to access data from meteorological stations. Key features:
- easily stream data from multiple providers (e.g., Automated Surface/Weather Observing Systems (ASOS/AWOS), MetOffice...) into pandas data frames.
- user-friendly arguments to filter data by region, variables or date ranges.
- request caching with requests-cache to avoid re-downloading data and help bypassing API limits.
Meteora provides a set of provider-specific clients to get observations from meteorological stations. For instance, it can be used to stream the one-minute ASOS data from the Iowa Environmental Mesonet into a pandas data frame:
from meteora.clients import ASOSOneMinIEMClient
region = "Oregon"
variables = ["temperature", "pressure", "precipitation", "surface_wind_speed"]
start = "2021-08-13"
end = "2021-08-16"
client = ASOSOneMinIEMClient(region=region)
ts_df = client.get_ts_df(variables, start=start, end=end)
ts_df.head()| temperature | pressure | precipitation | surface_wind_speed | ||
|---|---|---|---|---|---|
| station | valid(UTC) | ||||
| AST | 2021-08-13 00:00:00 | 68.0 | 29.942 | 0.0 | 10.0 |
| 2021-08-13 00:01:00 | 67.0 | 29.942 | 0.0 | 10.0 | |
| 2021-08-13 00:02:00 | 67.0 | 29.942 | 0.0 | 10.0 | |
| 2021-08-13 00:03:00 | 67.0 | 29.942 | 0.0 | 9.0 | |
| 2021-08-13 00:04:00 | 68.0 | 29.942 | 0.0 | 8.0 |
We can also get the station locations using the stations_gdf property:
import contextily as cx
ax = client.stations_gdf.plot()
cx.add_basemap(ax, crs=client.stations_gdf.crs)
See the user guide for more details about the features of Meteora as well as the list of supported providers.
The easiest way to install Meteora is with conda/mamba:
conda install -c conda-forge meteoraAlternatively, if geopandas dependencies are installed correctly, you can install Meteora using pip:
pip install meteoraMeteora intends to provide a unified way to access data from meteorological stations from multiple providers. The following libraries provide access to data from a specific provider:
Eventually these packages will be fully integrated into Meteora.
- The logging system is based on code from gboeing/osmnx.
- This package was created with the martibosch/cookiecutter-geopy-package project template.
- With the support of the École Polytechnique Fédérale de Lausanne (EPFL).