OpenPH-Demand

Energy demand calculations for Passive House (PHPP)

Part of the openph UV workspace - implements PHPP energy demand calculations with exact numerical fidelity to Excel PHPP.

Purpose

OpenPH-Demand calculates:

Annual Heating Demand: Transmission and ventilation heat losses, internal/solar gains
Annual Cooling Demand: Solar gains, internal gains, cooling strategies
Solar Radiation: Window and opaque surface solar radiation for heating/cooling periods
Ground Heat Transfer: Temperature calculations for ground-coupled surfaces
Peak Heating/Cooling Loads: Design load calculations

Structure

openph-demand/
├── src/
│   └── openph_demand/
│       ├── heating_demand/      # Heating demand calculations
│       ├── cooling_demand/      # Cooling demand calculations
│       ├── ground/              # Ground heat transfer
│       ├── solar/               # Solar radiation calculations
│       ├── to_table/            # Table view renderers
│       ├── get_solvers.py       # Type-safe solver accessors
│       └── solvers.py           # Solver classes (Energy, Ground, Solar)
├── tests/
└── pyproject.toml

Usage

from openph.phpp import OpPhPHPP
from openph_demand.get_solvers import (
    get_openph_energy_demand_solver,
    get_openph_ground_solver,
    get_openph_solar_solver,
)

# Create PHPP model
phpp = OpPhPHPP()

# Get solvers (registered via entry points)
energy_solver = get_openph_energy_demand_solver(phpp)
ground_solver = get_openph_ground_solver(phpp)
solar_solver = get_openph_solar_solver(phpp)

# Access demand calculations
heating_demand = energy_solver.heating_demand
cooling_demand = energy_solver.cooling_demand

# Get results
annual_heating_kwh_m2 = heating_demand.total_annual_demand_kwh_m2
annual_cooling_kwh_m2 = cooling_demand.annual_demand_kwh_m2
ground_temps = ground_solver.periods
solar_radiation = solar_solver.annual_demand

Registered Solvers

This package registers three solver plugins with OpenPH:

energy_demand → OpPhEnergyDemandSolver (heating + cooling)
ground → OpPhGroundSolver (ground heat transfer)
solar_radiation → OpPhSolarRadiationSolver (solar gains)

Development

Part of UV workspace - see root context/ENVIRONMENT.md:

uv sync                           # Install all workspace packages
uv run pytest openph-demand/tests/ # Run tests

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openph_demand-0.5.0.tar.gz (94.9 kB view details)

Uploaded Aug 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

openph_demand-0.5.0-py3-none-any.whl (99.2 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file openph_demand-0.5.0.tar.gz.

File metadata

Download URL: openph_demand-0.5.0.tar.gz
Upload date: Aug 14, 2026
Size: 94.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openph_demand-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`1942b723af5be8a35693b9b01b7ec3d294a5fe2d617910a6aa09a38b90946a86`
MD5	`d7ab027d688fd4edd65538c5d025b640`
BLAKE2b-256	`b34fdc903b554c4f5d75021f23bb83e08f5e467b22548349d2a70e9766fd0bd7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openph_demand-0.5.0.tar.gz:

Publisher: publish.yml on Open-PH/openph-demand

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openph_demand-0.5.0.tar.gz
- Subject digest: 1942b723af5be8a35693b9b01b7ec3d294a5fe2d617910a6aa09a38b90946a86
- Sigstore transparency entry: 2466732067
- Sigstore integration time: Aug 14, 2026
Source repository:
- Permalink: Open-PH/openph-demand@29288904670957f2186673ec4850f15c87ba010a
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Open-PH
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@29288904670957f2186673ec4850f15c87ba010a
- Trigger Event: workflow_dispatch