meteora 0.1.1

Pythonic interface to access data from meteorological stations

Meteora

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.

Overview

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.

Installation

Although Meteora is not available in conda-forge yet (hopefully will be soon), it can be installed using conda/mamba and pip as follows:

# install GDAL-based requirements
conda install -c conda-forge contextily geopandas osmnx
# install Meteora
pip install meteora

See also

Meteora 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:

• martibosch/agrometeo-geopy
• martibosch/netatmo-geopy

Eventually these packages will be fully integrated into Meteora.

Acknowledgements

• 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).