BuildSysPro.UsersGuide.Overview

# .BuildSysPro.UsersGuide.Overview

Overview of BuildSysPro Library

## Information

The `BuildSysPro` library is a free open-source Modelica library for modeling building and energy systems.

`BuildSysPro` provides a set of elementary 0D/1D components to describe envelope components, energy equipments and devices, and control systems. It is mainly based on two branches of physics: pure thermal and thermofluid dynamics modelling. These classes are compliant with the `Modelica.Thermal.HeatTransfer` and `Modelica.Media` packages of the Modelica standard library to ensure a good level of interoperability with other Modelica libraries. These models are designed for static and dynamic modelling.

The way of modelling building energy systems with `BuildSysPro` is similar to the approach commonly used by the building science community. An energy simulation is performed by assembling a building envelope, with energy systems, equipments and their controls, and boundary conditions for external and internal conditions. The meteorological conditions are part of the external conditions and occupancy or heating patterns are considered through the internal conditions. The figure below shows the top-level structure of `BuildSysPro`:

- The `User's Guide` package provides some basic information about `BuildSysPro` and license information.
- The `Building` package is intended to describe the building envelope and air change, and provides components in a pure thermal or thermo-fluid approach. It also contains generic models of zones which can represent an entire building or a single room.
- The `Systems` package provides models for systems modelling and control, including HVAC, Domestic Hot Water (DHW) and Solar systems. The `Controls` package provides control and regulation components for HVAC systems or energy equipments.
- The `BoundaryConditions` package contains several models which offer the possibility of reading and pre-processing boundary conditions from files, such as weather data or normative indoor scenarios.
- The `BuildingStock` package contains some reference buildings, including the Mozart house, which is a medium size detached house from a typological study of the French housing stock.
- The `Utilities` package includes special Modelica types, records, package icons, functions, blocks and models. The records are used to set the parameters of various models in a hierarchical way (wall layers, walls, zones...). A `Math` sub-package contains, inter alia, some non linear solvers. The `Analysis` sub-package includes some basic classes for analysis, as for instance to describe human comfort in a room.
- The `BaseClasses` package establishes the link with the Modelica standard library. It contains the same connectors as the `Modelica.Thermal.HeatTransfer` and `Modelica.Media` packages. It also includes some other elementary models which are not of interest for end-users.

The interfaces of BuildSysPro are based on those from the Modelica standard library to ensure the compatibility of modelling. For instance, the connectors of the `Modelica.Thermal.HeatTransfer` class are based on two variables, a temperature as a potential and a heat flow rate as a flow. The upcoming `Fluid` class is compliant with the `Modelica.Media` class, that is to say a media model is described with the `Modelica.Media.Interfaces` and a connector similar to the `Modelica.Media.Examples.Tests.Components.FluidPort` , which does not use stream connectors. Stream-compatible Annex 60 library components will be included in a forthcoming version of BuildSysPro.

A reference paper detailing BuildSysPro and BESTEST validation is available online :

G. Plessis, A. Kaemmerlen, A. Lindsay, 2014. BuildSysPro: a Modelica library for modelling buildings and energy systems. Proceedings of the Modelica conference 2014, Lund, Sweden, 2014.

--------------------------------------------------------------
Licensed by EDF under a 3-clause BSD-license
Copyright © EDF 2009 - 2023
BuildSysPro version 3.6.0
Author : EDF (2015)
--------------------------------------------------------------

Generated at 2026-05-12T20:19:03Z by OpenModelicaOpenModelica 1.26.7 using GenerateDoc.mos