🔥 Trano: Automated Building Energy Simulation (BES) Model Generation 🚀
📖 Full Documentation: 👉 Trano Docs
Trano is an innovative Python package that automates the creation of complex Building Energy Simulation (BES) Modelica models from simplified information contained in widely used data formats like YAML, JSON, or RDF. Unlike traditional tools that directly convert BIM to BES, Trano introduces an intermediate step, paving the way for seamless integration with IFC translators.
Trano is Modelica library agnostic but is natively designed to work with:
✅ Validated detailed Modelica libraries (e.g., Buildings, IDEAS,...)
✅ Reduced-order models (e.g., AIXLIB, ISO13790,...)
✅ your library...
🧪 Supported libraries and validation
| Library | Version | Zone model | Role |
|---|---|---|---|
| Buildings | 13.0.0 | Buildings.ThermalZones.Detailed.MixedAir |
detailed, validated |
| IDEAS | 3.0.0 | IDEAS.Buildings.Components.Zone |
detailed, validated |
AixLib reduced order (reduced_order) |
3.0.1 | AixLib.ThermalZones.ReducedOrder.ThermalZone |
simplified, informational |
ISO 13790 (iso_13790) |
AixLib 3.0.1 | ISO13790.Zone5R1C |
simplified, informational |
mpc |
- | RC models (R1C1, R3C2, R4C3, ISO 13790) |
control-oriented, CasADi ready |
The HVAC components (radiators, valves, pumps, boilers, heat pumps, air handling units) come from the Buildings library for every Modelica library. The Modelica name of every parameter in every library is listed in the parameter reference.
The models trano generates are validated against ASHRAE Standard 140 (BESTEST): the 27 single-zone cases are simulated for a year with every library and compared with the acceptance limits of the standard and the spread of the reference programs. Buildings and IDEAS pass every case (see the validation results and the walk through the cases); the two simplified zones are reported for information. Simulations run in the official OpenModelica image.
✨ Key Features
🛠️ Built for Open-Source BES
- Designed with widespread adoption in mind.
- Optimized for OpenModelica, but also compatible with Dymola.
🔥 Full Thermal & Electrical Modeling
- Generates both thermal and electrical models.
- Supports building envelope, systems, and electricity.
- Models:
- Envelope (geometry & materials) 🏢
- HVAC systems (emission, hydronic distribution, boilers) ❄️🔥
- Electrical components (PV systems, electrical loads) ⚡
🎨 Easy to Use & Modify
- Generates graphical representations of components & connections 🎭.
- Fully modular design for seamless modifications:
- Envelope 🏠
- Emission 💨
- Hydronic Distribution 🚰
- Production & Electricity ⚡
🎛️ Control-oriented RC models for MPC
mpclibrary:trano create-model house.yaml mpcgenerates simple RC models (R1C1,R3C2,R4C3,ISO13790fromTrano.MPC) from the same building description, with the energy systems (heat pump, chiller, DHW tank, PV, battery, EV charger) inlined as CasADi-ready equations.building_mpcis CasADi/IPOPT ready (flat explicit ODE);buildingis directly runnable with the same weather file, solar gains, occupancy and external data as the other libraries (see the RC models for MPC tutorial).
🚀 With Trano, creating and modifying detailed BES models has never been easier!
📖 Full Documentation: 👉 Trano Docs
1 maintainer
Metadata
1 maintainer
Release files for trano 0.43.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| trano-0.43.0.tar.gz | 202.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| trano-0.43.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 449.2 kB
Release files / trano-0.43.0.tar.gz
| Download URL | trano-0.43.0.tar.gz |
|---|---|
| Size | 202.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f745e7dfea8de3e0dcd8dcdc0417bc254aafd624062a4e4e3e9de0e6ce584746
|
|
BLAKE2b-256 checksum How to use checksums |
5bdd2f94e8b5b843f19c60775abeb21beac5316a6c2a9354d5ed369a46792c95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / trano-0.43.0-py3-none-any.whl
| Download URL | trano-0.43.0-py3-none-any.whl |
|---|---|
| Size | 246.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b1c3050c03d9d23ebf4f717c6ff878dfc30ffe1a30d8fbf66226a0550a270aae
|
|
BLAKE2b-256 checksum How to use checksums |
8866bfeb5886fece66542040c6bffc6928985832e4fed464493c21b40eb73fb7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
