Library logo

Buildings.Fluid.SolarCollectors.Data.BaseClasses

Package with base classes for data records of solar thermal collectors

Information

Package with base classes for performance data for solar thermal collectors.

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

Package Content

Name Description
Buildings.Fluid.SolarCollectors.Data.BaseClasses.validateAngles validateAngles Function to validate the provided angles
Buildings.Fluid.SolarCollectors.Data.BaseClasses.Generic Generic Generic data record providing common inputs for ASHRAE93 and EN12975 solar collector models

Buildings.Fluid.SolarCollectors.Data.BaseClasses.validateAngles Buildings.Fluid.SolarCollectors.Data.BaseClasses.validateAngles

Function to validate the provided angles

Information

Function that validates the incidence angle modifiers. If the data are invalid, the function issues an assertion and stops the simulation. Otherwise it returns true.

Extends from Modelica.Icons.Function (Icon for functions).

Inputs

TypeNameDefaultDescription
AngleincAngDat[:] Incident angle data in degrees [rad]
RealincAngModDat[:] Incident angle modifier data [1]

Outputs

TypeNameDescription
Booleanvalid 

Modelica definition

function validateAngles "Function to validate the provided angles" extends Modelica.Icons.Function; input Modelica.Units.SI.Angle[:] incAngDat( each final min=0, each final max=Modelica.Constants.pi/2) "Incident angle data in degrees"; input Real[:] incAngModDat( each final min=0, each final unit="1") "Incident angle modifier data"; output Boolean valid; protected Integer n = size(incAngDat,1) "Number of elements"; algorithm assert(size(incAngModDat, 1) == n, "Both arguments incAngDat and incAngModDat must have the same size."); assert(abs(incAngDat[1]) < 1E-4, "First element of incAngDat must be zero."); assert(abs(Modelica.Constants.pi/2-incAngDat[n]) < 1E-4, "Last element of incAngDat must be pi/2."); assert(abs(1-incAngModDat[1]) < 1E-4, "First element of incAngModDat must be 1."); assert(abs(incAngModDat[n]) < 1E-4, "Last element of incAngModDat must be 0."); valid := true; end validateAngles;

Buildings.Fluid.SolarCollectors.Data.BaseClasses.Generic Buildings.Fluid.SolarCollectors.Data.BaseClasses.Generic

Generic data record providing common inputs for ASHRAE93 and EN12975 solar collector models

Information

Partial record containing common performance parameters for ASHRAE93 and EN12975 solar collector models.

Depending on the data source that is used, different parameters are available to model the thermal capacity of the solar collector. The choice of CTyp determines which parameters are used to calculate the representative heat capacity of the entire solar collector (including fluid). When the dry mass of the solar collector is used to calculate the heat capacity, the collector is assumed to be made fully out of copper (specific heat capacity of 385 J/kg/K).

CTyp C V mDry
TotalCapacity CTot / /
DryCapacity CDry V /
DryMass / V mDry

Extends from Modelica.Icons.Record (Icon for records).

Contents

TypeNameDefaultDescription
AreaA Area [m2]
HeatCapacityCTyp Total thermal capacity or fluid volume and 'dry' thermal capacity or mass
HeatCapacityC Dry or total thermal capacity of the solar thermal collector [J/K]
VolumeV Fluid volume [m3]
MassmDry Dry mass [kg]
RealmperA_flow_nominal Nominal mass flow rate per unit area of collector [kg/(s.m2)]
PressureDifferencedp_nominal Nominal pressure drop [Pa]
AngleincAngDat[:]Modelica.Units.Conversions.f...Incident angle data [rad]
RealincAngModDat[size(incAngDat, 1)] Incident angle modifier data [1]

Modelica definition

record Generic "Generic data record providing common inputs for ASHRAE93 and EN12975 solar collector models" extends Modelica.Icons.Record; parameter Modelica.Units.SI.Area A "Area"; parameter Buildings.Fluid.SolarCollectors.Types.HeatCapacity CTyp "Total thermal capacity or fluid volume and 'dry' thermal capacity or mass"; parameter Modelica.Units.SI.HeatCapacity C "Dry or total thermal capacity of the solar thermal collector"; parameter Modelica.Units.SI.Volume V "Fluid volume "; parameter Modelica.Units.SI.Mass mDry "Dry mass"; parameter Real mperA_flow_nominal(final unit="kg/(s.m2)") "Nominal mass flow rate per unit area of collector"; parameter Modelica.Units.SI.PressureDifference dp_nominal(displayUnit="Pa") "Nominal pressure drop"; parameter Modelica.Units.SI.Angle[:] incAngDat=Modelica.Units.Conversions.from_deg({0,10,20,30,40,50,60,70,80,90}) "Incident angle data"; parameter Real[size(incAngDat,1)] incAngModDat( each final min=0, each final unit="1") "Incident angle modifier data"; final parameter Boolean validated = validateAngles( incAngDat=incAngDat, incAngModDat=incAngModDat) "True if data are valid, otherwise an assertion is issued"; end Generic;