analyze_epw
ClaudeSummary statistics of any public EPW by URL (OneBuilding, EnergyPlus, a shared file): location header, dry-bulb mean/min/max, annual global horizontal irradiation, data range warnings. Free, no key. 10 MB max.
Overview
EPW.tools generates EnergyPlus weather files (EPW, DDY, STAT) for any location on Earth and any year since 1980, from station observations fused with ERA5/MERRA-2 reanalysis and satellite solar, validated against ASHRAE (0.25 °C over 159,000 checks) and checked against EnergyPlus and DesignBuilder before download. Free tools: nearest stations, design conditions in two modes (ASHRAE method or EPW.tools Enhanced), CMIP6 model list, and analysis of any public EPW by URL. Generation tools (actual year, TMY, forecast, future climate) use the user's EPW.tools API key; a free account includes 3 credits.
Tools
generate_epw
ClaudeStart an actual-year (AMY) EPW + DDY + STAT for any point, 1980 to last year. 1 credit; +2 with urban_street_level (53 US cities: hourly street-level air temperature from citizen stations). Returns a job_id; poll with get_job_result.
generate_forecast
ClaudeStart a forecast EPW for the next 1-15 days (operational sims, MPC, demand response). Up to 7 days free.
generate_future_climate
ClaudeStart a CMIP6-morphed future EPW (Belcher 2005). scenario: ssp126, ssp245, ssp370, ssp585; horizon: any decade 2030-2100; model from list_cmip6_models. 3 credits.
generate_tmy
ClaudeStart a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual). 1 credit.
get_design_conditions
ClaudeHeating and cooling design conditions for any site, free, in one of two modes that are never mixed. mode="ashrae_method": the ASHRAE Handbook Ch. 14 method replicated at the nearest ASHRAE station for the chosen edition (2025, 2021, 2017, 2013, 2009, 2005); validated about 0.25 degC from the published tables. mode="enhanced": EPW.tools Enhanced, not the ASHRAE method: values at the site itself for today's climate with a tested 90 % range. The DDY file for Enhanced costs 1 credit through the web or the API.
get_job_result
ClaudeStatus of a job started by a generate_* tool; when complete, the download URLs (they carry the key).
get_nearest_stations
ClaudeNearest weather stations to a point (name, WMO id, distance, years of record). Free, no key.
list_cmip6_models
ClaudeThe models available for future-climate morphing:
models are global CMIP6 models (NASA NEX-GDDP, 25 km); regional are EURO-CORDEX pairs (12.5 km, Europe only, 27-72 N / 25 W-45 E) usable as model ids. Free.
