Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/simulation/running.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,14 @@ Fast simulation using only design day conditions:
--8<-- "docs/snippets/simulation/running/design_day_only.py:example"
```

A design-day-only run needs no weather file: the design days carry their own conditions. Some models still require one.

1. A model with `GroundHeatTransfer:Slab` or `GroundHeatTransfer:Basement` objects whose preprocessor `GroundHeatTransfer:Control` enables is refused without a weather file, because those preprocessors derive ground temperatures from it.
2. A model with `SizingPeriod:WeatherFileDays` or `SizingPeriod:WeatherFileConditionType` fails in EnergyPlus without a weather file, and the result reports the failure.
3. A model with `Site:WaterMainsTemperature` using `CorrelationFromWeatherFile` runs, but EnergyPlus reports a severe error and uses a fixed mains temperature of 10 °C.

A sizing-only model, whose `SimulationControl` requests no run period from the weather file, must be run as a design-day-only run.

### Annual Simulation

Full-year simulation:
Expand Down
3 changes: 1 addition & 2 deletions docs/snippets/simulation/running/design_day_only.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
from idfkit.simulation import simulate

model: IDFDocument = ... # type: ignore[assignment]
weather: str = ... # type: ignore[assignment]
# --8<-- [start:example]
result = simulate(model, weather, design_day=True)
result = simulate(model, design_day=True)
# --8<-- [end:example]
Loading