Skip to main content

Access and analyze historical weather and climate data with Python.

Project description

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 Meteostat 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 weather service (DWD).

Are you looking for a hosted solution? Try our JSON API.

Installation

The Meteostat Python package is available through PyPI:

pip install meteostat

Meteostat requires Python 3.6 or higher. If you want to visualize data, please install Matplotlib, too.

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 plot 2018 temperature data for Vancouver, BC:

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

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

# Create Point for Vancouver, BC
location = Point(49.2497, -123.1193, 70)

# Get daily data for 2018
data = Daily(location, 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.

Donating

If you want to support the project financially, you can make a donation using one of the following services:

Data License

Meteorological data is provided under the terms of the Creative Commons Attribution-NonCommercial 4.0 International Public License (CC BY-NC 4.0). You may build upon the material for any purpose, even commercially. However, you are not allowed to redistribute Meteostat data "as-is" for commercial purposes.

By using the Meteostat Python library you agree to our terms of service. 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meteostat-1.7.4.tar.gz (20.7 kB view details)

Uploaded Source

Built Distribution

meteostat-1.7.4-py3-none-any.whl (33.2 kB view details)

Uploaded Python 3

File details

Details for the file meteostat-1.7.4.tar.gz.

File metadata

  • Download URL: meteostat-1.7.4.tar.gz
  • Upload date:
  • Size: 20.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.13

File hashes

Hashes for meteostat-1.7.4.tar.gz
Algorithm Hash digest
SHA256 715f9af15e854570ee7ba594e1bc4c396d95f85344d7f82c0acaa0a30585a3e3
MD5 841a2d6e240f221097596edd12c63cac
BLAKE2b-256 78ab3e7fc64d97cc6cb546efee26285a00be05a935b2b6ac18b4d27a2529705b

See more details on using hashes here.

File details

Details for the file meteostat-1.7.4-py3-none-any.whl.

File metadata

  • Download URL: meteostat-1.7.4-py3-none-any.whl
  • Upload date:
  • Size: 33.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.13

File hashes

Hashes for meteostat-1.7.4-py3-none-any.whl
Algorithm Hash digest
SHA256 abb6603ff91afaf21907401dfb07b2682e992f8df8efbacdc73b08a534fc7c75
MD5 22bf945b143d8ec45f40cab8407c2faa
BLAKE2b-256 66dbe86dacee79f8909107cab893982acd803837ce627a09c34e836af156a96a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page