Buildings.ThermalZones.ISO13790.BaseClasses

Package with base classes for Buildings.Fluid

Information

This package contains base classes that are used to construct the models in IBPSA.ThermalZones.ISO13790.

Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).

Package Content

Name	Description
GainMass	Mass node heat flow
GainSurface	Surface node heat flow
GlazedElements
OpaqueElements

Buildings.ThermalZones.ISO13790.BaseClasses.GainMass

Mass node heat flow

Buildings.ThermalZones.ISO13790.BaseClasses.GainMass

Information

This model calculates the heat gains injected to the mass node. More information can be found in the documentation of Buildings.ThermalZones.ISO13790.Zone5R1C.Zone

Parameters

Type	Name	Description
Area	ATot	Total area of building's surfaces facing the thermal zone [m2]
Real	facMas	Effective mass area factor
Area	AFlo	Floor area [m2]

Connectors

Type	Name	Description
input RealInput	intSenGai	Internal sensible heat gains [W]
input RealInput	solGai	Solar gains [W]
output RealOutput	masGai	Heat gain to mass node [W]

Modelica definition

model GainMass "Mass node heat flow" Modelica.Units.SI.Area AMas "Effective mass area (see Table 12 in standard)"; parameter Modelica.Units.SI.Area ATot "Total area of building's surfaces facing the thermal zone"; parameter Real facMas "Effective mass area factor"; parameter Modelica.Units.SI.Area AFlo "Floor area"; Modelica.Blocks.Interfaces.RealInput intSenGai(final unit="W") "Internal sensible heat gains"; Modelica.Blocks.Interfaces.RealInput solGai(final unit="W") "Solar gains"; Modelica.Blocks.Interfaces.RealOutput masGai(final unit="W") "Heat gain to mass node"; equation AMas = facMas*AFlo; masGai=((AMas/ATot)*(0.5*intSenGai + solGai)); end GainMass;

Buildings.ThermalZones.ISO13790.BaseClasses.GainSurface

Surface node heat flow

Buildings.ThermalZones.ISO13790.BaseClasses.GainSurface

Information

This model calculates the heat gains injected to the surface node. More information can be found in the documentation of Buildings.ThermalZones.ISO13790.Zone5R1C.Zone

Parameters

Type	Name	Description
Area	ATot	Total area of building's surfaces facing the thermal zone [m2]
ThermalConductance	HWinGai	Thermal conductance through windows [W/K]
Real	facMas	Effective mass area factor
Area	AFlo	Floor area [m2]

Connectors

Type	Name	Description
input RealInput	intSenGai	Internal sensible heat gains [W]
input RealInput	solGai	Solar gains [W]
output RealOutput	surGai	Heat gain to surface node [W]

Modelica definition

model GainSurface "Surface node heat flow" Modelica.Units.SI.Area AMas "Effective mass area (see Table 12 in standard)"; parameter Modelica.Units.SI.Area ATot "Total area of building's surfaces facing the thermal zone"; parameter Modelica.Units.SI.ThermalConductance HWinGai "Thermal conductance through windows"; parameter Real facMas "Effective mass area factor"; parameter Modelica.Units.SI.Area AFlo "Floor area"; Modelica.Blocks.Interfaces.RealInput intSenGai(final unit="W") "Internal sensible heat gains"; Modelica.Blocks.Interfaces.RealInput solGai(final unit="W") "Solar gains"; Modelica.Blocks.Interfaces.RealOutput surGai(final unit="W") "Heat gain to surface node"; equation AMas = facMas*AFlo; surGai= (1 - AMas/ATot - HWinGai/(9.1*ATot))*(0.5*intSenGai + solGai); end GainSurface;

Buildings.ThermalZones.ISO13790.BaseClasses.GlazedElements

Information

This model calculates the heat flow by solar gains through each glazed element k. The heat flow is given by

Φ_sol,k =F_sh,kI_sol,kg_fac (1-F_frame) A_win,k

where F_sh,k is the shading reduction factor which is set to 0.9 by deafult, I_sol,k is the solar irradiance per square meter of surface area, g_fac is the total solar energy transmittance of the trasparent element, F_frame is the frame area fraction, and A_win,k is the overall area of the glazed element in square meters. The model neglects the extra heat flow due to thermal radiation to the sky from the building.

Parameters

Type	Name	Default	Description
Integer	n
Real	AWin[:]		Area of windows
Real	surTil[:]		Tilt angle of surfaces
Real	surAzi[:]		Azimuth angle of surfaces
Real	gFac		Energy transmittance of glazings
Real	winFra		Frame fraction of windows
Real	shaRedFac	0.9	Shading reduction factor [1]

Connectors

Type	Name	Description
Bus	weaBus
output RealOutput	solRadWin	Solar radiation through windows

Modelica definition

model GlazedElements parameter Integer n; parameter Real AWin[:] "Area of windows"; parameter Real surTil[:] "Tilt angle of surfaces"; parameter Real surAzi[:] "Azimuth angle of surfaces"; parameter Real gFac "Energy transmittance of glazings"; parameter Real winFra "Frame fraction of windows"; parameter Real shaRedFac( final min=0, final unit="1")= 0.9 "Shading reduction factor"; Buildings.BoundaryConditions.WeatherData.Bus weaBus; BoundaryConditions.SolarIrradiation.DirectTiltedSurface HDirTil[n]( final til=surTil, final azi=surAzi) "Direct solar irradiation on surface"; Modelica.Blocks.Math.Gain solRad[n](final k=AWin*gFac*shaRedFac*(1 - winFra)) "Solar radiation"; Modelica.Blocks.Interfaces.RealOutput solRadWin "Solar radiation through windows"; BoundaryConditions.SolarIrradiation.DiffusePerez HDifTil[n]( final til=surTil, final azi=surAzi) "Diffuse solar irradiation on surface"; protected Modelica.Blocks.Math.Add irr[n] "Total of direct and diffuse radiation on surface"; Modelica.Blocks.Math.MultiSum multiSum(final nu=n) "Sum of all orientations"; equation for i in 1:n loop connect(weaBus,HDifTil[i].weaBus); end for; for i in 1:n loop connect(weaBus,HDirTil[i].weaBus); end for; connect(solRad.y, multiSum.u); connect(multiSum.y, solRadWin); connect(HDirTil.H,irr. u1); connect(HDifTil.H,irr. u2); connect(irr.y, solRad.u); end GlazedElements;

Buildings.ThermalZones.ISO13790.BaseClasses.OpaqueElements

Information

This model calculates the heat flow by solar gains through each opaque building element k. The heat flow is given by

Φ_sol,k =F_sh,kI_sol,k α_k R_se U_k A_k - F_f Φ_r,k

where F_sh,k is the shading reduction factor, I_sol,k is the solar irradiance per square meter of surface area, α_k is the dimensionless absportion coefficient for solar radiation of the opaque element, R_se is the external surface heat resistance of the opaque element in (m K/W), and A_k is the area of the opaque element.

The form factor between the building element and the sky F_f is set to 1 for roofs and 0.5 for external walls. The extra heat flow due to thermal radiation to the sky is given by

Φ_r,k =h_r ΔT_sky R_se U_k A_k

where h_r is the external radiative heat transfer coefficent which is approximated as 5 ε W/m²K (where ε is the emissivity for the thermal radiation of the external surface), and ΔT_sky is the average temperature difference between the external air temperature and the apparent sky temperature.

Parameters

Type	Name	Default	Description
Integer	n
Real	AWal[:]		Area of external walls
Real	ARoo		Area of roof
Real	UWal		U-value of external walls
Real	URoo		U-value of roof
Real	surTil[:]		Tilt angle of surfaces
Real	surAzi[:]		Azimuth angle of surfaces
Real	eps	0.9	Emissivity of external surface
Real	alp	0.6	Absorption coefficient
Real	surRes	0.04	External surface heat resistance

Connectors

Type	Name	Description
Bus	weaBus
output RealOutput	y	Solar radiation through windows

Modelica definition

model OpaqueElements parameter Integer n; parameter Real AWal[:] "Area of external walls"; parameter Real ARoo "Area of roof"; parameter Real UWal "U-value of external walls"; parameter Real URoo "U-value of roof"; parameter Real surTil[:] "Tilt angle of surfaces"; parameter Real surAzi[:] "Azimuth angle of surfaces"; parameter Real eps=0.9 "Emissivity of external surface"; parameter Real alp=0.6 "Absorption coefficient"; parameter Real surRes=0.04 "External surface heat resistance"; Buildings.BoundaryConditions.WeatherData.Bus weaBus; BoundaryConditions.SolarIrradiation.DirectTiltedSurface HDirTil[n]( final til=surTil, final azi=surAzi); Modelica.Blocks.Math.Gain solRadOpa[n](final k=AWal*alp*UWal*surRes) "Solar radiation on vertical opaque surfaces"; Modelica.Blocks.Interfaces.RealOutput y "Solar radiation through windows"; BoundaryConditions.SolarIrradiation.DiffusePerez HDifTil [n]( final til=surTil, final azi=surAzi); Modelica.Blocks.Math.Add irrOpa[n] "Total of direct and diffuse radiation on surface"; Modelica.Blocks.Math.Add addOpa[n](each k2=-1) "Total of direct and diffuse radiation on vertical surfaces"; Modelica.Blocks.Math.Gain theRadOpa[n](each k=5*eps*11*0.5) "Extra thermal radiation through walls"; Modelica.Blocks.Math.Add irrRoo "Total of direct and diffuse radiation on the south facade"; Modelica.Blocks.Math.Gain solRadRoo(final k=ARoo*alp*URoo*surRes) "Solar radiation on roof"; Modelica.Blocks.Math.Gain theRadRoo(final k=5*eps*11*1) "Extra thermal radiation through roof"; Modelica.Blocks.Math.Add addRoo(k2=-1) "Total of direct and diffuse radiation on the roof"; Modelica.Blocks.Math.MultiSum multiSum(nu=n); Modelica.Blocks.Math.Add addTot "Total of direct and diffuse radiation on the south facade"; protected Modelica.Blocks.Sources.RealExpression facOpa[n](y=UWal*AWal*surRes) "factor"; BoundaryConditions.SolarIrradiation.DirectTiltedSurface HDirTilRoo(til=0, azi= 0); BoundaryConditions.SolarIrradiation.DiffusePerez HDifTilRof(til=0, azi=0); protected Modelica.Blocks.Sources.RealExpression facRoo(y=URoo*ARoo*surRes) "factor"; equation for i in 1:n loop connect(weaBus,HDifTil[i].weaBus); end for; for i in 1:n loop connect(weaBus,HDirTil[i].weaBus); end for; connect(HDirTil.H, irrOpa.u1); connect(HDifTil.H, irrOpa.u2); connect(irrOpa.y, solRadOpa.u); connect(HDirTilRoo.H, irrRoo.u1); connect(HDifTilRof.H, irrRoo.u2); connect(HDirTilRoo.weaBus, weaBus); connect(HDifTilRof.weaBus, weaBus); connect(irrRoo.y, solRadRoo.u); connect(facRoo.y, theRadRoo.u); connect(addOpa.y, multiSum.u); connect(solRadOpa.y, addOpa.u1); connect(theRadRoo.y, addRoo.u2); connect(solRadRoo.y, addRoo.u1); connect(addTot.y, y); connect(addRoo.y, addTot.u2); connect(multiSum.y, addTot.u1); connect(facOpa.y, theRadOpa.u); connect(theRadOpa.y, addOpa.u2); end OpaqueElements;