Skip to content

Add init time to KPIs #140

Description

@HvanderStok

Feature Request: Support for Initialization (Warm-up) Period in KPI Calculations

Description

It would be beneficial to add an option to set an initialization time (or "warm-up period") for KPI calculations.

Motivation

In many building energy simulations, the thermal masses and heat capacities start at a default ambient temperature. It takes a certain amount of simulation time for these components to reach realistic operating temperatures.

Currently, if KPI calculations begin at $t=0$, the results are biased by these initial transients. For example, the energy required to "charge" the thermal mass of the building at the start of the simulation:

$$Q = m \cdot c_p \cdot (T_{set} - T_{init})$$

is often disproportionately high and does not reflect the steady-state performance of the system. Introducing a warm-up period would allow the model to reach thermal equilibrium before data collection starts.

Suggested Behavior

  • Add a parameter (e.g., warmup_period or init_time) to the KPI configuration.
  • The simulation should run as normal from $t=0$, but the KPI aggregators should only begin recording/averaging data after the specified time has elapsed.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions