In Hysopt there are 4 boiler types: 

1. Boiler with setpoint (simplified boiler)

The simplified boiler model generates the temperature that is given as a setpoint. The setpoint can vary depending on the chosen control Base Circuit (BC), and it is connected to the upper left corner of the boiler BC. More information on the setpoints can be found in

The only parameter needed for the design of the system is the KV value. The KV value is needed to calculate the pump head.

If the actual KV value isn't known, the user can click on the "pencil" icon which results in a calculation popup window. In the popup window, the user can calculate the KV value by entering the pressure drop and flow rate (and if needed, the brine, mixture and reference temperature). This option is preferred when the information on the boiler is known. However, the user can also let the software automatically calculate the KV value depending on the design flow rate by using the other tab and entering the estimated pressure drop over the boiler.

For an accurate simulation and representation of the system, the following parameters are needed:

The maximal power is automatically filled in after doing the "Compute design flows". If the user has an actual boiler which has a different thermal power than the system behind it, the user can enter it and lock it by clicking on the "lock" icon. The nominal temperature difference is needed to set scale the efficiency lookup table and is default 20°C. The efficiency lookup table is used during simulation to accurately simulate the primary power and efficiency of the boiler both in full and partial load.

The user can insert and change the efficiency lookup table by clicking on the "pencil" icon. The popup-window has two modes: “Default” and “Custom”. In “Default”-mode, the default efficiency lookup table is used. The user can download the CSV file by clicking on the link indicated in blue. In “Custom”-mode, the user can choose to insert their own efficiency lookup table.

To do this, it’s advised to follow the following steps:

  1. Download the template file by clicking on the blue link. This will give the user an indication of how the custom file must look like in order to be compatible with the Hysopt Optimiser.

  2. The data needed to update the efficiency table is "relative mass flow", "relative power", "return temperature" and "efficiency". Depending on the three-dimensional matrix (relative mass flow, relative power, and return temperature) the efficiency of the boiler can vary. If the manufacturer-specific information is known, the user can enter this into the efficiency table to accurately simulate the boiler. If not, it’s advised to continue using the default efficiency table, as it's sufficiently accurate to represent a common gas condensing boiler model. In general, as long as you are working with a gas condensing boiler, working with the standard table is a good way to save on time.

  3. Save the CSV file and close it. Go back to the Hysopt Optimiser and click on the “Browse” button in order to upload the custom efficiency lookup table. If everything is done right, the Optimiser will show a green prompt. If something went wrong, the Optimiser will show a red prompt with an indication where the error occured.

Always press the “Save” button before closing the pop-window. If you click on another component before saving, your upload will be cancelled!

A step-by-step guide on changing the efficiency lookup table, as well as exemplary templates, can be found here:

2. Dynamic controlled boiler

The dynamic boiler model is a more detailed boiler model than the "boiler with setpoint". Besides the efficiency lookup table, this BC has its own control loop, which controls a gas valve in function of the measured supply temperature. Therefore there are more parameters necessary than the "boiler with setpoint".

Besides the above-mentioned parameters, the user can also adjust the boiler capacitance.

If the boiler capacitance isn't known but the water content and mass of steel is known, the user can calculate the capacitance by clicking on the "pencil" icon and enter these aspects into the capacitance calculator. The average flow temperature and type of refrigerant can also be changed. Next, click on the “Calculate”-button in order to calculate the capacitance.

Always press the “Save” button before closing the pop-window. If you click on another component before saving, your calculation will be cancelled!

The minimal power percentage can be changed depending on the type of boiler. It defines the minimal modulation signal that must be given before the boiler activates. The percentage is taken from the “Maximal power” parameter.

Boilers also typically have thermal losses to the environment, which can be included by entering a certain UA-value. This UA value (W/K) represents the thermal power (W) lost depending on the temperature difference (K) of the boiler and the environment. Note that the environment temperature can also be changed by the user. In default, however, the thermal loss to the environment is indirectly included in the efficiency table, and the UA value is set to zero. 

Furthermore, different control parameters are needed like the proportional band, repeat time, integral thresholds, etc. for accurate and stable control of the boiler. The default values and the control strategy are set resulting out of thorough communications with boiler manufacturers. If the user desires to change these, it's recommended to first contact one of our consultants.

For more information these control parameters, the user can have a look at the following section: .

3. Heat flow controlled boiler

The heat flow controlled boiler is similar to the dynamic model with the only exception that this model has no internal control loop. The user has to apply a control loop on the boiler model, with as input on this model is a power modulation signal between 0 and 1.This model is primarily used for making a cascade control between several boilers or for educational purposes. All necessary parameters for this boiler model are mentioned above.

4. Electric boiler with setpoint

The electric boiler with setpoint is the same as the "boiler with setpoint" with the only exception that the default efficiency table is different. The efficiency of an electric boiler is typically 99%, so the efficiency table is just filled with one row resulting in a constant efficiency, independent of the modulation, return temperature, and flow rate.

Examples of boiler concepts can be found in our Hysopt Inspiration Library: .