eeweather
raw JSON → 0.3.30 verified Fri May 01 auth: no python
Weather data library for the Open Energy Efficiency Meter project. Provides temperature and weather station data for energy efficiency calculations. Version 0.3.30 released Dec 2024, switching to HTTPS API for temperature data. Release cadence is irregular.
pip install eeweather Common errors
error ModuleNotFoundError: No module named 'eeweather' ↓
cause Library not installed or imported incorrectly.
fix
Run 'pip install eeweather' and then use 'from eeweather import ...' (note the double 'ee').
error ValueError: Invalid ZIP code ↓
cause Non-US ZIP code or invalid format passed to TemperatureNormal.from_zip_code().
fix
Ensure the input is a string of 5 digits representing a US ZIP code.
error requests.exceptions.ConnectionError: HTTPSConnectionPool ↓
cause Network issue connecting to the NOAA API (new HTTPS backend).
fix
Check internet connectivity and firewall rules. If using a proxy, configure requests accordingly.
Warnings
breaking Version 0.3.30 changed backend from FTP to HTTPS API. If you relied on FTP connectivity or had custom FTP logic, update your code. ↓
fix Use the latest version; old FTP code will break. Ensure network access to the new HTTPS endpoint.
gotcha TemperatureNormal.from_zip_code() works only for US ZIP codes. Using non-US codes raises a ValueError. ↓
fix Pre-validate that input is a 5-digit US ZIP code.
deprecated The 'rank' parameter in station distance functions is ignored in recent versions; use 'max_distance' instead. ↓
fix Replace rank= with max_distance= in station selection.
Imports
- TemperatureNormal wrong
from eeweather import TemperatureNormcorrectfrom eeweather import TemperatureNormal - WeatherSource wrong
from eeweather import WeatherSourceBasecorrectfrom eeweather import WeatherSource
Quickstart
from eeweather import TemperatureNormal
# Fetch temperature normal for a ZIP code (US only)
zn = TemperatureNormal.from_zip_code('95110')
print(zn.temperatures)