Install & Compatibility
Where this runs
tested against v1.43.29 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 46MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 5.5s · import 0.000s · 46MB
46MB installed
● package 46MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
DragonflyEnergyProperties
✓ from dragonfly_energy.properties import DragonflyEnergyProperties
✗ from dragonfly_energy.properties import DragonflyEnergyProperties
des
✓ from dragonfly_energy import des
dragonfly_energy
✓ import dragonfly_energy
Run an EnergyPlus simulation from a Dragonfly Model (DFJSON file)
from dragonfly_energy.simulation import SimulateModel
from ladybug.futil import preparedir
from pathlib import Path
# Create a simulation model
model_path = Path('./model.dfjson')
sim = SimulateModel(model_path)
sim.run()
print(f'Simulation completed. Results in: {sim.output_folder}')
Debug
Known issues
breakingPython 3.7 support dropped in v1.40.0. Only Python 3.8+ supported.fixUpgrade Python to 3.8 or later
affects: ^1.40.0
breakingDeprecated attributes in SimulateModel changed names; old 'run_type' replaced by 'simulation_type'.fixUse 'simulation_type' instead of 'run_type'
affects: >=1.30.0 <1.40.0
deprecatedThe 'Model.load_model' method is deprecated; use Model.from_file instead.fixReplace Model.load_model(path, **kw) with Model.from_file(path, **kw)
affects: >=1.35.0
gotchaSimulateModel output folder is overwritten by default unless you set 'overwrite=False'.fixSimulateModel(model_path, overwrite=False)
affects: >=1.0.0
Upgrade
Version history
1.43.29latest on PyPI · released Jun 18, 2026
Audit
Dependencies
dragonfly-corerequiredCore Dragonfly classes and geometry
honeybee-energyrequiredEnergy simulation engine interface (EnergyPlus)
ladybug-displayoptionalVisualization and display utilities