Release notes

This is the list of changes to opensimula between each release. For full details, see the commit logs.

0.10.0 (November 19, 2026)

Water plants with several generators, primary / secondary circuits and boilers; zones defined by load records; a gallery of examples. It breaks the compatibility of the water systems with 0.9: see Upgrading from 0.9.

New

Fixes that change results

Upgrading from 0.9

The water systems changed. A project of 0.9 with an HVAC_water_system must be updated by hand (the others need nothing):

  1. The generator, its pump and the water flow are no longer parameters of the plant: create an HVAC_water_generator with the equipment and the pump, and refer to it in generators. The water flow is the nominal_water_flow of the equipment (it was design_water_flow).

    0.9:

    
    {"type": "HVAC_water_system", "name": "water_system",
     "water_thermal_generator": "heat_pump", "pump": "pump", "design_water_flow": 0.4137,
     "heating_water_setpoint": "50", ...}
    

    0.10:

    
    {"type": "HVAC_water_generator", "name": "generator", "equipment": "heat_pump", "pump": "pump"},
    {"type": "HVAC_water_system", "name": "water_system", "generators": ["generator"],
     "heating_water_setpoint": "50", ...}
    

  2. The variables of HVAC_water_system have new names:

    0.9 0.10
    T_WCI, T_WCO T_supply, T_return
    T_WGO, T_WGI T_generators_out, T_generators_in
    T_WAVG T_mean
    water_flow secondary_flow (and primary_flow)
    Q_gen Q_generators
    generator_power generators_power (and the new generators_fuel_power, electric_power)
    pump_power pumps_power
    generator_efficiency, generator_part_load efficiency, F_load of each HVAC_water_generator
  3. The examples copied with opensimula examples from 0.9 are not overwritten: delete 07_fan_coil.json (or the whole folder) and copy them again.

  4. A project that lists its own simulation_order gets the new component types (Load_space, HVAC_water_circuit, HVAC_water_generator) at the beginning, which is a valid order; add them to the list to place them.

Earlier versions