modelSimpleHouse

Illustrative example of a simple heating, ventilation and room model

Extends from Modelica.Icons.Example (Icon for runnable examples).

Information

This model contains a simple model of a house with a heating system, ventilation, and weather boundary conditions. It serves as a demonstration case of how the Buildings library can be used.

A step-by-step tutorial on how to build up this model can be found in Buildings.Examples.Tutorial.SimpleHouse. There are however some minor differences between this model and the models in the tutorial:

Different numerical values are used for almost all model parameters.
The solar irradiation (in W/m²) is calculated as the global horizontal irradiation multiplied with a solar heat gain coefficient instead of the direct normal irradiation.
The ventilation system is equiped with a cooler that sets the temperature of the air flow entering the zone equal to a constant value of 20°C.
The damper in the ventilation system is operated by a proportional-controller instead of a hysteresis controller.

Parameters

Type	Name	Default	Description
Modelica.Units.SI.Area	AWall	100	Wall area
Modelica.Units.SI.Area	AWin	5	Window area
Real	gWin	0.3	Solar heat gain coefficient of window
Modelica.Units.SI.Volume	VZone	AWall*3	Wall area
Modelica.Units.SI.HeatFlowRate	QHea_flow_nominal	700	Nominal capacity of heating system
Modelica.Units.SI.MassFlowRate	mWat_flow_nominal	QHea_flow_nominal/10/4200	Nominal mass flow rate for water loop
Modelica.Units.SI.MassFlowRate	mAir_flow_nominal	VZone21.2/3600	Nominal mass flow rate for air loop
Modelica.Units.SI.PressureDifference	dpAir_nominal	200	Pressure drop at nominal mass flow rate for air loop
Boolean	allowFlowReversal	false	= false because flow will not reverse in these circuits

Connectors

Type	Name	Default	Description
BoundaryConditions.WeatherData.Bus	weaBus		Weather data bus

Components

Type	Name	Description
Modelica.Thermal.HeatTransfer.Components.HeatCapacitor	walCap	Thermal mass of walls
Fluid.MixingVolumes.MixingVolume	zon	Very based zone air model
Modelica.Thermal.HeatTransfer.Components.ThermalResistor	conRes	Thermal resistance for convective heat transfer with h=2
Fluid.HeatExchangers.Radiators.RadiatorEN442_2	rad	Radiator
Fluid.Sources.Boundary_pT	bouAir	Air boundary with constant temperature
Fluid.Sources.Boundary_pT	bouWat	Pressure bound for water circuit
BoundaryConditions.WeatherData.ReaderTMY3	weaDat	Weather data reader
Modelica.Thermal.HeatTransfer.Components.ThermalResistor	walRes	Thermal resistor for wall: 25 cm of rockwool
Buildings.HeatTransfer.Sources.PrescribedTemperature	TOut	Exterior temperature boundary condition
Fluid.HeatExchangers.HeaterCooler_u	heaWat	Heater for water circuit
Fluid.Movers.FlowControlled_m_flow	pum	Pump
Modelica.Thermal.HeatTransfer.Sensors.TemperatureSensor	senTemZonAir	Zone air temperature sensor
Fluid.Actuators.Dampers.Exponential	vavDam	Damper
Fluid.Movers.FlowControlled_dp	fan	Constant head fan
Modelica.Thermal.HeatTransfer.Sources.PrescribedHeatFlow	win	Very simple window model
Fluid.HeatExchangers.ConstantEffectiveness	hexRec	Heat exchanger for heat recuperation
Modelica.Blocks.Logical.Hysteresis	hysRad	Hysteresis controller for radiator
Modelica.Blocks.Logical.Not	not1	negation for enabling heating when temperatur is low
Modelica.Blocks.Math.BooleanToReal	booToRea	Boolean to real
Modelica.Blocks.Sources.Constant	con_dp	Pressure head
Modelica.Blocks.Math.Gain	gaiWin	Gain for window solar transmittance and area as HGloHor is in W/m2
Modelica.Blocks.Math.BooleanToInteger	booToInt	Boolean to integer
Controls.Continuous.LimPID	conDam	Controller for damper
Modelica.Blocks.Sources.Constant	TSetRoo	Room temperature set point for air system
Fluid.HeatExchangers.SensibleCooler_T	cooAir	Cooling for supply air
Modelica.Blocks.Sources.Constant	TSupAirCoo	Cooling setpoint for supply air
Buildings.Fluid.Sensors.TemperatureTwoPort	TFanIn	Temperature at fan inlet
Buildings.Fluid.Sensors.TemperatureTwoPort	TFanOut	Temperature at fan outlet

Name	Description
MediumAir
MediumWater

Revisions

August 5, 2024, by Hongxiang Fu:
Added two-port temperature sensors to replace sta_*.T in reference results. This is for IBPSA #1913.
September 15, 2023, by Jelger Jansen:
Move the example model to Buildings.Examples, update the information section, and revise lay-out.
This is for IBPSA, #1791.
June 15, 2022, by Hongxiang Fu:
Changed conDam.yMin from 0.1 to 0.25.
This is for IBPSA, #1624.
May 8, 2017, by Michael Wetter:
Updated heater model.
This is for IBPSA, #763.
November 10, 2016, by Michael Wetter:
Connected supply air temperature to outdoor air temperature, added cooling to supply air, changed capacity of heating system, switched heating pump off when heater is off, and added proportional controller for the air damper.
This is for IBPSA, #584.
September 9, 2016, by Michael Wetter:
Corrected error in window model, as the solar heat gain was not multiplied with the window area. Dymola 2017 reported this error due to mismatching units of W/m2 and W.
June 23, 2016, by Michael Wetter:
Changed graphical annotation.
March 11, 2016, by Michael Wetter:
Corrected wrong limits for hysAir so that uLow < uHigh. This is for IBPSA, #429.
January 22, 2016, by Michael Wetter:
Corrected type declaration of pressure difference. This is for IBPSA, #404.
September 19, 2015, by Filip Jorissen:
First implementation.