.BuildSysPro.UsersGuide.Overview

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 :

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