Skip to main content

Meteostat Python Package

The Meteostat Python library provides a simple API for accessing open weather and climate data. The historical observations and statistics are collected by the Meteostat project from different public interfaces, most of which are governmental.

Among the data sources are national weather services like the National Oceanic and Atmospheric Administration (NOAA) and Germany's national meteorological service (DWD).

Installation

The Meteostat Python package is available through PyPI:

pip install meteostat

Meteostat requires Python 3.5 or higher.

Documentation

The Meteostat Python library is divided into multiple classes which provide access to the actual data. The documentation covers all aspects of the library:

Example

Let's pretend you want to plot temperature data for Vancouver, BC from 2018:

# Import Meteostat library and dependencies
from datetime import datetime
import matplotlib.pyplot as plt
from meteostat import Stations, Daily

# Set coordinates of Vancouver
lat = 49.2497
lon = -123.1193

# Set time period
start = datetime(2018, 1, 1)
end = datetime(2018, 12, 31)

# Get closest weather station to Vancouver, BC
stations = Stations()
stations = stations.nearby(lat, lon)
stations = stations.inventory('daily', (start, end))
station = stations.fetch(1)

# Get daily data for 2018 at the selected weather station
data = Daily(station, start, end)
data = data.fetch()

# Plot line chart including average, minimum and maximum temperature
data.plot(y=['tavg', 'tmin', 'tmax'])
plt.show()

Take a look at the expected output:

2018 temperature data for Vancouver, BC

Contributing

Instructions on building and testing the Meteostat Python package can be found in the documentation. More information about the Meteostat bulk data interface is available here.

If you want to support the project financially, you can make a donation via:

Data License

Meteorological data is provided under the terms of the Creative Commons Attribution-NonCommercial 4.0 International Public License. Please be aware that Meteostat uses data which is shared under WMO resolution 40.

All meteorological data sources used by the Meteostat project are listed here.

Code License

The code of this library is available under the MIT license.

Metadata

Release files for meteostat 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for meteostat 1.0.2
File Size Uploaded Provenance
meteostat-1.0.2.tar.gz 10.6 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for meteostat 1.0.2
File Interpreter ABI Platform
meteostat-1.0.2-py2-none-any.whl Python 2 none any Details

Total release size: 24.5 kB

Release files / meteostat-1.0.2.tar.gz

Download URL meteostat-1.0.2.tar.gz
Size 10.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2a8d406a1859a7f0ad0a6c34ee985b6b0b9da05750d4ed0bb690391aae31b998
BLAKE2b-256 checksum
How to use checksums
8c9f73ee30cb9fb376ce6c594ff1f43994790db7f7d66b301ada5ca3353696bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.3

Release files / meteostat-1.0.2-py2-none-any.whl

Download URL meteostat-1.0.2-py2-none-any.whl
Size 13.8 kB
Tags Python 2
SHA-256 checksum
How to use checksums
0484b5e403e5b4ae93f14a5dd53bbb443eb8a62666a585bff23cf1bdd86e356c
BLAKE2b-256 checksum
How to use checksums
dc0b801adbe6c8da04461e189f8c60235a3a4b0a4e7e3ea2e80829deacb1d335
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.3

Security for meteostat 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page