How-to guides¶
Each guide here takes one task and walks it to a result. They assume you know what you want and are looking for the shortest correct route; if you are still learning the shape of the library, start with the Tutorials instead.
For exact signatures, options, and return types, see the Reference. For why something works the way it does, see Explanation.
Most guides show the same task in both languages, one tab each. Where a task exists in only one of them, the guide says so on its first screen.
Getting set up¶
- Common tasks: quick recipes for load, query, modify, simulate, and round-trip
- How to install idfkit
- How to migrate from eppy
Reading and editing models¶
- How to collect diagnostics instead of throwing: what an editor, a language server, or a batch job needs from a bad file
- How to edit extensible groups: vertices, branch lists, and anything else that repeats
- How to compare two EnergyPlus versions: what changed between two releases, and whether a model survives the move
In the browser¶
These two are TypeScript only, because there is no Python browser runtime.
- How to parse in the browser: serve the schema bundle and keep the parse synchronous
- How to run a simulation in the browser:
hand a model to
@idfkit/engineand read the results back
Working with simulations¶
Running EnergyPlus locally is Python only, and needs an EnergyPlus installation on the machine.
- Simulation overview
- How to run a simulation
- How to run simulations asynchronously
- How to access simulation results
- How to query simulation SQL output
- How to run batch simulations
- How to track simulation progress
- How to cache simulation results
- How to plot simulation results
- How to discover output variables
- How to handle simulation errors
- How to migrate models between EnergyPlus versions
- Design-day sizing workflow
- Run a parametric study
Weather data¶
- Weather overview
- How to search for weather stations
- How to download weather files
- How to apply design days
- How to geocode addresses
- How to warm the weather cache for an offline run
Schedules¶
Scaling out¶
- How to use cloud and remote storage
- How to store simulation results in S3
- How to run simulations as Celery tasks
- How to run distributed simulations with Scythe