EEweather: Weather station wrangling for EEmeter
================================================
.. image:: https://travis-ci.org/openeemeter/eeweather.svg?branch=master
:target: https://travis-ci.org/openeemeter/eeweather
.. image:: https://img.shields.io/github/license/openeemeter/eeweather.svg
:target: https://github.com/openeemeter/eeweather
.. image:: https://readthedocs.org/projects/eeweather/badge/?version=latest
:target: http://eeweather.readthedocs.io/en/latest/?badge=latest
.. image:: https://img.shields.io/pypi/v/eeweather.svg
:target: https://pypi.python.org/pypi/eeweather
.. image:: https://codecov.io/gh/openeemeter/eeweather/branch/master/graph/badge.svg
:target: https://codecov.io/gh/openeemeter/eeweather
---------------
**EEweather** — tools for matching to and fetching data from NCDC ISD, TMY3, or CZ2010 weather stations.
EEweather comes with a database of weather station metadata, ZCTA metadata, and GIS data that makes it easier to find the right weather station to use for a particular ZIP code or lat/long coordinate.
`Read the docs. <https://eeweather.readthedocs.org/>`_
Installation
------------
EEweather is a python package and can be installed with pip.
::
$ pip install eeweather
Supported Sources of Weather Data
---------------------------------
- NCDC Integrated Surface Database (ISD)
- Global Summary of the Day (GSOD)
- NREL Typical Meteorological Year 3 (TMY3)
- California Energy Commission 1998-2009 Weather Normals (CZ2010)
Features
--------
- Match by ZIP code (ZCTA) or by lat/long coordinates
- Use user-supplied weather station mappings
- Match within climate zones
- IECC Climate Zones
- IECC Moisture Regimes
- Building America Climate Zones
- California Building Climate Zone Areas
- User-friendly SQLite database of metadata compiled from primary sources
- US Census Bureau (ZCTAs, county shapefiles)
- Building America climate zone county lists
- NOAA NCDC Integrated Surface Database Station History
- NREL TMY3 site
- Plot maps of outputs
Contributing
------------
Dev installation::
$ pipenv --python 3.6.4 # create virtualenv with python 3.6.4
$ pipenv install --dev # install dev requirements with pipenv
$ pipenv install -e . # install package in editable mode
$ pipenv shell # activate pipenv virtual environment
Build docs::
$ make -C docs html
Autobuild docs::
$ make -C docs livehtml
Check spelling in docs::
$ make -C docs spelling
Run tests::
$ pytest
Run tests on multiple python versions::
$ tox
Upload to pypi (using twine)::
$ python setup.py upload
Use with Docker
---------------
To use with docker-compose, use the following:
Run a tutorial notebook (copy link w/ token, open tutorial.ipynb)::
$ docker-compose up jupyter
Live-edit docs::
$ docker-compose up docs
Open a shell::
$ docker-compose run --rm shell
Run tests::
$ docker-compose run --rm test
Run the CLI::
$ docker-compose run --rm eeweather --help
Notice Regarding CZ2010 Data
----------------------------
There may be conditions placed on their international commercial use.
They can be used within the U.S. or for non-commercial international activities without restriction.
The non-U.S. data cannot be redistributed for commercial purposes.
Re-distribution of these data by others must provide this same notification.
See `further explanation <http://weather.whiteboxtechnologies.com/faq#Q12/>`_ here.
Raw data
{
"_id": null,
"home_page": "http://github.com/openeemeter/eeweather",
"name": "eeweather",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Phil Ngo",
"author_email": "phil@openee.io",
"download_url": "https://files.pythonhosted.org/packages/b4/29/ac0f253b94b4a3ccc6728954f7ef5d877d7b734e92fa9da3ba3cee35fadd/eeweather-0.3.25.tar.gz",
"platform": null,
"description": "\nEEweather: Weather station wrangling for EEmeter\n================================================\n\n.. image:: https://travis-ci.org/openeemeter/eeweather.svg?branch=master\n :target: https://travis-ci.org/openeemeter/eeweather\n\n.. image:: https://img.shields.io/github/license/openeemeter/eeweather.svg\n :target: https://github.com/openeemeter/eeweather\n\n.. image:: https://readthedocs.org/projects/eeweather/badge/?version=latest\n :target: http://eeweather.readthedocs.io/en/latest/?badge=latest\n\n.. image:: https://img.shields.io/pypi/v/eeweather.svg\n :target: https://pypi.python.org/pypi/eeweather\n\n.. image:: https://codecov.io/gh/openeemeter/eeweather/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/openeemeter/eeweather\n\n---------------\n\n**EEweather** \u2014 tools for matching to and fetching data from NCDC ISD, TMY3, or CZ2010 weather stations.\n\nEEweather comes with a database of weather station metadata, ZCTA metadata, and GIS data that makes it easier to find the right weather station to use for a particular ZIP code or lat/long coordinate.\n\n`Read the docs. <https://eeweather.readthedocs.org/>`_\n\nInstallation\n------------\n\nEEweather is a python package and can be installed with pip.\n\n::\n\n $ pip install eeweather\n\nSupported Sources of Weather Data\n---------------------------------\n\n- NCDC Integrated Surface Database (ISD)\n- Global Summary of the Day (GSOD)\n- NREL Typical Meteorological Year 3 (TMY3)\n- California Energy Commission 1998-2009 Weather Normals (CZ2010)\n\nFeatures\n--------\n\n- Match by ZIP code (ZCTA) or by lat/long coordinates\n- Use user-supplied weather station mappings\n- Match within climate zones\n\n - IECC Climate Zones\n - IECC Moisture Regimes\n - Building America Climate Zones\n - California Building Climate Zone Areas\n\n- User-friendly SQLite database of metadata compiled from primary sources\n\n - US Census Bureau (ZCTAs, county shapefiles)\n - Building America climate zone county lists\n - NOAA NCDC Integrated Surface Database Station History\n - NREL TMY3 site\n\n- Plot maps of outputs\n\nContributing\n------------\n\nDev installation::\n\n $ pipenv --python 3.6.4 # create virtualenv with python 3.6.4\n $ pipenv install --dev # install dev requirements with pipenv\n $ pipenv install -e . # install package in editable mode\n $ pipenv shell # activate pipenv virtual environment\n\nBuild docs::\n\n $ make -C docs html\n\nAutobuild docs::\n\n $ make -C docs livehtml\n\nCheck spelling in docs::\n\n $ make -C docs spelling\n\nRun tests::\n\n $ pytest\n\nRun tests on multiple python versions::\n\n $ tox\n\nUpload to pypi (using twine)::\n\n $ python setup.py upload\n\nUse with Docker\n---------------\n\nTo use with docker-compose, use the following:\n\nRun a tutorial notebook (copy link w/ token, open tutorial.ipynb)::\n\n $ docker-compose up jupyter\n\nLive-edit docs::\n\n $ docker-compose up docs\n\nOpen a shell::\n\n $ docker-compose run --rm shell\n\nRun tests::\n\n $ docker-compose run --rm test\n\nRun the CLI::\n\n $ docker-compose run --rm eeweather --help\n\n\nNotice Regarding CZ2010 Data\n----------------------------\n\nThere may be conditions placed on their international commercial use.\nThey can be used within the U.S. or for non-commercial international activities without restriction.\nThe non-U.S. data cannot be redistributed for commercial purposes.\nRe-distribution of these data by others must provide this same notification.\n\nSee `further explanation <http://weather.whiteboxtechnologies.com/faq#Q12/>`_ here. \n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Weather for Open Energy Efficiency Meter",
"version": "0.3.25",
"project_urls": {
"Homepage": "http://github.com/openeemeter/eeweather"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1eb375a00a86f0775aa553ef433964a2f52daf5a69aa7f7bbb4a927641c4c457",
"md5": "6089fc805420615bcaf00b3565c921bf",
"sha256": "1ab228d5f63299cfc1b1a6b74c444baefc75b407830a54c53434d069725c92d3"
},
"downloads": -1,
"filename": "eeweather-0.3.25-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "6089fc805420615bcaf00b3565c921bf",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 4090775,
"upload_time": "2024-01-14T01:54:24",
"upload_time_iso_8601": "2024-01-14T01:54:24.349037Z",
"url": "https://files.pythonhosted.org/packages/1e/b3/75a00a86f0775aa553ef433964a2f52daf5a69aa7f7bbb4a927641c4c457/eeweather-0.3.25-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b429ac0f253b94b4a3ccc6728954f7ef5d877d7b734e92fa9da3ba3cee35fadd",
"md5": "e9a8d459119937fe8edad34b5d45e5b9",
"sha256": "b315a5da28dcac88ca6d08018d3ed3e456f2d46644ae6dc557bc3533fe7ba1c7"
},
"downloads": -1,
"filename": "eeweather-0.3.25.tar.gz",
"has_sig": false,
"md5_digest": "e9a8d459119937fe8edad34b5d45e5b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4090299,
"upload_time": "2024-01-14T01:54:27",
"upload_time_iso_8601": "2024-01-14T01:54:27.093121Z",
"url": "https://files.pythonhosted.org/packages/b4/29/ac0f253b94b4a3ccc6728954f7ef5d877d7b734e92fa9da3ba3cee35fadd/eeweather-0.3.25.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-14 01:54:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "openeemeter",
"github_project": "eeweather",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"tox": true,
"lcname": "eeweather"
}