{"id":23657,"library":"eeweather","title":"eeweather","description":"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.","status":"active","version":"0.3.30","language":"python","source_language":"en","source_url":"https://github.com/openeemeter/eeweather","tags":["weather","energy","efficiency","temperature","NOAA"],"install":[{"cmd":"pip install eeweather","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP requests for weather API","package":"requests","optional":false},{"reason":"Data manipulation","package":"pandas","optional":false}],"imports":[{"note":"Wrong class name, common typo","wrong":"from eeweather import TemperatureNorm","symbol":"TemperatureNormal","correct":"from eeweather import TemperatureNormal"},{"note":"Old name in early versions","wrong":"from eeweather import WeatherSourceBase","symbol":"WeatherSource","correct":"from eeweather import WeatherSource"}],"quickstart":{"code":"from eeweather import TemperatureNormal\n\n# Fetch temperature normal for a ZIP code (US only)\nzn = TemperatureNormal.from_zip_code('95110')\nprint(zn.temperatures)","lang":"python","description":"Basic usage: fetch temperature normal data for a ZIP code."},"warnings":[{"fix":"Use the latest version; old FTP code will break. Ensure network access to the new HTTPS endpoint.","message":"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.","severity":"breaking","affected_versions":">=0.3.30"},{"fix":"Pre-validate that input is a 5-digit US ZIP code.","message":"TemperatureNormal.from_zip_code() works only for US ZIP codes. Using non-US codes raises a ValueError.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace rank= with max_distance= in station selection.","message":"The 'rank' parameter in station distance functions is ignored in recent versions; use 'max_distance' instead.","severity":"deprecated","affected_versions":">=0.3.10"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install eeweather' and then use 'from eeweather import ...' (note the double 'ee').","cause":"Library not installed or imported incorrectly.","error":"ModuleNotFoundError: No module named 'eeweather'"},{"fix":"Ensure the input is a string of 5 digits representing a US ZIP code.","cause":"Non-US ZIP code or invalid format passed to TemperatureNormal.from_zip_code().","error":"ValueError: Invalid ZIP code"},{"fix":"Check internet connectivity and firewall rules. If using a proxy, configure requests accordingly.","cause":"Network issue connecting to the NOAA API (new HTTPS backend).","error":"requests.exceptions.ConnectionError: HTTPSConnectionPool"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}