https://github.com/martibosch/meteora
:sunrise_over_mountains: Pythonic interface to access data from meteorological stations
https://github.com/martibosch/meteora
data-cubes geopandas meteorological-stations netatmo-weather-station pandas python quality-control time-series weather-station xarray
Last synced: 17 days ago
JSON representation
:sunrise_over_mountains: Pythonic interface to access data from meteorological stations
- Host: GitHub
- URL: https://github.com/martibosch/meteora
- Owner: martibosch
- License: gpl-3.0
- Created: 2024-10-07T09:05:39.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-08T19:07:55.000Z (19 days ago)
- Last Synced: 2025-04-08T19:46:53.372Z (18 days ago)
- Topics: data-cubes, geopandas, meteorological-stations, netatmo-weather-station, pandas, python, quality-control, time-series, weather-station, xarray
- Language: Python
- Homepage: https://meteora.readthedocs.io/en/latest
- Size: 4.24 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Support: docs/supported-providers.rst
Awesome Lists containing this project
README
[](https://pypi.python.org/pypi/meteora)
[](https://anaconda.org/conda-forge/meteora)
[](https://meteora.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/martibosch/meteora/blob/main/.github/workflows/tests.yml)
[](https://results.pre-commit.ci/latest/github/martibosch/meteora/main)
[](https://codecov.io/gh/martibosch/meteora)
[](https://github.com/martibosch/meteora/blob/main/LICENSE)
[](https://mybinder.org/v2/gh/martibosch/meteora/HEAD?labpath=docs%2Fuser-guide%2Fasos-example.ipynb)
# Meteora
Pythonic interface to access observations from meteorological stations. Key features:
- easily stream meteorological observations [from multiple providers, from global (e.g., GHCNh) and regional (e.g., MetOffice) networks to citizen weather stations (e.g., Netatmo)](https://meteora.readthedocs.io/en/latest/supported-providers.html) into pandas data frames.
- user-friendly arguments to filter data by region, variables or date ranges.
- request and download caching with [requests-cache](https://github.com/requests-cache/requests-cache) and [pooch](https://github.com/fatiando/pooch) 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 data from [the Global Historical Climatology Network hourly (GHCNh)](https://www.ncei.noaa.gov/products/global-historical-climatology-network-hourly) into a pandas data frame:
```python
from meteora.clients import GHCNHourlyClient
region = "Davos, Switzerland"
variables = ["temperature", "precipitation", "surface_wind_speed"]
start = "12-11-2021"
end = "12-12-2021"
client = GHCNHourlyClient(region)
ts_df = client.get_ts_df(variables, start, end)
ts_df.head()
```
```
[########################################] | 100% Completed | 16.94 s
```
temperature
precipitation
surface_wind_speed
station_id
time
SZM00006784
2021-12-11 00:00:00
-4.7
0.0
5.1
2021-12-11 01:00:00
-4.8
0.0
5.1
2021-12-11 02:00:00
-4.8
0.0
3.6
2021-12-11 03:00:00
-4.8
0.0
3.6
2021-12-11 04:00:00
-4.7
0.0
3.1
We can also get the station locations using the `stations_gdf` property:
```python
import contextily as cx
ax = client.stations_gdf.plot()
cx.add_basemap(ax, crs=client.stations_gdf.crs, attribution=False)
```
*(C) OpenStreetMap contributors, Tiles style by Humanitarian OpenStreetMap Team hosted by OpenStreetMap France*
See [the user guide](https://meteora.readthedocs.io/en/latest/user-guide.html) for more details about the features of Meteora as well as the [list of supported providers](https://meteora.readthedocs.io/en/latest/supported-providers.html).
## Installation
The easiest way to install Meteora is with conda/mamba:
```bash
conda install -c conda-forge meteora
```
Alternatively, if [geopandas dependencies are installed correctly](https://geopandas.org/en/latest/getting_started/install.html), you can install Meteora using pip:
```bash
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](https://github.com/martibosch/agrometeo-geopy)
- [martibosch/netatmo-geopy](https://github.com/martibosch/netatmo-geopy)
Eventually these packages will be fully integrated into Meteora.
## Acknowledgements
- The logging system is based on code from [gboeing/osmnx](https://github.com/gboeing/osmnx).
- This package was created with the [martibosch/cookiecutter-geopy-package](https://github.com/martibosch/cookiecutter-geopy-package) project template.
- With the support of the École Polytechnique Fédérale de Lausanne (EPFL).