futureweather 0.1.0

Generate future climate-adjusted EPW/DDY/STAT weather files for building energy simulation.

futureweather

Generate future climate-adjusted EPW, DDY, and STAT weather files for building energy simulation.

Uses CMIP6 climate projections to morph historical EnergyPlus Weather (EPW) files into future scenarios. Zero dependencies -- uses only the Python standard library.

Install

pip install futureweather

Quick start

import futureweather

# Generate a future EPW for 2050 under high emissions
paths = futureweather.generate(
    api_key="fw_your_token",
    epw="Chicago_OHare.epw",
    year=2050,
    scenario="ssp585",
    output_dir="./future/",
)
print(paths)
# ['./future/Chicago_OHare_2050_ssp585.epw', './future/Chicago_OHare_2050_ssp585.stat']

Batch generation

Generate files for multiple years and scenarios at once:

results = futureweather.batch(
    api_key="fw_your_token",
    epw="Chicago_OHare.epw",
    years=[2050, 2080],
    scenarios=["ssp245", "ssp585"],
    output_dir="./future_weather/",
)
print(results["summary"])  # "4/4 completed"

Include design day (DDY) files

paths = futureweather.generate(
    api_key="fw_your_token",
    epw="Chicago_OHare.epw",
    ddy="Chicago_OHare.ddy",
    year=2050,
    scenario="ssp585",
    output_dir="./future/",
)
# Returns EPW + DDY + STAT files

Check your credit balance

me = futureweather.authenticate("fw_your_token")
print(f"Credits: {me['credits']}")

Available scenarios

Scenario	Description	Approx. warming by 2100
ssp126	Low emissions	~1.8 C
ssp245	Moderate emissions	~2.7 C
ssp370	High emissions	~3.6 C
ssp585	Very high emissions	~4.4 C

Target years: 2035 to 2090.

Getting an API key

1. Create an account at app.futureweather.co
2. Go to API > API Keys and create a Personal Access Token
3. Your token will start with fw_

Advanced usage

For fine-grained control, use the lower-level functions:

import futureweather

# Submit without waiting
result = futureweather.submit_job("fw_...", "file.epw", 2050, scenario="ssp585")
job_id = result["jobs"][0]["id"]

# Check status
status = futureweather.check_status("fw_...", job_id)
print(status["status"])  # PENDING, RUNNING, SUCCESS, FAILED

# Get download links
links = futureweather.get_downloads("fw_...", job_id)

# Download to disk
paths = futureweather.download_results("fw_...", job_id, "./output/")

Links

• Website: futureweather.co
• App & API docs: app.futureweather.co
• Support: [e-mail]