.AixLib.Examples.Tutorial.SimpleHouse

Information

This package contains examples with step-by-step instructions for how to build a system model for a simple house with a heating system, ventilation, and weather boundary conditions. It serves as a demonstration case of how the AixLib library can be used.

The goal of this exercise is to become familiar with Modelica and the AixLib library. Since the AixLib library components are typically used by combining several components graphically, the use of equations falls outside of the scope of this exercise.

For this exercise you will create a model of a simple house, consisting of a heating system, one building zone, and a ventilation model. The exercise starts from a template file that should not produce any errors. This file will be extended in several steps, adding complexity. In between each step the user should be able to simulate the model, i.e., no errors should be produced and simulation results may be compared.

The model has been created in the following stages:

1. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse0 contains a weather data reader which connects the data of the dry bulb temperature to a PrescribedTemperature component and serves as a starting model to implement the entire SimpleHouse model.
2. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse1 implements the building wall by adding a thermal capacity.
3. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse2 adds a window to the building wall. It is assumed that the total injected heat through the window equals the window surface area multiplied by the direct horizontal solar irradiance.
4. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse3 adds an air model which represents the room in the building.
5. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse4 adds heating circuit consisting of a boiler, a radiator, and an on/off circulation pump with a constant mass flow rate. No controller is implemented yet, i.e. the pump and heater are always on.
6. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse5 adds a hysteresis controller for the heating circuit that uses the room temperature as an input.
7. AixLib.Examples.Tutorial.SimpleHouse.SimpleHouse6 adds a ventilation system consisting of a fan, a damper, a heat recovery unit, and a hysteresis controller, that allows to perform free cooling using outside air.

For each stage, firstly the model part is qualitatively explained. Next, the names of the required Modelica models (from the Modelica Standard Library and/or AixLib library) are listed. Finally, we provide high-level instructions of how to set up the model. If these instructions are not clear immediately, have a look at the model documentation and at the type of connectors the model has, try out some things, make an educated guess, etc. Finally, we provide reference results that allow you to check if your implementation is correct. Depending on the parameter values that you choose, results may differ.

The graphical representation of the final model is given below.

Contents

Name	Description
SimpleHouse0	Start file for simple house example
SimpleHouse1	Building wall model
SimpleHouse2	Building window model
SimpleHouse3	Air model
SimpleHouse4	Heating model
SimpleHouse5	Heating controller model
SimpleHouse6	Free cooling model