Skip to main content

DIN EN ISO 52016

pipeline status coverage report Documentation Status Code style: black

Python implementation of the DIN EN ISO 52016 standard for calculating the energy performance of buildings. The package computes hourly heating and cooling loads for thermal zones using a 5-node thermal-network model per opaque element, solar irradiation via pvlib, and ground-temperature coupling per ISO 13370.

Installation

pip install .

Or for development:

pip install -e ".[dev]"

Quick start

import numpy as np
from iso52016 import (
    Building, Layer, Material, OpaqueElement, Orientation,
    Ventilation, Weather, Window, Zone,
)

# Create materials and layers
concrete = Material(density_kg_m3=2300, thermal_capacity_J_kgK=880, conductivity_W_mK=1.7)
insulation = Material(density_kg_m3=20, thermal_capacity_J_kgK=1450, conductivity_W_mK=0.035)
wall_layers = [Layer(0.2, concrete), Layer(0.1, insulation)]

# Set up weather (8760 hourly values)
weather = Weather(air_temperature=t_air, wind=wind)

# Define building envelope
wall = OpaqueElement(area=50, orientation=Orientation(90, 0), layers=wall_layers)
# ... add more walls, roof, floor

zone = Zone(
    opaque_elements=[wall, ...],
    usable_floor_area=100,
    internal_gains=[np.zeros(8760)],
    lower_temperature_limit=20,
    upper_temperature_limit=26,
)

building = Building(zones=zone, weather=weather)
building.calculate()

print(f"Heating: {zone.heat_load.sum() / 1000:.0f} kWh")
print(f"Cooling: {zone.cool_load.sum() / 1000:.0f} kWh")

See examples/easy_example.py for a complete working example.

Features

  • Hourly heating and cooling load calculation per ISO 52016
  • 5-node thermal network for opaque elements, 2-node for windows
  • Solar irradiation via pvlib (any orientation/tilt)
  • Ground-temperature coupling per ISO 13370
  • Multi-zone support
  • Ventilation with heat recovery

License

BSD 3-Clause.

Independent implementation of the calculation method described in DIN EN ISO 52016-1. This project is not affiliated with, authorized by, or endorsed by ISO, CEN, or DIN, and does not reproduce the text of the standard.

Metadata

Release files for iso52016 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iso52016 0.0.3
File Size Uploaded Provenance Actions
iso52016-0.0.3.tar.gz 32.1 kB Without provenance Details for iso52016-0.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iso52016 0.0.3
File Interpreter ABI Platform Actions
iso52016-0.0.3-py3-none-any.whl Python 3 none any Details for iso52016-0.0.3-py3-none-any.whl

Total release size: 55.1 kB

Release files / iso52016-0.0.3.tar.gz

Download URL iso52016-0.0.3.tar.gz
Size 32.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b680eae3918a63893ba203ce245b9bfe5b05838ca356dac246c05b0fc09e3026
BLAKE2b-256 checksum
How to use checksums
d89062ec5e450c7be2bb0ab56893d116f411010b8caff822fbb48cbb820ee340
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / iso52016-0.0.3-py3-none-any.whl

Download URL iso52016-0.0.3-py3-none-any.whl
Size 23.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
340f52da26328b97f561aad97f2fe17edce0627dc773ba6d46a5895a303f70c2
BLAKE2b-256 checksum
How to use checksums
3b9e79e72430dd55a9302521f035bbc8ee2b18045ec9317f7b88a80943917ce6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Security for iso52016 0.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page