How to use the Hysopt wiki

The Hysopt wiki is your go-to guideline for questions regarding both the theoretical, and practical use side of Hysopt. To keep an overview, the wiki is divided into a couple of sections, which you can find more information about here.

Note that some sections are still under construction and therefore might lack information. We kindly ask for your patience as we keep on improving this wiki. If there are any pages you would like to see added or could provide you with significant value, you can always let us know at

Section 1: Basic Hysopt usage

The first section presumes a limited knowledge of the Hysopt software and will go over the absolute basics to start.

  • Getting started with Hysopt

    • Information on logging in, changing passwords, and the anatomy

    • Also includes an introductory video on how to use Hysopt, an excellent place to start.

  • P&ID modeling, calculation and simulation

    • Holds all the pages needed to make your first model and allows it to both calculate and simulate.

  • Hysopt pages

    • Hysopt has a couple of extra pages that allow you to unlock the full potential of the software, information on their use can be found here.

Section 2: Component overview

The second section goes over all the different components (also known as base circuits) you can find and use in Hysopt. This section is the go to place for component-specific questions.

Section 3: Projects from start to finish

The next section details a step-by-step guide to 2 types of projects you can perform with the Hysopt software. These projects are used daily by the Hysopt delivery team and hence, can be used as a solid baseline to start using the Hysopt software. These pages also hold valuable information on load matching, pump sizing, etc.

  • Conceptual study

    • The conceptual study is used to execute high-level checks for changes to energy centers, for example implementing heat pumps in an installation. The installation will be drawn more simplistically to save on simulation time, for example, by combining a full radiator circuit into 3 radiators. In the following paragraphs, the Hysopt basic methodology is explained.

  • Detail study

    • A detailed model is also referred to as a full digital twin, where the entire location will be drawn in as accurately as possible. Depending on the project this can be the implementation of floor plans throughout the building, with every radiator drawn, connected through pipework exactly as you would find in the real situation.

It’s important to note that the methods explained in this section aren’t the only way to utilize the Hysopt software, these should be used as a guideline throughout the first projects and then be optimised towards personal preferences.

Section 4: Controllers in the inspiration library

The fourth section details more complex projects and their necessary information. The main bulk you’ll find here are the Inspiration Library models and how to connect them to your reference model.

Section 5: Error codes and error messages

In this section you can find a list of all the error codes you might encounter while using the software. If you hit an error and don’t how to solve it, you can look for the explainer here. They are listed based on the calculation step:

Section 6: Frequently asked questions

The final section consists of an FAQ where we will place all kinds of questions and faults we see throughout the Hysopt usage.