# 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](https://meteostat.net) 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).
Are you looking for a **hosted solution**? Try our [JSON API](https://rapidapi.com/meteostat/api/meteostat/).
## Installation
The Meteostat Python package is available through [PyPI](https://pypi.org/project/meteostat/):
```sh
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](https://dev.meteostat.net/python/) covers all aspects of the library:
* **Selecting Locations**
* [Geographical Point](https://dev.meteostat.net/python/point.html)
* [Weather Stations](https://dev.meteostat.net/python/stations.html)
* **Time Series**
* [Hourly Data](https://dev.meteostat.net/python/hourly.html)
* [Daily Data](https://dev.meteostat.net/python/daily.html)
* [Monthly Data](https://dev.meteostat.net/python/monthly.html)
* **Miscellaneous Data**
* [Climate Normals](https://dev.meteostat.net/python/normals.html)
* **Library**
* [Contributing](https://dev.meteostat.net/python/contributing.html)
* [Formats & Units](https://dev.meteostat.net/formats.html)
* [Data Sources](https://dev.meteostat.net/sources.html)
* [Terms & License](https://dev.meteostat.net/terms.html)
## Example
Let's plot 2018 temperature data for Vancouver, BC:
```python
# 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:
## Contributing
Instructions on building and testing the Meteostat Python package can be found in the [documentation](https://dev.meteostat.net/python/contributing.html). More information about the Meteostat bulk data interface is available [here](https://dev.meteostat.net/bulk/).
## Donating
If you want to support the project financially, you can make a donation using one of the following services:
* [GitHub](https://github.com/sponsors/clampr)
* [Patreon](https://www.patreon.com/meteostat)
* [PayPal](https://www.paypal.com/donate?hosted_button_id=MQ67WRDC8EW38)
## 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)](https://creativecommons.org/licenses/by-nc/4.0/legalcode). 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](https://dev.meteostat.net/terms.html). All meteorological data sources used by the Meteostat project are listed [here](https://dev.meteostat.net/sources.html).
## Code License
The code of this library is available under the [MIT license](https://opensource.org/licenses/MIT).
Raw data
{
"_id": null,
"home_page": "https://github.com/meteostat/meteostat-python",
"name": "meteostat",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6.0",
"maintainer_email": null,
"keywords": "weather, climate, data, timeseries, meteorology",
"author": "Meteostat",
"author_email": "info@meteostat.net",
"download_url": "https://files.pythonhosted.org/packages/7f/2f/06c2ec2c82341d76857d82359e12e49d94f45ed54169ae59f051ae288933/meteostat-1.6.8.tar.gz",
"platform": null,
"description": "# Meteostat Python Package\n\nThe Meteostat Python library provides a simple API for accessing open weather and climate data. The historical observations and statistics are collected by [Meteostat](https://meteostat.net) from different public interfaces, most of which are governmental.\n\nAmong the data sources are national weather services like the National Oceanic and Atmospheric Administration (NOAA) and Germany's national meteorological service (DWD).\n\nAre you looking for a **hosted solution**? Try our [JSON API](https://rapidapi.com/meteostat/api/meteostat/).\n\n## Installation\n\nThe Meteostat Python package is available through [PyPI](https://pypi.org/project/meteostat/):\n\n```sh\npip install meteostat\n```\n\nMeteostat **requires Python 3.6** or higher. If you want to visualize data, please install Matplotlib, too.\n\n## Documentation\n\nThe Meteostat Python library is divided into multiple classes which provide access to the actual data. The [documentation](https://dev.meteostat.net/python/) covers all aspects of the library:\n\n* **Selecting Locations**\n * [Geographical Point](https://dev.meteostat.net/python/point.html)\n * [Weather Stations](https://dev.meteostat.net/python/stations.html)\n* **Time Series**\n * [Hourly Data](https://dev.meteostat.net/python/hourly.html)\n * [Daily Data](https://dev.meteostat.net/python/daily.html)\n * [Monthly Data](https://dev.meteostat.net/python/monthly.html)\n* **Miscellaneous Data**\n * [Climate Normals](https://dev.meteostat.net/python/normals.html)\n* **Library**\n * [Contributing](https://dev.meteostat.net/python/contributing.html)\n * [Formats & Units](https://dev.meteostat.net/formats.html)\n * [Data Sources](https://dev.meteostat.net/sources.html)\n * [Terms & License](https://dev.meteostat.net/terms.html)\n\n## Example\n\nLet's plot 2018 temperature data for Vancouver, BC:\n\n```python\n# Import Meteostat library and dependencies\nfrom datetime import datetime\nimport matplotlib.pyplot as plt\nfrom meteostat import Point, Daily\n\n# Set time period\nstart = datetime(2018, 1, 1)\nend = datetime(2018, 12, 31)\n\n# Create Point for Vancouver, BC\nlocation = Point(49.2497, -123.1193, 70)\n\n# Get daily data for 2018\ndata = Daily(location, start, end)\ndata = data.fetch()\n\n# Plot line chart including average, minimum and maximum temperature\ndata.plot(y=['tavg', 'tmin', 'tmax'])\nplt.show()\n```\n\nTake a look at the expected output:\n\n\n\n## Contributing\n\nInstructions on building and testing the Meteostat Python package can be found in the [documentation](https://dev.meteostat.net/python/contributing.html). More information about the Meteostat bulk data interface is available [here](https://dev.meteostat.net/bulk/).\n\n## Donating\n\nIf you want to support the project financially, you can make a donation using one of the following services:\n\n* [GitHub](https://github.com/sponsors/clampr)\n* [Patreon](https://www.patreon.com/meteostat)\n* [PayPal](https://www.paypal.com/donate?hosted_button_id=MQ67WRDC8EW38)\n\n## Data License\n\nMeteorological data is provided under the terms of the [Creative Commons Attribution-NonCommercial 4.0 International Public License (CC BY-NC 4.0)](https://creativecommons.org/licenses/by-nc/4.0/legalcode). You may build upon the material\nfor any purpose, even commercially. However, you are not allowed to redistribute Meteostat data \"as-is\" for commercial purposes.\n\nBy using the Meteostat Python library you agree to our [terms of service](https://dev.meteostat.net/terms.html). All meteorological data sources used by the Meteostat project are listed [here](https://dev.meteostat.net/sources.html).\n\n## Code License\n\nThe code of this library is available under the [MIT license](https://opensource.org/licenses/MIT).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Access and analyze historical weather and climate data with Python.",
"version": "1.6.8",
"project_urls": {
"Homepage": "https://github.com/meteostat/meteostat-python"
},
"split_keywords": [
"weather",
" climate",
" data",
" timeseries",
" meteorology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "902334e8913fa75d064be09303914ea0056ef2968b639ebc8e70decfecd8299b",
"md5": "559443da0fc1c18cc866df7c9dd5abc5",
"sha256": "859a7f2cbf3d902e9ce48363ff9490385a22296742ced7070360d06d3415ef97"
},
"downloads": -1,
"filename": "meteostat-1.6.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "559443da0fc1c18cc866df7c9dd5abc5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6.0",
"size": 31436,
"upload_time": "2024-06-20T10:39:00",
"upload_time_iso_8601": "2024-06-20T10:39:00.016389Z",
"url": "https://files.pythonhosted.org/packages/90/23/34e8913fa75d064be09303914ea0056ef2968b639ebc8e70decfecd8299b/meteostat-1.6.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7f2f06c2ec2c82341d76857d82359e12e49d94f45ed54169ae59f051ae288933",
"md5": "297c1f8c1436f9a77e5c1db2263f26ba",
"sha256": "e4e1e3df79e52d45116a12a5ac703acf75d521356de072052c1f60e42160a74d"
},
"downloads": -1,
"filename": "meteostat-1.6.8.tar.gz",
"has_sig": false,
"md5_digest": "297c1f8c1436f9a77e5c1db2263f26ba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6.0",
"size": 19188,
"upload_time": "2024-06-20T10:39:03",
"upload_time_iso_8601": "2024-06-20T10:39:03.437338Z",
"url": "https://files.pythonhosted.org/packages/7f/2f/06c2ec2c82341d76857d82359e12e49d94f45ed54169ae59f051ae288933/meteostat-1.6.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-20 10:39:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "meteostat",
"github_project": "meteostat-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pandas",
"specs": [
[
">=",
"1.1"
]
]
},
{
"name": "pytz",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "matplotlib",
"specs": []
},
{
"name": "pylint",
"specs": []
},
{
"name": "pytest",
"specs": []
},
{
"name": "black",
"specs": []
},
{
"name": "wheel",
"specs": []
},
{
"name": "twine",
"specs": []
}
],
"lcname": "meteostat"
}
JSON
