Buildings.Experimental.DHC.Loads.BaseClasses.Validation.BaseClasses
Package with base classes
Information
This package contains base classes that are used to construct the classes in Buildings.Experimental.DHC.Loads.BaseClasses.Validation.
Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).
Package Content
| Name | Description |
|---|---|
 Building
|
Dummy building model for validation purposes |
 BuildingWithETS
|
Dummy building with ETS model for validation purposes |
 ETS
|
Dummy ETS model for validation purposes |
Buildings.Experimental.DHC.Loads.BaseClasses.Validation.BaseClasses.Building
Dummy building model for validation purposes
Information
This is a minimum example of a class extending Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuilding developed for testing purposes only.
Extends from Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuilding (Partial class for building model).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | Water | Medium in the building distribution system | |
| MassFlowRate | m_flow_nominal | Nominal mass flow rate [kg/s] | |
| Configuration | |||
| Boolean | have_heaWat | false | Set to true if the building has heating water system |
| Boolean | have_chiWat | false | Set to true if the building has chilled water system |
| Boolean | have_eleHea | false | Set to true if the building has decentralized electric heating system |
| Boolean | have_eleCoo | false | Set to true if the building has decentralized electric cooling system |
| Boolean | have_fan | false | Set to true if fan power is computed |
| Boolean | have_pum | false | Set to true if pump power is computed |
| Boolean | have_weaBus | false | Set to true to use a weather bus |
| Scaling | |||
| Real | facMul | 1 | Multiplier factor |
| Nominal condition | |||
| HeatFlowRate | QChiWat_flow_nominal | Design heat flow rate for chilled water production (<0) [W] | |
| HeatFlowRate | QHeaWat_flow_nominal | Design heat flow rate for heating water production (>0) [W] | |
| Assumptions | |||
| Boolean | allowFlowReversal | false | = true to allow flow reversal, false restricts to design direction (port_a -> port_b) |
Connectors
| Type | Name | Description |
|---|---|---|
| Bus | weaBus | Weather data bus |
| FluidPorts_a | ports_aHeaWat[nPorts_aHeaWat] | Heating water inlet ports |
| FluidPorts_b | ports_bHeaWat[nPorts_bHeaWat] | Heating water outlet ports |
| FluidPorts_a | ports_aChiWat[nPorts_aChiWat] | Chilled water inlet ports |
| FluidPorts_b | ports_bChiWat[nPorts_bChiWat] | Chilled water outlet ports |
| output RealOutput | QHea_flow | Total heating heat flow rate transferred to the loads (>=0) [W] |
| output RealOutput | QCoo_flow | Total cooling heat flow rate transferred to the loads (<=0) [W] |
| output RealOutput | PHea | Power drawn by decentralized heating system [W] |
| output RealOutput | PCoo | Power drawn by decentralized cooling system [W] |
| output RealOutput | PFan | Power drawn by fan motors [W] |
| output RealOutput | PPum | Power drawn by pump motors [W] |
Modelica definition
model Building
"Dummy building model for validation purposes"
extends Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuilding;
parameter Modelica.SIunits.HeatFlowRate QChiWat_flow_nominal
"Design heat flow rate for chilled water production (<0)";
parameter Modelica.SIunits.HeatFlowRate QHeaWat_flow_nominal
"Design heat flow rate for heating water production (>0)";
parameter Modelica.SIunits.MassFlowRate m_flow_nominal
"Nominal mass flow rate";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPHea(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPCoo(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPFan(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPPum(
k=1);
Fluid.HeatExchangers.HeaterCooler_u loaHea(
redeclare final package Medium=Medium,
energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial,
final Q_flow_nominal=-QHeaWat_flow_nominal,
final m_flow_nominal=m_flow_nominal,
dp_nominal=0) if have_heaWat
"Heating load";
Fluid.HeatExchangers.HeaterCooler_u loaCoo(
redeclare final package Medium = Medium,
energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial,
final Q_flow_nominal=-QChiWat_flow_nominal,
final m_flow_nominal=m_flow_nominal,
dp_nominal=0) if have_chiWat
"Cooling load";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant one(k=1) "One";
Buildings.Controls.OBC.CDL.Continuous.AddParameter addPar(
p=0, k=-1) if have_heaWat
"Opposite";
Buildings.Controls.OBC.CDL.Continuous.AddParameter addPar1(
p=0, k=-1) if have_chiWat
"Opposite";
equation
connect(souPHea.y, mulPHea.u);
connect(souPCoo.y, mulPCoo.u);
connect(souPFan.y, mulPFan.u);
connect(souPPum.y, mulPPum.u);
connect(mulHeaWatInl[1].port_b, loaHea.port_a);
connect(loaHea.port_b, mulHeaWatOut[1].port_a);
connect(loaCoo.port_b, mulChiWatOut[1].port_a);
connect(mulChiWatInl[1].port_b, loaCoo.port_a);
connect(loaHea.Q_flow, addPar.u);
connect(loaCoo.Q_flow, addPar1.u);
connect(addPar.y, mulQHea_flow.u);
connect(addPar1.y, mulQCoo_flow.u);
connect(one.y, loaHea.u);
connect(one.y, loaCoo.u);
end Building;
Buildings.Experimental.DHC.Loads.BaseClasses.Validation.BaseClasses.BuildingWithETS
Dummy building with ETS model for validation purposes
Information
This is a minimum example of a class extending Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuildingWithPartialETS developed for testing purposes only.
Extends from Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuildingWithPartialETS (Partial model of a building with an energy transfer station).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package MediumSer | Water | Service side medium | |
| replaceable package MediumSerHea_a | Water | Service side medium at heating inlet | |
| replaceable package MediumBui | Water | Building side medium | |
| Configuration | |||
| Integer | nPorts_heaWat | 0 | Number of heating water fluid ports |
| Integer | nPorts_chiWat | 0 | Number of chilled water fluid ports |
| Scaling | |||
| Real | facMul | 1 | Multiplier factor |
| Assumptions | |||
| Boolean | allowFlowReversalSer | false | Set to true to allow flow reversal on service side |
| Boolean | allowFlowReversalBui | false | Set to true to allow flow reversal on building side |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_aSerAmb | Fluid connector for ambient water service supply line |
| FluidPort_b | port_bSerAmb | Fluid connector for ambient water service return line |
| FluidPort_a | port_aSerHea | Fluid connector for heating service supply line |
| FluidPort_b | port_bSerHea | Fluid connector for heating service return line |
| FluidPort_a | port_aSerCoo | Fluid connector for cooling service supply line |
| FluidPort_b | port_bSerCoo | Fluid connector for cooling service return line |
| Bus | weaBus | Weather data bus |
| output RealOutput | QHea_flow | Total heating heat flow rate transferred to the loads (>=0) [W] |
| output RealOutput | QCoo_flow | Total cooling heat flow rate transferred to the loads (<=0) [W] |
| output RealOutput | PHea | Power drawn by heating system [W] |
| output RealOutput | PCoo | Power drawn by cooling system [W] |
| output RealOutput | PFan | Power drawn by fan motors [W] |
| output RealOutput | PPum | Power drawn by pump motors [W] |
| output RealOutput | QFue_flow[nFue] | Fuel energy input rate [W] |
Modelica definition
model BuildingWithETS
"Dummy building with ETS model for validation purposes"
extends Buildings.Experimental.DHC.Loads.BaseClasses.PartialBuildingWithPartialETS
(
redeclare ETS ets,
redeclare Building bui(
final QChiWat_flow_nominal=QChiWat_flow_nominal,
final QHeaWat_flow_nominal=QHeaWat_flow_nominal,
final m_flow_nominal=ets.m_flow_nominal));
end BuildingWithETS;
Buildings.Experimental.DHC.Loads.BaseClasses.Validation.BaseClasses.ETS
Dummy ETS model for validation purposes
Information
This is a minimum example of a class extending Buildings.Experimental.DHC.EnergyTransferStations.BaseClasses.PartialETS developed for testing purposes only.
Extends from Buildings.Experimental.DHC.EnergyTransferStations.BaseClasses.PartialETS (Partial class for modeling an energy transfer station).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package MediumSer | Water | Service side medium | |
| replaceable package MediumSerHea_a | Water | Service side medium at heating inlet | |
| replaceable package MediumBui | Water | Building side medium | |
| Generic | fue[nFue] | Fuel type | |
| MassFlowRate | m_flow_nominal | Nominal mass flow rate [kg/s] | |
| Configuration | |||
| DistrictSystemType | typ | TypDisSys.CombinedGeneration... | Type of district system |
| Boolean | have_heaWat | false | Set to true if the ETS supplies heating water |
| Boolean | have_hotWat | false | Set to true if the ETS supplies hot water |
| Boolean | have_chiWat | false | Set to true if the ETS supplies chilled water |
| Boolean | have_fan | false | Set to true if fan power is computed |
| Boolean | have_pum | false | Set to true if pump power is computed |
| Boolean | have_eleHea | false | Set to true if the ETS has electric heating system |
| Integer | nFue | 0 | Number of fuel types (0 means no combustion system) |
| Boolean | have_eleCoo | false | Set to true if the ETS has electric cooling system |
| Boolean | have_weaBus | false | Set to true to use a weather bus |
| Nominal condition | |||
| HeatFlowRate | QHeaWat_flow_nominal | 0 | Nominal capacity of heating system (>=0) [W] |
| HeatFlowRate | QHotWat_flow_nominal | 0 | Nominal capacity of hot water production system (>=0) [W] |
| HeatFlowRate | QChiWat_flow_nominal | 0 | Nominal capacity of cooling system (<=0) [W] |
| Assumptions | |||
| Boolean | allowFlowReversalSer | false | Set to true to allow flow reversal on service side |
| Boolean | allowFlowReversalBui | false | Set to true to allow flow reversal on building side |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPorts_a | ports_aHeaWat[nPorts_aHeaWat] | Fluid connectors for heating water return (from building) |
| FluidPorts_b | ports_bHeaWat[nPorts_bHeaWat] | Fluid connectors for heating water supply (to building) |
| FluidPorts_a | ports_aChiWat[nPorts_aChiWat] | Fluid connectors for chilled water return (from building) |
| FluidPorts_b | ports_bChiWat[nPorts_bChiWat] | Fluid connectors for chilled water supply (to building) |
| FluidPort_a | port_aSerAmb | Fluid connector for ambient water service supply line |
| FluidPort_b | port_bSerAmb | Fluid connector for ambient water service return line |
| FluidPort_a | port_aSerHea | Fluid connector for heating service supply line |
| FluidPort_b | port_bSerHea | Fluid connector for heating service return line |
| FluidPort_a | port_aSerCoo | Fluid connector for cooling service supply line |
| FluidPort_b | port_bSerCoo | Fluid connector for cooling service return line |
| output RealOutput | PHea | Power drawn by heating system [W] |
| output RealOutput | PCoo | Power drawn by cooling system [W] |
| output RealOutput | PFan | Power drawn by fan motors [W] |
| output RealOutput | PPum | Power drawn by pump motors [W] |
| output RealOutput | QFue_flow[nFue] | Fuel energy input rate [W] |
| Bus | weaBus | Weather data bus |
Modelica definition
model ETS
"Dummy ETS model for validation purposes"
extends Buildings.Experimental.DHC.EnergyTransferStations.BaseClasses.PartialETS;
parameter Modelica.SIunits.MassFlowRate m_flow_nominal
"Nominal mass flow rate";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPHea(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPCoo(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPFan(
k=1);
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant souPPum(
k=1);
Fluid.Sources.Boundary_pT sinSerAmbSup(
redeclare final package Medium = MediumSer,
nPorts=1) if typ == DHC.Types.DistrictSystemType.CombinedGeneration5
"Sink for service supply";
Fluid.Sources.MassFlowSource_T souSerAmbRet(
redeclare final package Medium = MediumSer,
m_flow=m_flow_nominal,
nPorts=1) if typ == DHC.Types.DistrictSystemType.CombinedGeneration5
"Source for service return";
Fluid.Sources.Boundary_pT sinSerHeaSup(
redeclare final package Medium = MediumSerHea_a,
nPorts=1) if typ <> DHC.Types.DistrictSystemType.Cooling and
typ <> DHC.Types.DistrictSystemType.CombinedGeneration5
"Sink for service supply";
Fluid.Sources.MassFlowSource_T souSerHeaReat(
redeclare final package Medium = MediumSer,
m_flow=m_flow_nominal,
nPorts=1) if typ <> DHC.Types.DistrictSystemType.Cooling and
typ <> DHC.Types.DistrictSystemType.CombinedGeneration5
"Source for service return";
Fluid.Sources.Boundary_pT sinHeaWat(
redeclare final package Medium =MediumBui,
nPorts=nPorts_aHeaWat) if have_heaWat
"Sink for heating water";
Fluid.Sources.Boundary_pT sinChiWat(
redeclare final package Medium = MediumBui,
nPorts=nPorts_aChiWat) if have_chiWat
"Sink for chilled water";
Fluid.Sources.MassFlowSource_T souHeaWat(
redeclare final package Medium = MediumBui,
m_flow=m_flow_nominal,
nPorts=nPorts_bHeaWat) if have_heaWat
"Source for heating water";
Fluid.Sources.MassFlowSource_T souChiWat(
redeclare final package Medium = MediumBui,
m_flow=m_flow_nominal,
nPorts=nPorts_bChiWat) if have_chiWat
"Source for chilled water";
equation
connect(port_aSerCoo, port_bSerCoo);
connect(souPCoo.y,PCoo);
connect(souPFan.y,PFan);
connect(souPPum.y,PPum);
connect(souPHea.y,PHea);
connect(port_aSerAmb, sinSerAmbSup.ports[1]);
connect(souSerAmbRet.ports[1], port_bSerAmb);
connect(port_aSerHea, sinSerHeaSup.ports[1]);
connect(souSerHeaReat.ports[1], port_bSerHea);
connect(ports_aChiWat, sinChiWat.ports);
connect(ports_aHeaWat, sinHeaWat.ports);
connect(souChiWat.ports, ports_bChiWat);
connect(souHeaWat.ports, ports_bHeaWat);
end ETS;