eeweather
Fetch NCDC ISD, TMY3, or CZ2010 weather data that corresponds to ZIP Code Tabulation Areas or Latitude/Longitude.
https://github.com/opendsm/eeweather
Keywords
weather weather-data weather-station
Keywords from Contributors
building-energy efficiency energy-data energy-efficiency
Last synced: 25 minutes ago
JSON representation
Acceptance Criteria
- Revelant topics? true
- External users? true
- Open source license? true
- Active? true
- Fork? false
Repository metadata
Fetch NCDC ISD, TMY3, or CZ2010 weather data that corresponds to ZIP Code Tabulation Areas or Latitude/Longitude.
- Host: GitHub
- URL: https://github.com/opendsm/eeweather
- Owner: opendsm
- License: apache-2.0
- Created: 2018-01-29T21:14:08.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-07-22T22:52:08.000Z (19 days ago)
- Last Synced: 2026-07-23T00:23:08.958Z (19 days ago)
- Topics: weather, weather-data, weather-station
- Language: HTML
- Homepage: http://eeweather.openee.io/
- Size: 35.3 MB
- Stars: 51
- Watchers: 7
- Forks: 20
- Open Issues: 6
- Releases: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
README.md
EEweather: Weather station wrangling for EEmeter
EEweather — tools for matching to and fetching data from NCEI GHCNh, 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.
Documentation lives at opendsm.energy.
Usage
import datetime
import eeweather
station = eeweather.WeatherStation("722880")
df, warnings = station.load_data(
datetime.datetime(2024, 1, 1, tzinfo=datetime.timezone.utc),
datetime.datetime(2024, 12, 31, tzinfo=datetime.timezone.utc),
frequency="hourly",
variables=("temperature",),
)
Installation
EEweather is a python package and can be installed with pip.
$ pip install eeweather
Supported Sources of Weather Data
- NOAA Global Historical Climatology Network hourly (GHCNh)
- 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 NCEI Integrated Surface Database Station History
- NOAA GHCNh station list
- NREL TMY3 site
- Plot maps of outputs
Contributing
Dev installation:
$ python -m venv .venv
$ source .venv/bin/activate
$ pip install -e .[dev]
Run tests:
$ pytest
Run tests on multiple python versions:
$ tox
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
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 here.
Metadata Yearly Updates
Every year, the metadata database needs to be updated. This can be done by running:
docker-compose run --rm eeweather rebuild-db
Owner metadata
- Name: OpenDSM
- Login: opendsm
- Email: info@lfenergy.org
- Kind: organization
- Description: Collaboratively advancing the future of demand-side energy
- Website: https://lfenergy.org/projects/opendsm/
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/19336002?v=4
- Repositories: 3
- Last ynced at: 2025-02-04T14:43:20.546Z
- Profile URL: https://github.com/opendsm
GitHub Events
Total
- Release event: 2
- Delete event: 9
- Pull request event: 6
- Issues event: 2
- Watch event: 1
- Issue comment event: 14
- Push event: 19
- Pull request review event: 2
- Create event: 6
Last Year
- Delete event: 7
- Issues event: 1
- Issue comment event: 8
- Push event: 4
- Create event: 1
Committers metadata
Last synced: 4 days ago
Total Commits: 263
Total Committers: 14
Avg Commits per committer: 18.786
Development Distribution Score (DDS): 0.551
Commits in past year: 2
Committers in past year: 1
Avg Commits per committer in past year: 2.0
Development Distribution Score (DDS) in past year: 0.0
| Name | Commits | |
|---|---|---|
| Phil Ngo | n****l@g****m | 118 |
| Stephen Suffian | s****e@o****o | 57 |
| Stephen Suffian | s****n@g****m | 47 |
| Jason Chulock | j****n@r****m | 12 |
| calebcanchola | c****b@r****m | 10 |
| Craig Maloney | c****g@d****t | 6 |
| Steve | s****e@r****m | 3 |
| Arpan Kotecha | a****n@o****o | 3 |
| Travis Sikes | 1****e | 2 |
| hshaban | h****n@g****m | 1 |
| Phil Ngo | p****l@r****m | 1 |
| Peter Karman | p****n@g****m | 1 |
| Cody Smith | c****y@c****y | 1 |
| Vikhyati Singh | v****i@o****o | 1 |
Committer domains:
- recurve.com: 4
- openee.io: 3
- camus.energy: 1
- gridium.com: 1
- decafbad.net: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 18
Total pull requests: 81
Average time to close issues: 6 months
Average time to close pull requests: 3 months
Total issue authors: 16
Total pull request authors: 16
Average comments per issue: 4.22
Average comments per pull request: 1.04
Merged pull request: 67
Bot issues: 0
Bot pull requests: 6
Past year issues: 2
Past year pull requests: 4
Past year average time to close issues: 5 months
Past year average time to close pull requests: 7 days
Past year issue authors: 2
Past year pull request authors: 1
Past year average comments per issue: 11.0
Past year average comments per pull request: 0.75
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- craigmaloney (2)
- jakesherman (2)
- TechMaz (1)
- travis-recurve (1)
- samuelduchesne (1)
- amrutatkulkarni (1)
- michaelsuhl11 (1)
- enovity (1)
- knithin3 (1)
- aiasmartakis (1)
- OneGeek (1)
- EthanGoldman (1)
- chrisnmills (1)
- zf1990 (1)
- DLDonaldson (1)
Top Pull Request Authors
- ssuffian (31)
- philngo (22)
- dependabot[bot] (6)
- travis-recurve (4)
- jason-recurve (4)
- canchola-recurve (3)
- craigmaloney (2)
- arpankotecha (1)
- hshaban (1)
- EnergySRE (1)
- toshi09 (1)
- jfenna (1)
- Philippe06011957 (1)
- pkarman (1)
- caleb-canchola-recurve (1)
Top Issue Labels
Top Pull Request Labels
- dependencies (6)
Dependencies
- Sphinx * develop
- black ==18.6b4 develop
- coverage * develop
- pytest * develop
- pytest-cov * develop
- pytest-xdist * develop
- snapshottest git://github.com/syrusakbary/snapshottest.git#54117098bd756c0fa6936f3bafab4bf85c58e943 develop
- sphinx-autobuild * develop
- sphinxcontrib-spelling * develop
- tox * develop
- twine * develop
- typing * develop
- Cython *
- Pillow *
- SQLAlchemy *
- Shapely *
- beautifulsoup4 *
- matplotlib <3.0.0
- pandas *
- pyproj *
- requests *
- scipy *
- simplejson *
- sphinxcontrib-spelling ==4.0.1
- python 3.6.6-stretch build
- eeweather_shell latest
- 189 dependencies
Score: 6.682108597449808