# riweather
[](https://github.com/ensley-nexant/riweather/actions?workflow=Tests)
[](https://codecov.io/gh/ensley-nexant/riweather)
[](https://github.com/ensley-nexant/riweather/actions/workflows/release.yml)
Grab publicly available weather data with `riweather`. [See the full documentation](https://ensley-nexant.github.io/riweather).
## Installation
Install with pip:
```
pip install riweather
```
To create interactive maps of weather station locations, install the package along with its optional dependencies:
```
pip install riweather[plots]
```
## Usage
Given a latitude and longitude, get a list of weather stations sorted from nearest to farthest from that location.
```python
>>> import riweather
>>> station_rank = riweather.rank_stations(39.98, -105.13, max_distance_m=20000)
```
Select the top station (or a different station):
```python
>>> station = riweather.select_station(station_rank, rank=0)
```
View information about that station:
```python
>>> station.name, station.usaf_id
```
And pull weather data from that station for a certain year.
```python
>>> station.fetch_temp_data(2022)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ensley-nexant/riweather",
"name": "riweather",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "weather,noaa",
"author": "John Ensley",
"author_email": "jensley@resource-innovations.com",
"download_url": "https://files.pythonhosted.org/packages/55/c2/46d8071f5de59a9c149eae9000a43b5e39fe32201df1ee65bd8635c30e0c/riweather-0.5.3.tar.gz",
"platform": null,
"description": "# riweather\n\n[](https://github.com/ensley-nexant/riweather/actions?workflow=Tests)\n[](https://codecov.io/gh/ensley-nexant/riweather)\n[](https://github.com/ensley-nexant/riweather/actions/workflows/release.yml)\n\nGrab publicly available weather data with `riweather`. [See the full documentation](https://ensley-nexant.github.io/riweather).\n\n## Installation\n\nInstall with pip:\n\n```\npip install riweather\n```\n\nTo create interactive maps of weather station locations, install the package along with its optional dependencies:\n\n```\npip install riweather[plots]\n```\n\n## Usage\n\nGiven a latitude and longitude, get a list of weather stations sorted from nearest to farthest from that location.\n\n```python\n>>> import riweather\n\n>>> station_rank = riweather.rank_stations(39.98, -105.13, max_distance_m=20000)\n```\n\nSelect the top station (or a different station):\n\n```python\n>>> station = riweather.select_station(station_rank, rank=0)\n```\n\nView information about that station:\n\n```python\n>>> station.name, station.usaf_id\n```\n\nAnd pull weather data from that station for a certain year.\n\n```python\n>>> station.fetch_temp_data(2022)\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Grab publicly available weather data",
"version": "0.5.3",
"project_urls": {
"Documentation": "https://ensley-nexant.github.io/riweather",
"Homepage": "https://github.com/ensley-nexant/riweather",
"Repository": "https://github.com/ensley-nexant/riweather"
},
"split_keywords": [
"weather",
"noaa"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d96ff7fdf2176e2702608090d11ae5a44186bdbcb65e1816bf0d15639fbc2811",
"md5": "0be7852b4bdb245ad8cfa2c31f55d48b",
"sha256": "e6f1df50a4afd3549c3b550ae3c286a738dc7d506c7088ae6e9a0feac3e20493"
},
"downloads": -1,
"filename": "riweather-0.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0be7852b4bdb245ad8cfa2c31f55d48b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 2287994,
"upload_time": "2024-02-19T06:13:06",
"upload_time_iso_8601": "2024-02-19T06:13:06.646015Z",
"url": "https://files.pythonhosted.org/packages/d9/6f/f7fdf2176e2702608090d11ae5a44186bdbcb65e1816bf0d15639fbc2811/riweather-0.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "55c246d8071f5de59a9c149eae9000a43b5e39fe32201df1ee65bd8635c30e0c",
"md5": "fb0cfba3d4d48aaecd3d1b8a90899a7c",
"sha256": "c5534e1c39574ad65bc1f77a9f2b6460cf40325475845f7885ab3ae788baa9f6"
},
"downloads": -1,
"filename": "riweather-0.5.3.tar.gz",
"has_sig": false,
"md5_digest": "fb0cfba3d4d48aaecd3d1b8a90899a7c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 2229817,
"upload_time": "2024-02-19T06:13:09",
"upload_time_iso_8601": "2024-02-19T06:13:09.373560Z",
"url": "https://files.pythonhosted.org/packages/55/c2/46d8071f5de59a9c149eae9000a43b5e39fe32201df1ee65bd8635c30e0c/riweather-0.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 06:13:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ensley-nexant",
"github_project": "riweather",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "riweather"
}
JSON
