+This is an implementation of the control sequence specified in ASHRAE (2021) +for multiple-zone VAV air handlers. +It contains the following components. +
+
+The AI point for the measured outdoor air flow rate ctl.VOut_flow
+used for minimum outdoor airflow control is connected to both bus.VOutMin_flow
+(dedicated minimum OA damper) and bus.VOut_flow (single common OA damper).
+Those two variables are exclusive from one another.
+In case of dedicated OA dampers, the total outdoor airflow is not measured,
+hence no bus.VOut_flow signal is available for that configuration.
+
+This is an open loop controller providing control inputs +for the templates within + +Buildings.Templates.AirHandlersFans. +It is mainly used for testing purposes. +
+")); +end OpenLoop; diff --git a/Buildings/Templates/AirHandlersFans/Components/Controls/package.mo b/Buildings/Templates/AirHandlersFans/Components/Controls/package.mo new file mode 100644 index 00000000000..59d0a99a924 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Controls/package.mo @@ -0,0 +1,12 @@ +within Buildings.Templates.AirHandlersFans.Components; +package Controls "Controllers" + extends Modelica.Icons.VariantsPackage; + +annotation (Documentation(info=" ++All control blocks that form the control sequence of a system +are instantiated into one single class, a so-called control section. +This package contains such control sections. +
+")); +end Controls; diff --git a/Buildings/Templates/AirHandlersFans/Components/Controls/package.order b/Buildings/Templates/AirHandlersFans/Components/Controls/package.order new file mode 100644 index 00000000000..d0ddec1fb52 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Controls/package.order @@ -0,0 +1,2 @@ +G36VAVMultiZone +OpenLoop diff --git a/Buildings/Templates/AirHandlersFans/Components/Data/OutdoorReliefReturnSection.mo b/Buildings/Templates/AirHandlersFans/Components/Data/OutdoorReliefReturnSection.mo new file mode 100644 index 00000000000..48a399aa1a3 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Data/OutdoorReliefReturnSection.mo @@ -0,0 +1,69 @@ +within Buildings.Templates.AirHandlersFans.Components.Data; +record OutdoorReliefReturnSection "Record for outdoor/relief/return air section" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.Components.Types.Damper typDamOut + "Outdoor air damper type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Damper typDamOutMin + "Minimum outdoor air damper type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Damper typDamRel + "Relief damper type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Damper typDamRet + "Return damper type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRel + "Type of relief fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRet + "Type of return fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter Modelica.Units.SI.MassFlowRate mOutMin_flow_nominal( + final min=0, + start=0.2 * damOut.m_flow_nominal) + "Minimum outdoor air mass flow rate at design conditions" + annotation (Dialog(group="Dampers and economizers", + enable=typDamOutMin<>Buildings.Templates.Components.Types.Damper.None)); + + parameter Buildings.Templates.Components.Data.Damper damOut( + final typ=typDamOut) + "Outdoor air damper" + annotation (Dialog(group="Dampers and economizers", + enable=typDamOut <> Buildings.Templates.Components.Types.Damper.None)); + parameter Buildings.Templates.Components.Data.Damper damOutMin( + final typ=typDamOutMin) + "Minimum outdoor air damper" + annotation (Dialog(group="Dampers and economizers", + enable=typDamOutMin <> Buildings.Templates.Components.Types.Damper.None)); + parameter Buildings.Templates.Components.Data.Damper damRel( + final typ=typDamRel) + "Relief damper" + annotation (Dialog(group="Dampers and economizers", + enable=typDamRel <> Buildings.Templates.Components.Types.Damper.None)); + parameter Buildings.Templates.Components.Data.Damper damRet( + final typ=typDamRet) + "Return damper" + annotation (Dialog(group="Dampers and economizers", + enable=typDamRet <> Buildings.Templates.Components.Types.Damper.None)); + parameter Buildings.Templates.Components.Data.Fan fanRel( + final typ=typFanRel) + "Relief fan" + annotation (Dialog(group="Fans", + enable=typFanRel <>Buildings.Templates.Components.Types.Fan.None)); + parameter Buildings.Templates.Components.Data.Fan fanRet( + final typ=typFanRet) + "Return fan" + annotation (Dialog(group="Fans", + enable=typFanRet <>Buildings.Templates.Components.Types.Fan.None)); + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +the classes within + +Buildings.Templates.AirHandlersFans.Components.OutdoorReliefReturnSection. +
+")); +end OutdoorReliefReturnSection; diff --git a/Buildings/Templates/AirHandlersFans/Components/Data/PartialController.mo b/Buildings/Templates/AirHandlersFans/Components/Data/PartialController.mo new file mode 100644 index 00000000000..d3fc315f5c7 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Data/PartialController.mo @@ -0,0 +1,25 @@ +within Buildings.Templates.AirHandlersFans.Components.Data; +record PartialController "Record for controller interface class" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.AirHandlersFans.Types.Controller typ + "Type of controller" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanSup + "Type of supply fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRel + "Type of relief fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRet + "Type of return fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for the class + +Buildings.Templates.AirHandlersFans.Components.Controls.Interfaces.PartialController. +
+")); +end PartialController; diff --git a/Buildings/Templates/AirHandlersFans/Components/Data/VAVMultiZoneController.mo b/Buildings/Templates/AirHandlersFans/Components/Data/VAVMultiZoneController.mo new file mode 100644 index 00000000000..e8fd549c1d0 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Data/VAVMultiZoneController.mo @@ -0,0 +1,154 @@ +within Buildings.Templates.AirHandlersFans.Components.Data; +record VAVMultiZoneController "Record for multiple-zone VAV controller" + extends Buildings.Templates.AirHandlersFans.Components.Data.PartialController; + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection typSecOut + "Type of outdoor air section" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes buiPreCon + "Type of building pressure control system" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen + "Ventilation standard" + annotation(Evaluate=true, Dialog(group="Energy and ventilation standards", enable=false)); + + parameter Modelica.Units.SI.Temperature TAirSupSet_min( + final min=273.15, + displayUnit="degC")=12+273.15 + "Lowest supply air temperature setpoint" + annotation (Dialog(group="Temperature setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone)); + + parameter Modelica.Units.SI.Temperature TAirSupSet_max( + final min=273.15, + displayUnit="degC")=18+273.15 + "Highest supply air temperature setpoint" + annotation (Dialog(group="Temperature setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone)); + + parameter Modelica.Units.SI.Temperature TOutRes_min( + final min=273.15, + displayUnit="degC")=16+273.15 + "Lowest value of the outdoor air temperature reset range" + annotation (Dialog(group="Temperature setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone)); + + parameter Modelica.Units.SI.Temperature TOutRes_max( + final min=273.15, + displayUnit="degC")=21+273.15 + "Highest value of the outdoor air temperature reset range" + annotation (Dialog(group="Temperature setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone)); + + parameter Modelica.Units.SI.VolumeFlowRate VOutUnc_flow_nominal( + start=0) + "Uncorrected design outdoor air flow rate, including diversity where applicable" + annotation (Dialog(group="Ventilation setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Modelica.Units.SI.VolumeFlowRate VOutTot_flow_nominal( + start=0) + "Design total outdoor air flow rate" + annotation (Dialog(group="Ventilation setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Modelica.Units.SI.VolumeFlowRate VOutAbsMin_flow_nominal( + start=0) + "Design outdoor air flow rate when all zones with CO2 sensors or occupancy sensors are unpopulated" + annotation (Dialog(group="Ventilation setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + parameter Modelica.Units.SI.VolumeFlowRate VOutMin_flow_nominal( + start=0) + "Design minimum outdoor air flow rate when all zones are occupied at their design population, including diversity" + annotation (Dialog(group="Ventilation setpoints", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + + parameter Modelica.Units.SI.PressureDifference pAirSupSet_rel_max( + final min=0, + displayUnit="Pa", + start=500) + "Duct design maximum static pressure" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone)); + parameter Modelica.Units.SI.PressureDifference dpDamOutMinAbs( + final min=2.4, + displayUnit="Pa", + start=5) + "Differential pressure across the minimum outdoor air damper that provides the absolute minimum outdoor airflow" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24 + and typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure)); + parameter Modelica.Units.SI.PressureDifference dpDamOutMin_nominal( + final min=5, + displayUnit="Pa", + start=15) + "Differential pressure across the minimum outdoor air damper that provides the design minimum outdoor airflow" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + typSecOut==Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure)); + + parameter Modelica.Units.SI.PressureDifference pAirRetSet_rel_min( + final min=2.4, + displayUnit="Pa")=10 + "Return fan minimum discharge static pressure setpoint" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + buiPreCon==Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReturnFanDp)); + + parameter Modelica.Units.SI.PressureDifference pAirRetSet_rel_max( + final min=10, + displayUnit="Pa")=40 + "Return fan maximum discharge static pressure setpoint" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + buiPreCon==Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReturnFanDp)); + + parameter Modelica.Units.SI.VolumeFlowRate dVFanRet_flow( + final min=0, + start=0.1) + "Airflow differential between supply and return fans to maintain building pressure at setpoint" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + buiPreCon==Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReturnFanMeasuredAir)); + + parameter Real yFanSup_min( + final unit="1", + final min=0, + final max=1)= 0.1 + "Lowest allowed fan speed if fan is on" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + typFanSup<>Buildings.Templates.Components.Types.Fan.None)); + + parameter Real yFanRel_min( + final unit="1", + final min=0, + final max=1)=0.1 + "Minimum relief fan speed" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + typFanRel<>Buildings.Templates.Components.Types.Fan.None)); + + parameter Real yFanRet_min( + final unit="1", + final min=0, + final max=1)=0.1 + "Minimum return fan speed" + annotation (Dialog(group="Information provided by testing, adjusting, and balancing contractor", + enable=typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + typFanRet<>Buildings.Templates.Components.Types.Fan.None)); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +multiple-zone VAV controllers within + +Buildings.Templates.AirHandlersFans.Components.Controls. +
+")); +end VAVMultiZoneController; diff --git a/Buildings/Templates/AirHandlersFans/Components/Data/package.mo b/Buildings/Templates/AirHandlersFans/Components/Data/package.mo new file mode 100644 index 00000000000..4a93c2540f6 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Data/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.AirHandlersFans.Components; +package Data "Records for design and operating parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + +annotation (Documentation(info=" ++This package provides records for design and operating parameters. +
+")); +end Data; diff --git a/Buildings/Templates/AirHandlersFans/Components/Data/package.order b/Buildings/Templates/AirHandlersFans/Components/Data/package.order new file mode 100644 index 00000000000..567ce4daa32 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Data/package.order @@ -0,0 +1,3 @@ +OutdoorReliefReturnSection +PartialController +VAVMultiZoneController diff --git a/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/None.mo b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/None.mo new file mode 100644 index 00000000000..0b5ece79689 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/None.mo @@ -0,0 +1,14 @@ +within Buildings.Templates.AirHandlersFans.Components.HeatRecovery; +model None "No heat recovery" + extends + .Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialHeatRecovery( + final typ=Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None); + + annotation (Documentation(info=" ++This model represents a configuration with no heat recovery unit. +It resolves to four fluid ports that are not connected +to each other and for which pressure conditions must be provided. +
+")); +end None; diff --git a/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.mo b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.mo new file mode 100644 index 00000000000..845e18618a6 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.mo @@ -0,0 +1,8 @@ +within Buildings.Templates.AirHandlersFans.Components; +package HeatRecovery "Models for heat recovery" + extends Modelica.Icons.VariantsPackage; + +annotation (Documentation(info=" +This package contains models for heat recovery units. +")); +end HeatRecovery; diff --git a/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.order b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.order new file mode 100644 index 00000000000..b0047fa49f0 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/HeatRecovery/package.order @@ -0,0 +1 @@ +None diff --git a/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialController.mo b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialController.mo new file mode 100644 index 00000000000..397c2c543bc --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialController.mo @@ -0,0 +1,63 @@ +within Buildings.Templates.AirHandlersFans.Components.Interfaces; +partial block PartialController "Interface class for AHU controller" + + parameter Buildings.Templates.AirHandlersFans.Types.Controller typ + "Type of controller" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Integer nZon + "Number of served zones"; + + outer parameter Buildings.Templates.Data.AllSystems datAll + "Top-level (whole building) system parameters"; + outer parameter Buildings.Templates.Components.Types.Fan typFanSup + "Type of supply fan"; + outer parameter Buildings.Templates.Components.Types.Fan typFanRet + "Type of relief/return fan"; + + replaceable parameter + Buildings.Templates.AirHandlersFans.Components.Data.PartialController dat( + final typ=typ, + final typFanSup=typFanSup, + final typFanRet=typFanRet) + "Design and operating parameters" + annotation (Placement(transformation(extent={{190,170},{210,190}}))); + + Buildings.Templates.AirHandlersFans.Interfaces.Bus bus + "AHU control bus" + annotation (Placement(transformation( + extent={{-20,-20},{20,20}}, + rotation=90, + origin={-200,0}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=90, + origin={-100,0}))); + Buildings.Templates.ZoneEquipment.Interfaces.Bus busTer[nZon] + "Terminal unit control bus" + annotation (Placement(transformation( + extent={{-20,20},{20,-20}}, + rotation=90, + origin={220,0}), iconTransformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={100,0}))); + + annotation ( + Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Rectangle( + extent={{-100,-100},{100,100}}, + lineColor={0,0,127}, + fillColor={255,255,255}, + fillPattern=FillPattern.Solid), + Text( + extent={{-151,-114},{149,-154}}, + textColor={0,0,255}, + textString="%name")}), Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-200,-200},{220, + 200}})), + Documentation(info=" ++This partial class provides a standard interface for air handler controllers. +
+")); +end PartialController; diff --git a/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialControllerVAVMultizone.mo b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialControllerVAVMultizone.mo new file mode 100644 index 00000000000..998f231451f --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialControllerVAVMultizone.mo @@ -0,0 +1,111 @@ +within Buildings.Templates.AirHandlersFans.Components.Interfaces; +partial block PartialControllerVAVMultizone + "Interface class for multiple-zone VAV controller" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialController( + redeclare Buildings.Templates.AirHandlersFans.Components.Data.VAVMultiZoneController + dat( + typSecOut=secOutRel.typSecOut, + buiPreCon=buiPreCon, + stdVen=stdVen)); + + outer replaceable + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorReliefReturnSection + secOutRel "Outdoor/relief/return air section"; + outer replaceable Buildings.Templates.Components.Coils.None coiCoo + "Cooling coil"; + outer replaceable Buildings.Templates.Components.Coils.None coiHeaPre + "Heating coil (preheat position)"; + outer replaceable Buildings.Templates.Components.Coils.None coiHeaReh + "Heating coil (reheat position)"; + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer typCtlEco= + Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedDryBulb + "Economizer control type" + annotation (Evaluate=true, + Dialog( + group="Economizer", + enable=secOutRel.have_eco)); + + parameter Buildings.Templates.AirHandlersFans.Types.ControlFanReturn typCtlFanRet= + Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured + "Return fan control type" + annotation (Evaluate=true, + Dialog( + group="Configuration", + enable=typFanRet <> Buildings.Templates.Components.Types.Fan.None)); + + parameter Boolean use_TMix=true + "Set to true if mixed air temperature measurement is enabled" + annotation(Dialog( + group="Economizer", + enable=typ<>Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + secOutRel.typ<>Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir)); + + parameter Boolean have_frePro=true + "Set to true to include freeze protection" + annotation(Evaluate=true); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.FreezeStat typFreSta= + Buildings.Controls.OBC.ASHRAE.G36.Types.FreezeStat.No_freeze_stat + "Option for low limit (freeze) protection" + annotation(Evaluate=true, Dialog(enable=have_frePro)); + + final parameter Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection typSecOut= + secOutRel.typSecOut + "Type of outdoor air section" + annotation (Dialog(group="Economizer")); + + final parameter Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes buiPreCon= + if secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefDamper + then Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReliefDamper + elseif secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefFan + then Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReliefFan + elseif secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReturnFan + then (if typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured + then Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReturnFanMeasuredAir + elseif typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.BuildingPressure + then Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReturnFanDp + else Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReliefDamper) + else Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReliefDamper + "Type of building pressure control system" + annotation (Dialog(group="Economizer")); + + final parameter Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard stdEne= + datAll.stdEne + "Energy standard" + annotation(Dialog(enable= + typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone), + Evaluate=true); + + final parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen= + datAll.stdVen + "Ventilation standard" + annotation(Dialog(enable= + typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone), + Evaluate=true); + + parameter Boolean have_CO2Sen=false + "Set to true if there are zones with CO2 sensor" + annotation (Dialog(group="Configuration", + enable= + typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone and + typSecOut==Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + +initial equation + if typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone then + // We check the fallback "else" clause. + if buiPreCon==Buildings.Controls.OBC.ASHRAE.G36.Types.BuildingPressureControlTypes.ReliefDamper then + assert(secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefDamper, + "In "+ getInstanceName() + ": "+ + "The system configuration is incompatible with available options for building pressure control."); + end if; + end if; + + annotation (Documentation(info=" ++This partial class provides a standard interface for multiple-zone VAV controllers. +
+")); +end PartialControllerVAVMultizone; diff --git a/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialHeatRecovery.mo b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialHeatRecovery.mo new file mode 100644 index 00000000000..cfe5b146e87 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialHeatRecovery.mo @@ -0,0 +1,69 @@ +within Buildings.Templates.AirHandlersFans.Components.Interfaces; +partial model PartialHeatRecovery "Interface class for heat recovery" + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium" + annotation(__ctrl_flow(enable=false)); + + parameter Buildings.Templates.AirHandlersFans.Types.HeatRecovery typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Boolean allowFlowReversal = true + "= false to simplify equations, assuming, but not enforcing, no flow reversal" + annotation(Dialog(tab="Assumptions"), Evaluate=true, __ctrl_flow(enable=false)); + + Buildings.Templates.AirHandlersFans.Interfaces.Bus bus + if typ <> Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None + "Control bus" annotation (Placement(transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,100}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,100}))); + Modelica.Fluid.Interfaces.FluidPort_a port_aOut( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None + "Outdoor air inlet" + annotation (Placement(transformation(extent={{-110,-70},{-90,-50}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bOut( + redeclare final package Medium = MediumAir, + m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None + "Outdoor air outlet" + annotation (Placement(transformation(extent={{110,-70},{90,-50}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_aRel( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None + "Relief/exhaust air inlet" + annotation (Placement(transformation(extent={{90,50},{110,70}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bRel( + redeclare final package Medium = MediumAir, + m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None + "Relief/exhaust air outlet" + annotation (Placement(transformation(extent={{-90,50},{-110,70}}))); + annotation (Icon(graphics={ + Rectangle( + extent={{-100,100},{100,-100}}, + lineColor={0,0,255}, + fillColor={255,255,255}, + fillPattern=FillPattern.Solid), + Text( + extent={{-149,-110},{151,-150}}, + textColor={0,0,255}, + textString="%name")}), Documentation(info=" ++This class provides a standard interface for the +heat recovery unit of an air handler. +
+")); +end PartialHeatRecovery; diff --git a/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialOutdoorReliefReturnSection.mo b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialOutdoorReliefReturnSection.mo new file mode 100644 index 00000000000..b832fd2cdbe --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Interfaces/PartialOutdoorReliefReturnSection.mo @@ -0,0 +1,415 @@ +within Buildings.Templates.AirHandlersFans.Components.Interfaces; +partial model PartialOutdoorReliefReturnSection + "Interface class for outdoor/relief/return air section" + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium" + annotation(__ctrl_flow(enable=false)); + + parameter Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection typ + "Outdoor/relief/return air section type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection typSecOut + "Outdoor air section type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection typSecRel + "Relief/return air section type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Damper typDamOut + "Outdoor air damper type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Damper typDamOutMin + "Minimum outdoor air damper type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Damper typDamRel + "Relief damper type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Damper typDamRet + "Return damper type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Fan typFanRel + "Relief fan type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Fan typFanRet + "Return fan type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Boolean have_eco + "Set to true in case of economizer function" + annotation (Evaluate=true, Dialog(group="Configuration")); + inner parameter Boolean have_recHea = false + "Set to true in case of heat recovery" + annotation (Evaluate=true, + Dialog(group="Configuration")); + inner parameter Buildings.Templates.AirHandlersFans.Types.ControlFanReturn typCtlFanRet= + Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured + "Return fan control type" + annotation (Evaluate=true, + Dialog( + group="Configuration", + enable=typFanRet<>Buildings.Templates.Components.Types.Fan.None)); + inner parameter Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer typCtlEco= + Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedDryBulb + "Economizer control type" + annotation (Evaluate=true, + Dialog( + group="Configuration", + enable=have_eco)); + + parameter + Buildings.Templates.AirHandlersFans.Components.Data.OutdoorReliefReturnSection + dat( + final typDamOut=typDamOut, + final typDamOutMin=typDamOutMin, + final typDamRet=typDamRet, + final typDamRel=typDamRel, + final typFanRel=typFanRel, + final typFanRet=typFanRet) + "Design and operating parameters" + annotation (Placement(transformation(extent={{150,110},{170,130}}))); + + final parameter Modelica.Units.SI.MassFlowRate mAirSup_flow_nominal= + dat.damOut.m_flow_nominal + "Supply air mass flow rate"; + final parameter Modelica.Units.SI.MassFlowRate mAirRet_flow_nominal= + dat.damRet.m_flow_nominal + "Return air mass flow rate"; + final parameter Modelica.Units.SI.MassFlowRate mOutMin_flow_nominal= + dat.mOutMin_flow_nominal + "Minimum outdoor air mass flow rate at design conditions"; + + final parameter Modelica.Units.SI.PressureDifference dpDamOut_nominal= + dat.damOut.dp_nominal + "Outdoor air damper pressure drop"; + final parameter Modelica.Units.SI.PressureDifference dpDamOutMin_nominal= + dat.damOutMin.dp_nominal + "Minimum outdoor air damper pressure drop"; + final parameter Modelica.Units.SI.PressureDifference dpDamRel_nominal= + dat.damRel.dp_nominal + "Relief air damper pressure drop"; + final parameter Modelica.Units.SI.PressureDifference dpDamRet_nominal= + dat.damRet.dp_nominal + "Return air damper pressure drop"; + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations"), + __ctrl_flow(enable=false)); + + parameter Boolean allowFlowReversal = true + "= false to simplify equations, assuming, but not enforcing, no flow reversal" + annotation(Dialog(tab="Assumptions"), Evaluate=true, __ctrl_flow(enable=false)); + + Modelica.Fluid.Interfaces.FluidPort_b port_Rel( + redeclare final package Medium = MediumAir, + m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.MixedAirNoRelief + "Relief (exhaust) air" + annotation (Placement(transformation( + extent={{-190,70},{-170,90}}),iconTransformation(extent={{-810,590},{-790, + 610}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_Out( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + "Outdoor air intake" + annotation (Placement(transformation( + extent={{-190,-90},{-170,-70}}),iconTransformation(extent={{-810,-610},{-790, + -590}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_Sup( + redeclare final package Medium = MediumAir, + m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + "Supply air" + annotation ( + Placement(transformation(extent={{170,-90},{190,-70}}), + iconTransformation(extent={{790,-610},{810,-590}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_Ret( + redeclare final package Medium =MediumAir, + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + "Return air" + annotation (Placement(transformation(extent={{170,70},{190,90}}), + iconTransformation(extent={{790,588},{810,608}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bPre( + redeclare final package Medium = MediumAir) + "Optional fluid connector for differential pressure sensor" + annotation (Placement(transformation(extent={{90,130},{70,150}}), + iconTransformation(extent={{390,790},{370,810}}))); + Buildings.Templates.AirHandlersFans.Interfaces.Bus bus "Control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,140}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,800}))); + + annotation (Icon(coordinateSystem(preserveAspectRatio=false, + extent={{-800,-800}, {800,800}}), + graphics={ + Line( + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None, + points={{440,440},{440,576}}, + color={0,0,0}), + Line( + visible=typFanRel <> Buildings.Templates.Components.Types.Fan.None, + points={{-240,440},{-240,570}}, + color={0,0,0}), + Text( + extent={{-149,-834},{151,-874}}, + textColor={0,0,255}, + textString="%name"), + Bitmap( + visible=typFanRet==Buildings.Templates.Components.Types.Fan.SingleVariable, + extent={{540,500},{340,700}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Housed.svg"), + Bitmap( + visible=typFanRet==Buildings.Templates.Components.Types.Fan.ArrayVariable, + extent={{540,500},{340,700}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Array.svg"), + Bitmap( + visible=typFanRet<>Buildings.Templates.Components.Types.Fan.None, + extent={{358,280},{520,440}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/VFD.svg"), + Bitmap( + visible=typDamRel==Buildings.Templates.Components.Types.Damper.TwoPosition, + extent={{-680,360},{-600,440}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/TwoPosition.svg"), + Bitmap( + visible=typDamRel==Buildings.Templates.Components.Types.Damper.Modulating, + extent={{-680,360},{-600,440}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + extent={{-510,440},{-770,700}}, + visible=typDamRel<>Buildings.Templates.Components.Types.Damper.None, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesOpposed.svg"), + Bitmap( + visible=typFanRel==Buildings.Templates.Components.Types.Fan.SingleVariable, + extent={{-140,500},{-340,700}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Propeller.svg"), + Bitmap( + visible=typFanRel==Buildings.Templates.Components.Types.Fan.ArrayVariable, + extent={{-140,500},{-340,700}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Array.svg"), + Bitmap( + visible=typFanRel<>Buildings.Templates.Components.Types.Fan.None, + extent={{-320,278},{-158,440}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/VFD.svg"), + Bitmap( + visible=typ<>Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir, + extent={{-240,-40},{-160,40}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + extent={{-160,-130},{100,130}}, + visible=typ<>Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesParallel.svg", + origin={-30,-30}, + rotation=-90), + Bitmap( + extent={{-770,-760},{-510,-500}}, + visible=typDamOut<>Buildings.Templates.Components.Types.Damper.None, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesParallel.svg"), + Bitmap( + visible=typDamOut==Buildings.Templates.Components.Types.Damper.TwoPosition, + extent={{-680,-840},{-600,-760}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/TwoPosition.svg"), + Bitmap( + visible=typDamOut==Buildings.Templates.Components.Types.Damper.Modulating, + extent={{-680,-840},{-600,-760}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + extent={{-510,-240},{-770,-500}}, + visible=typDamOutMin<>Buildings.Templates.Components.Types.Damper.None, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesParallel.svg"), + Bitmap( + visible=typDamOutMin==Buildings.Templates.Components.Types.Damper.TwoPosition, + extent={{-680,-240},{-600,-160}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/TwoPosition.svg"), + Bitmap( + visible=typDamOutMin==Buildings.Templates.Components.Types.Damper.Modulating, + extent={{-680,-240},{-600,-160}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Line(points={{-100,700},{800,700}}, color={0,0,0}), + Line( + visible=typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.MixedAirNoRelief, + points={{-800,500},{-100,500}}, + color={0,0,0}), + Line( + visible=typ==Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.MixedAirNoRelief, + points={{-100,700},{-100,500}}, + color={0,0,0}), + Line(points={{96,500},{796,500}}, color={0,0,0}), + Line(points={{100,-500},{800,-500}},color={0,0,0}), + Line(points={{-800,-500},{-100,-500}},color={0,0,0}), + Line(points={{-800,-700},{800,-700}}, color={0,0,0}), + Line( + visible=typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir, + points={{100,500},{100,-500}}, + color={0,0,0}), + Line( + visible=typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir, + points={{-100,500},{-100,-300}}, + color={0,0,0}), + Line( + points={{-800,700},{-100,700}}, + color={0,0,0}, + visible=typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.MixedAirNoRelief), + Line( + points={{-100,500},{100,500}}, + color={0,0,0}, + visible=typ == Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir), + Line( + points={{-100,-500},{100,-500}}, + color={0,0,0}, + visible=typ == Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir), + Line( + points={{-800,-300},{-100,-300}}, + color={0,0,0}, + visible=typDamOutMin <> Buildings.Templates.Components.Types.Damper.None), + Line( + points={{-100,-300},{-100,-500}}, + color={0,0,0}, + visible=typDamOutMin == Buildings.Templates.Components.Types.Damper.None and + typ <> Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.HundredPctOutdoorAir), + Bitmap( + visible=typSecOut==Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure, + extent={{-680,-142},{-600,-62}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/DifferentialPressure.svg"), + Bitmap( + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersAirflow, + extent={{-260,-500},{-60,-300}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRateAFMS.svg"), + Bitmap( + visible=typSecOut==Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersAirflow, + extent={{-200,-240},{-120,-160}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRate.svg"), + Bitmap( + visible=typFanRet<>Buildings.Templates.Components.Types.Fan.None and + typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured, + extent={{580,360},{660,440}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRate.svg"), + Line(points={{664,446}}, color={28,108,200}), + Bitmap( + visible=typDamOutMin<>Buildings.Templates.Components.Types.Damper.None, + extent={{-338,-240},{-258,-160}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/Temperature.svg"), + Bitmap( + visible=typDamOutMin <> Buildings.Templates.Components.Types.Damper.None, + extent={{-400,-240},{-200,-440}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/ProbeStandard.svg"), + Bitmap( + visible=typDamOutMin<>Buildings.Templates.Components.Types.Damper.None and + (typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb or + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb), + extent={{-460,-160},{-380,-240}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/SpecificEnthalpy.svg"), + Bitmap( + visible=typDamOutMin <> Buildings.Templates.Components.Types.Damper.None + and (typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb + or typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb), + extent={{-520,-240},{-320,-440}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/ProbeStandard.svg"), + Bitmap( + visible=typDamOutMin==Buildings.Templates.Components.Types.Damper.None, + extent={{-340,-840},{-260,-760}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/Temperature.svg"), + Bitmap( + visible=typDamOutMin == Buildings.Templates.Components.Types.Damper.None, + extent={{-400,-760},{-200,-560}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/ProbeStandard.svg"), + Bitmap( + visible=typDamOutMin==Buildings.Templates.Components.Types.Damper.None and + (typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb or + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb), + extent={{-460,-840},{-380,-760}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/SpecificEnthalpy.svg"), + Bitmap( + visible=typDamOutMin == Buildings.Templates.Components.Types.Damper.None + and (typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb + or typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb), + extent={{-520,-760},{-320,-560}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/ProbeStandard.svg"), + Bitmap( + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.SingleDamper, + extent={{-260,-700},{-60,-500}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRateAFMS.svg"), + Bitmap( + visible=typSecOut==Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.SingleDamper, + extent={{-200,-840},{-120,-760}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRate.svg"), + Bitmap( + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + and typCtlFanRet == Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.BuildingPressure, + extent={{260,760},{340,840}}, + fileName= + "modelica://Buildings/Resources/Images/Templates/Components/Sensors/DifferentialPressure.svg"), + Line( + points={{-160,-700},{-160,-760}}, + color={0,0,0}, + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.SingleDamper), + Line( + points={{-160,-238},{-160,-300}}, + color={0,0,0}, + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersAirflow), + Polygon( + points={{260,805},{220,805},{220,660},{230,660},{230,795},{260,795},{ + 260,805}}, + lineColor={0,0,0}, + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + and typCtlFanRet == Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.BuildingPressure), + Polygon( + points={{492,605},{625,605},{625,440},{615,440},{615,595},{492,595},{ + 492,605}}, + lineColor={0,0,0}, + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + and typCtlFanRet == Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured), + Rectangle( + extent={{340,805},{380,795}}, + lineColor={0,0,0}, + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + and typCtlFanRet == Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.BuildingPressure), + Polygon( + points={{-680,-95},{-725,-95},{-725,-340},{-715,-340},{-715,-105},{-680, + -105},{-680,-95}}, + lineColor={0,0,0}, + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure), + Polygon( + points={{-600,-95},{-555,-95},{-555,-340},{-565,-340},{-565,-105},{-600, + -105},{-600,-95}}, + lineColor={0,0,0}, + visible=typSecOut == Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure)}), + Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-180,-140},{180,140}})), + Documentation(info=" ++This class provides a standard interface for the outdoor/relief/return +air section of an air handler. +Typical components in that section include +
++This class provides a standard interface for the outdoor +air section of an air handler. +Typical components in that section include +
++This class provides a standard interface for the relief/return +air section of an air handler. +Typical components in that section include +
++This package contains interface classes. +
+")); +end Interfaces; diff --git a/Buildings/Templates/AirHandlersFans/Components/Interfaces/package.order b/Buildings/Templates/AirHandlersFans/Components/Interfaces/package.order new file mode 100644 index 00000000000..cd9ee37903c --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/Interfaces/package.order @@ -0,0 +1,6 @@ +PartialController +PartialControllerVAVMultizone +PartialHeatRecovery +PartialOutdoorReliefReturnSection +PartialOutdoorSection +PartialReliefReturnSection diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/MixedAirWithDamper.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/MixedAirWithDamper.mo new file mode 100644 index 00000000000..37f58c08f48 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/MixedAirWithDamper.mo @@ -0,0 +1,118 @@ +within Buildings.Templates.AirHandlersFans.Components.OutdoorReliefReturnSection; +model MixedAirWithDamper "Mixed air system with return air damper" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.OutdoorReliefReturnSection.MixedAirWithDamper, + final typSecOut=secOut.typ, + final typSecRel=secRel.typ, + final typDamOut=secOut.typDamOut, + final typDamOutMin=secOut.typDamOutMin, + final typDamRel=secRel.typDamRel, + final typDamRet=damRet.typ, + final typFanRel=secRel.typFanRel, + final typFanRet=secRel.typFanRet, + final have_eco=true, + final have_recHea=recHea.typ<>Buildings.Templates.AirHandlersFans.Types.HeatRecovery.None); + + replaceable + Buildings.Templates.AirHandlersFans.Components.OutdoorSection.SingleDamper + secOut constrainedby + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorSection( + redeclare final package MediumAir = MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final dat=dat) + "Outdoor air section" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.AirHandlersFans.Components.OutdoorSection.SingleDamper secOut + "Single damper for ventilation and economizer, with airflow measurement station"), + choice(redeclare replaceable Buildings.Templates.AirHandlersFans.Components.OutdoorSection.DedicatedDampersAirflow secOut + "Separate dampers for ventilation and economizer, with airflow measurement station"), + choice(redeclare replaceable Buildings.Templates.AirHandlersFans.Components.OutdoorSection.DedicatedDampersPressure secOut + "Separate dampers for ventilation and economizer, with differential pressure sensor")), + Dialog(group="Configuration"), + Placement(transformation(extent={{-58,-94},{-22,-66}}))); + + replaceable + Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReturnFan + secRel constrainedby + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + redeclare final package MediumAir = MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final dat=dat) + "Relief/return air section" + annotation ( + choices( + choice( + redeclare Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReturnFan secRel + "Return fan with modulating relief damper"), + choice( + redeclare Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReliefFan + secRel + "Relief fan with two-position relief damper"), + choice( + redeclare Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReliefDamper + secRel + "Modulating relief damper without fan")), + Dialog(group="Configuration"), + Placement(transformation(extent={{-18,66},{18,94}}))); + + Buildings.Templates.Components.Dampers.Modulating damRet( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damRet, + final text_rotation=90) + "Return damper" + annotation (Placement( + transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,0}))); + + // Currently only the configuration without heat recovery is supported. + replaceable Buildings.Templates.AirHandlersFans.Components.HeatRecovery.None recHea + constrainedby + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialHeatRecovery( + redeclare final package MediumAir = MediumAir, + final allowFlowReversal=allowFlowReversal) + "Heat recovery" + annotation (Placement(transformation(extent={{-90,-10},{-70,10}}))); + +equation + /* Control point connection - start */ + connect(damRet.bus, bus.damRet); + connect(bus, secRel.bus); + connect(secOut.bus, bus); + connect(recHea.bus, bus); + /* Control point connection - end */ + connect(port_Rel, secRel.port_b) + annotation (Line(points={{-180,80},{-18,80}}, color={0,127,255})); + connect(secRel.port_a, port_Ret) + annotation (Line(points={{18,80},{180,80}}, color={0,127,255})); + connect(secRel.port_bRet, damRet.port_a) + annotation (Line(points={{0,66},{0,10}}, color={0,127,255})); + connect(port_Out, secOut.port_a) + annotation (Line(points={{-180,-80},{-58,-80}}, color={0,127,255})); + connect(secOut.port_b, port_Sup) + annotation (Line(points={{-22,-80},{180,-80}}, color={0,127,255})); + connect(damRet.port_b, port_Sup) + annotation (Line(points={{0,-10},{0,-80},{180,-80}}, color={0,127,255})); + connect(secRel.port_bPre, port_bPre) annotation (Line(points={{8,66},{8,60},{80, + 60},{80,140}}, color={0,127,255})); + connect(recHea.port_aRel, secRel.port_bHeaRec) annotation (Line(points={{-70,6}, + {-60,6},{-60,56},{-4,56},{-4,66}}, color={0,127,255})); + connect(secRel.port_aHeaRec, recHea.port_bRel) annotation (Line(points={{-8,66}, + {-8,60},{-100,60},{-100,6},{-90,6}}, color={0,127,255})); + connect(recHea.port_aOut, secOut.port_bHeaRec) annotation (Line(points={{-90,-6}, + {-100,-6},{-100,-60},{-48,-60},{-48,-66}}, color={0,127,255})); + connect(recHea.port_bOut, secOut.port_aHeaRec) annotation (Line(points={{-70,-6}, + {-60,-6},{-60,-56},{-44,-56},{-44,-66}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer. +
+")); +end MixedAirWithDamper; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.mo new file mode 100644 index 00000000000..39c3f35acb6 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.mo @@ -0,0 +1,20 @@ +within Buildings.Templates.AirHandlersFans.Components; +package OutdoorReliefReturnSection "Models for outdoor/relief/return air section" + extends Modelica.Icons.VariantsPackage; + + + + +annotation (Documentation(info=" ++Components inside that package represent the outdoor/relief/return air section of an +air handler. +They are composed of + +Buildings.Templates.AirHandlersFans.Components.OutdoorSection +and + +Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection. +
+")); +end OutdoorReliefReturnSection; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.order b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.order new file mode 100644 index 00000000000..4409476a142 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorReliefReturnSection/package.order @@ -0,0 +1 @@ +MixedAirWithDamper diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersAirflow.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersAirflow.mo new file mode 100644 index 00000000000..99d22dad14e --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersAirflow.mo @@ -0,0 +1,96 @@ +within Buildings.Templates.AirHandlersFans.Components.OutdoorSection; +model DedicatedDampersAirflow + "Separate dampers for ventilation and economizer, with airflow measurement station" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorSection( + final typ=Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersAirflow, + final typDamOut=damOut.typ, + final typDamOutMin=damOutMin.typ); + + Buildings.Templates.Components.Dampers.Modulating damOut( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damOut) + "Economizer outdoor air damper" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,0}))); + Buildings.Templates.Components.Dampers.Modulating damOutMin( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damOutMin) + "Minimum outdoor air damper" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,60}))); + + Buildings.Templates.Components.Sensors.Temperature TOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=true, + final m_flow_nominal=mOutMin_flow_nominal) + "Outdoor air temperature sensor" + annotation (Placement(transformation(extent={{70,50},{90,70}}))); + Buildings.Templates.Components.Sensors.VolumeFlowRate VOutMin_flow( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=true, + final m_flow_nominal=mOutMin_flow_nominal, + final typ=Buildings.Templates.Components.Types.SensorVolumeFlowRate.AFMS) + "Minimum outdoor air volume flow rate sensor" + annotation (Placement(transformation(extent={{110,50},{130,70}}))); + Buildings.Templates.Components.Sensors.SpecificEnthalpy hAirOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen= + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb or + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb, + final m_flow_nominal=mOutMin_flow_nominal) + "Outdoor air enthalpy sensor" + annotation (Placement(transformation(extent={{30,50},{50,70}}))); +equation + /* Control point connection - start */ + connect(damOut.bus, bus.damOut); + connect(damOutMin.bus, bus.damOutMin); + connect(TOut.y, bus.TOut); + connect(hAirOut.y, bus.hAirOut); + connect(VOutMin_flow.y, bus.VOutMin_flow); + /* Control point connection - end */ + connect(damOut.port_b, port_b) + annotation (Line(points={{10,0},{180,0}}, color={0,127,255})); + connect(TOut.port_b, VOutMin_flow.port_a) + annotation (Line(points={{90,60},{110,60}},color={0,127,255})); + connect(VOutMin_flow.port_b, port_b) annotation (Line(points={{130,60},{160, + 60},{160,0},{180,0}}, + color={0,127,255})); + connect(damOutMin.port_b, hAirOut.port_a) + annotation (Line(points={{10,60},{30,60}}, color={0,127,255})); + connect(hAirOut.port_b, TOut.port_a) + annotation (Line(points={{50,60},{70,60}}, color={0,127,255})); + connect(port_a, damOut.port_a) + annotation (Line(points={{-180,0},{-10,0}}, color={0,127,255})); + connect(damOutMin.port_a, damOut.port_a) annotation (Line(points={{-10,60},{ + -20,60},{-20,0},{-10,0}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer and +minimum OA control with a separate minimum OA damper and airflow measurement. +
+"), Icon(graphics={ + Line( + points={{0,140},{0,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{-180,60},{0,60}}, + color={28,108,200}, + thickness=1)})); +end DedicatedDampersAirflow; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersPressure.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersPressure.mo new file mode 100644 index 00000000000..997a78c66e5 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/DedicatedDampersPressure.mo @@ -0,0 +1,98 @@ +within Buildings.Templates.AirHandlersFans.Components.OutdoorSection; +model DedicatedDampersPressure + "Separate dampers for ventilation and economizer, with differential pressure sensor" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorSection( + final typ=Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.DedicatedDampersPressure, + final typDamOut=damOut.typ, + final typDamOutMin=damOutMin.typ); + + Buildings.Templates.Components.Dampers.Modulating damOut( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damOut) + "Economizer outdoor air damper" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,0}))); + Buildings.Templates.Components.Dampers.TwoPosition damOutMin( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damOutMin) + "Minimum outdoor air damper" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,60}))); + + Buildings.Templates.Components.Sensors.Temperature TOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=true, + final m_flow_nominal=mOutMin_flow_nominal) + "Outdoor air temperature sensor" + annotation (Placement(transformation(extent={{70,50},{90,70}}))); + Buildings.Templates.Components.Sensors.DifferentialPressure dpAirOutMin( + redeclare final package Medium = MediumAir, + final have_sen=true) + "Minimum outdoor air damper differential pressure sensor" + annotation (Placement(transformation(extent={{-10,90},{10,110}}))); + Buildings.Templates.Components.Sensors.SpecificEnthalpy hAirOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen= + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb or + typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb, + final m_flow_nominal=mOutMin_flow_nominal) + "Outdoor air enthalpy sensor" + annotation (Placement(transformation(extent={{30,50},{50,70}}))); +equation + /* Control point connection - start */ + connect(damOut.bus, bus.damOut); + connect(damOutMin.bus, bus.damOutMin); + connect(TOut.y, bus.TOut); + connect(hAirOut.y, bus.hAirOut); + connect(dpAirOutMin.y, bus.dpAirOutMin); + /* Control point connection - end */ + connect(TOut.port_b, port_b) annotation (Line(points={{90,60},{160,60},{160,0}, + {180,0}}, color={0,127,255})); + connect(damOut.port_b, port_b) + annotation (Line(points={{10,0},{180,0}}, color={0,127,255})); + + connect(damOutMin.port_a, dpAirOutMin.port_a) annotation (Line(points={{-10,60}, + {-20,60},{-20,100},{-10,100}}, + color={0,127,255})); + connect(damOutMin.port_b, dpAirOutMin.port_b) annotation (Line(points={{10,60},{ + 20,60},{20,100},{10,100}}, + color={0,127,255})); + connect(damOutMin.port_b, hAirOut.port_a) + annotation (Line(points={{10,60},{30,60}}, color={0,127,255})); + connect(hAirOut.port_b, TOut.port_a) + annotation (Line(points={{50,60},{70,60}}, color={0,127,255})); + connect(port_a, damOut.port_a) + annotation (Line(points={{-180,0},{-10,0}}, color={0,127,255})); + connect(damOut.port_a, damOutMin.port_a) annotation (Line(points={{-10,0},{ + -20,0},{-20,60},{-10,60}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer and +minimum OA control with a separate minimum OA damper and differential +pressure control. +
+"), Icon(graphics={ + Line( + points={{0,140},{0,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{-180,60},{0,60}}, + color={28,108,200}, + thickness=1)})); +end DedicatedDampersPressure; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/SingleDamper.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/SingleDamper.mo new file mode 100644 index 00000000000..655ae764472 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/SingleDamper.mo @@ -0,0 +1,78 @@ +within Buildings.Templates.AirHandlersFans.Components.OutdoorSection; +model SingleDamper + "Single damper for ventilation and economizer, with airflow measurement station" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorSection( + final typ=Buildings.Controls.OBC.ASHRAE.G36.Types.OutdoorAirSection.SingleDamper, + final typDamOut=damOut.typ, + final typDamOutMin=Buildings.Templates.Components.Types.Damper.None); + + Buildings.Templates.Components.Dampers.Modulating damOut( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damOut) + "Outdoor air damper" + annotation ( + Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,0}))); + + Buildings.Templates.Components.Sensors.VolumeFlowRate VOut_flow( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=true, + final m_flow_nominal=m_flow_nominal, + final typ=Buildings.Templates.Components.Types.SensorVolumeFlowRate.AFMS) + "Outdoor air volume flow rate sensor" + annotation (Placement(transformation(extent={{80,-10},{100,10}}))); + Buildings.Templates.Components.Sensors.Temperature TOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=true, + final m_flow_nominal=m_flow_nominal) + "Outdoor air temperature sensor" + annotation (Placement(transformation(extent={{50,-10},{70,10}}))); + Buildings.Templates.Components.Sensors.SpecificEnthalpy hAirOut( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversal, + final have_sen=typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedEnthalpyWithFixedDryBulb + or typCtlEco == Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb, + final m_flow_nominal=m_flow_nominal) "Outdoor air enthalpy sensor" + annotation (Placement(transformation(extent={{20,-10},{40,10}}))); + +equation + /* Control point connection - start */ + connect(damOut.bus, bus.damOut); + connect(TOut.y, bus.TOut); + connect(hAirOut.y, bus.hAirOut); + connect(VOut_flow.y, bus.VOut_flow); + /* Control point connection - end */ + connect(TOut.port_b, VOut_flow.port_a) + annotation (Line(points={{70,0},{80,0}}, color={0,127,255})); + connect(VOut_flow.port_b, port_b) + annotation (Line(points={{100,0},{180,0}}, color={0,127,255})); + + connect(damOut.port_b, hAirOut.port_a) + annotation (Line(points={{10,0},{20,0}}, color={0,127,255})); + connect(hAirOut.port_b, TOut.port_a) + annotation (Line(points={{40,0},{50,0}}, color={0,127,255})); + connect(port_a, damOut.port_a) + annotation (Line(points={{-180,0},{-10,0}}, color={0,127,255})); + annotation (Icon(graphics={ + Line( + points={{0,140},{0,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1)}), Documentation(info=" ++This model represents a configuration with an air economizer +and minimum OA control with a single common damper +and airflow measurement +
+")); +end SingleDamper; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.mo b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.mo new file mode 100644 index 00000000000..f221f60f42b --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.mo @@ -0,0 +1,15 @@ +within Buildings.Templates.AirHandlersFans.Components; +package OutdoorSection "Models for outdoor air section" + extends Modelica.Icons.VariantsPackage; + + + + + +annotation (Documentation(info=" ++Components inside that package represent the outdoor air section of an +air handler. +
+")); +end OutdoorSection; diff --git a/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.order b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.order new file mode 100644 index 00000000000..ea94a32dbac --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/OutdoorSection/package.order @@ -0,0 +1,3 @@ +DedicatedDampersAirflow +DedicatedDampersPressure +SingleDamper diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoRelief.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoRelief.mo new file mode 100644 index 00000000000..d2418b8a804 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoRelief.mo @@ -0,0 +1,54 @@ +within Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection; +model NoRelief "No relief branch" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.NoRelief, + final typDamRel=Buildings.Templates.Components.Types.Damper.None, + final typFanRel=Buildings.Templates.Components.Types.Fan.None, + final typFanRet=fanRet.typ); + + replaceable Buildings.Templates.Components.Fans.None fanRet + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final dat=dat.fanRet, + final have_senFlo= + typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured, + final text_flip=true) + "Return fan" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Fans.None fanRet + "No fan"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.SingleVariable fanRet + "Single fan - Variable speed"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.ArrayVariable fanRet + "Fan array - Variable speed")), + Dialog(group="Exhaust/relief/return section"), + Placement(transformation(extent={{70,-10},{50,10}}))); + +equation + /* Control point connection - start */ + connect(fanRet.bus, bus.fanRet); + /* Control point connection - end */ + connect(fanRet.port_b, splEco.port_1) + annotation (Line(points={{50,0},{10,0}}, color={0,127,255})); + connect(fanRet.port_a, port_a) + annotation (Line(points={{70,0},{180,0}}, color={0,127,255})); + annotation (Icon(graphics={ + Line( + points={{0,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{0,0},{0,-140}}, + color={28,108,200}, + thickness=1)}), Documentation(info=" ++This model represents a configuration with an air economizer +and no relief branch. +The return fan is optional. +
+")); +end NoRelief; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoReturn.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoReturn.mo new file mode 100644 index 00000000000..758bf00210f --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/NoReturn.mo @@ -0,0 +1,62 @@ +within Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection; +model NoReturn "No return branch" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.NoReturn, + final typDamRel=damRel.typ, + final typFanRel=Buildings.Templates.Components.Types.Fan.None, + final typFanRet=fanRet.typ); + + Buildings.Templates.Components.Dampers.TwoPosition damRel( + redeclare final package Medium = MediumAir, + final dat=dat.damRel, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final text_flip=true) + "Relief damper" + annotation (Placement(transformation( + extent={{10,-10},{-10,10}}, + rotation=0, + origin={-150,0}))); + replaceable Buildings.Templates.Components.Fans.SingleVariable fanRet + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final dat=dat.fanRet, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final have_senFlo= + typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured, + final text_flip=true) + "Return fan" + annotation (choices(choice(redeclare replaceable + Buildings.Templates.Components.Fans.SingleVariable fanRet + "Single fan - Variable speed"), choice(redeclare replaceable + Buildings.Templates.Components.Fans.ArrayVariable fanRet + "Fan array - Variable speed")), + Placement( + transformation(extent={{70,-10},{50,10}}))); + +equation + /* Control point connection - start */ + connect(fanRet.bus, bus.fanRet); + connect(damRel.bus, bus.damRel); + /* Control point connection - end */ + connect(port_b, damRel.port_b) + annotation (Line(points={{-180,0},{-160,0}}, color={0,127,255})); + connect(damRel.port_a, splEco.port_2) + annotation (Line(points={{-140,0},{-10,0}}, color={0,127,255})); + connect(splEco.port_1, fanRet.port_b) + annotation (Line(points={{10,0},{50,0}}, color={0,127,255})); + connect(fanRet.port_a, port_a) + annotation (Line(points={{70,0},{180,0}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with no air economizer +for 100% outdoor air applications (such as DOAS). +
+"), Icon(graphics={ + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1)})); +end NoReturn; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefDamper.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefDamper.mo new file mode 100644 index 00000000000..d58972dd50d --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefDamper.mo @@ -0,0 +1,45 @@ +within Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection; +model ReliefDamper "Modulating relief damper without fan" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefDamper, + final typDamRel=damRel.typ, + final typFanRel=Buildings.Templates.Components.Types.Fan.None, + final typFanRet=Buildings.Templates.Components.Types.Fan.None); + + Buildings.Templates.Components.Dampers.Modulating damRel( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damRel, + final text_flip=true, + typBla=Buildings.Templates.Components.Types.DamperBlades.Opposed) + "Relief damper" annotation (Placement(transformation( + extent={{10,-10},{-10,10}}, + rotation=0, + origin={-150,0}))); +equation + /* Control point connection - start */ + connect(damRel.bus, bus.damRel); + /* Control point connection - end */ + connect(port_b, damRel.port_b) + annotation (Line(points={{-180,0},{-160,0}}, color={0,127,255})); + connect(damRel.port_a, splEco.port_2) + annotation (Line(points={{-140,0},{-10,0}}, color={0,127,255})); + connect(splEco.port_1, port_a) + annotation (Line(points={{10,0},{180,0}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer +and an actuated relief damper (modulating) without fan. +
+"), Icon(graphics={ + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{0,0},{0,-140}}, + color={28,108,200}, + thickness=1)})); +end ReliefDamper; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefFan.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefFan.mo new file mode 100644 index 00000000000..db8259aa454 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReliefFan.mo @@ -0,0 +1,64 @@ +within Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection; +model ReliefFan "Relief fan with two-position relief damper" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefFan, + final typDamRel=damRel.typ, + final typFanRel=fanRel.typ, + final typFanRet=Buildings.Templates.Components.Types.Fan.None); + + Buildings.Templates.Components.Dampers.TwoPosition damRel( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final dat=dat.damRel, + final text_flip=true) + "Relief damper" + annotation (Placement(transformation( + extent={{10,-10},{-10,10}}, + rotation=0, + origin={-150,0}))); + replaceable Buildings.Templates.Components.Fans.SingleVariable fanRel + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final dat=dat.fanRel, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final have_senFlo=false, + final text_flip=true, + typSin=Buildings.Templates.Components.Types.FanSingle.Propeller) + "Relief fan" + annotation (choices( + choice(redeclare replaceable Buildings.Templates.Components.Fans.SingleVariable fanRet + "Single fan - Variable speed"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.ArrayVariable fanRet + "Fan array - Variable speed")), Placement( + transformation(extent={{-100,-10},{-120,10}}))); +equation + /* Control point connection - start */ + connect(fanRel.bus, bus.fanRel); + connect(damRel.bus, bus.damRel); + /* Control point connection - end */ + connect(port_b, damRel.port_b) + annotation (Line(points={{-180,0},{-160,0}}, color={0,127,255})); + connect(damRel.port_a, fanRel.port_b) + annotation (Line(points={{-140,0},{-120,0}}, color={0,127,255})); + connect(fanRel.port_a, splEco.port_2) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(splEco.port_1, port_a) + annotation (Line(points={{10,0},{180,0}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer +and a relief fan with an actuated relief damper (two-position). +
+"), Icon(graphics={ + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{0,0},{0,-140}}, + color={28,108,200}, + thickness=1)})); +end ReliefFan; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReturnFan.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReturnFan.mo new file mode 100644 index 00000000000..b5fd39c4616 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/ReturnFan.mo @@ -0,0 +1,65 @@ +within Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection; +model ReturnFan "Return fan with modulating relief damper" + extends + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection( + final typ=Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReturnFan, + final typDamRel=damRel.typ, + final typFanRel=Buildings.Templates.Components.Types.Fan.None, + final typFanRet=fanRet.typ); + + Buildings.Templates.Components.Dampers.Modulating damRel( + redeclare final package Medium = MediumAir, + final dat=dat.damRel, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal, + final text_flip=true) + "Relief damper" + annotation (Placement(transformation( + extent={{10,-10},{-10,10}}, + rotation=0, + origin={-150,0}))); + replaceable Buildings.Templates.Components.Fans.SingleVariable fanRet + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final dat=dat.fanRet, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final have_senFlo= + typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured, + final text_flip=true) + "Return fan" + annotation (choices(choice(redeclare replaceable + Buildings.Templates.Components.Fans.SingleVariable fanRet + "Single fan - Variable speed"), choice(redeclare replaceable + Buildings.Templates.Components.Fans.ArrayVariable fanRet + "Fan array - Variable speed")), + Placement(transformation(extent={{70,-10},{50,10}}))); + +equation + /* Control point connection - start */ + connect(fanRet.bus, bus.fanRet); + connect(damRel.bus, bus.damRel); + /* Control point connection - end */ + connect(port_b, damRel.port_b) + annotation (Line(points={{-180,0},{-160,0}}, color={0,127,255})); + connect(fanRet.port_b, splEco.port_1) + annotation (Line(points={{50,0},{10,0}}, color={0,127,255})); + connect(damRel.port_a, splEco.port_2) + annotation (Line(points={{-140,0},{-10,0}}, color={0,127,255})); + connect(fanRet.port_a, port_a) + annotation (Line(points={{70,0},{180,0}}, color={0,127,255})); + annotation (Documentation(info=" ++This model represents a configuration with an air economizer +and a return fan with an actuated relief damper (modulating). +
+"), Icon(graphics={ + Line( + points={{-180,0},{180,0}}, + color={28,108,200}, + thickness=1), + Line( + points={{0,0},{0,-140}}, + color={28,108,200}, + thickness=1)})); +end ReturnFan; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.mo b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.mo new file mode 100644 index 00000000000..7a4405a1d50 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.mo @@ -0,0 +1,15 @@ +within Buildings.Templates.AirHandlersFans.Components; +package ReliefReturnSection "Models for relief/return air section" + extends Modelica.Icons.VariantsPackage; + + + + + +annotation (Documentation(info=" ++Components inside that package represent the relief/return air section of an +air handler. +
+")); +end ReliefReturnSection; diff --git a/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.order b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.order new file mode 100644 index 00000000000..578eba9e032 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/ReliefReturnSection/package.order @@ -0,0 +1,5 @@ +NoRelief +NoReturn +ReliefDamper +ReliefFan +ReturnFan diff --git a/Buildings/Templates/AirHandlersFans/Components/package.mo b/Buildings/Templates/AirHandlersFans/Components/package.mo new file mode 100644 index 00000000000..3188303effb --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/package.mo @@ -0,0 +1,12 @@ +within Buildings.Templates.AirHandlersFans; +package Components "Package with component models" + extends Modelica.Icons.VariantsPackage; + + annotation (Documentation(info=" ++This package contains component models that are used in + +Buildings.Templates.AirHandlersFans. +
+")); +end Components; diff --git a/Buildings/Templates/AirHandlersFans/Components/package.order b/Buildings/Templates/AirHandlersFans/Components/package.order new file mode 100644 index 00000000000..5e7e1159a72 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Components/package.order @@ -0,0 +1,7 @@ +Controls +HeatRecovery +OutdoorReliefReturnSection +OutdoorSection +ReliefReturnSection +Data +Interfaces diff --git a/Buildings/Templates/AirHandlersFans/Data/PartialAirHandler.mo b/Buildings/Templates/AirHandlersFans/Data/PartialAirHandler.mo new file mode 100644 index 00000000000..ae07f81f1e1 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Data/PartialAirHandler.mo @@ -0,0 +1,64 @@ +within Buildings.Templates.AirHandlersFans.Data; +record PartialAirHandler "Record for air handler interface class" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.AirHandlersFans.Types.Configuration typ + "Type of system" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanSup + "Type of supply fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRet + "Type of return fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.Components.Types.Fan typFanRel + "Type of relief fan" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Boolean have_souChiWat + "Set to true if cooling coil requires fluid ports on the source side" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Boolean have_souHeaWat + "Set to true if heating coil requires fluid ports on the source side" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.AirHandlersFans.Types.Controller typCtl + "Type of controller" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter String id="" + "System tag" + annotation (Dialog(tab="Advanced")); + parameter String id_souChiWat="" + "CHW supply system tag" + annotation (Dialog(tab="Advanced", enable=have_souChiWat)); + parameter String id_souHeaWat="" + "HHW supply system tag" + annotation (Dialog(tab="Advanced", enable=have_souHeaWat)); + + replaceable parameter Buildings.Templates.AirHandlersFans.Components.Data.PartialController + ctl( + final typFanSup=typFanSup, + final typFanRel=typFanRel, + final typFanRet=typFanRet, + final typ=typCtl) + "Controller" + annotation (Dialog(group="Controls")); + + parameter Modelica.Units.SI.MassFlowRate mAirSup_flow_nominal + "Supply air mass flow rate" + annotation (Dialog(enable=typ<>Buildings.Templates.AirHandlersFans.Types.Configuration.ExhaustOnly)); + parameter Modelica.Units.SI.MassFlowRate mAirRet_flow_nominal + "Return air mass flow rate" + annotation (Dialog(enable=typ<>Buildings.Templates.AirHandlersFans.Types.Configuration.SupplyOnly)); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for the class + +Buildings.Templates.AirHandlersFans.Interfaces.PartialAirHandler. +
+
+The tab Advanced contains some optional parameters that can be used
+for workflow automation, but are not used for simulation.
+
+This record provides the set of sizing and operating parameters for the class + +Buildings.Templates.AirHandlersFans.VAVMultiZone. +
+")); +end VAVMultiZone; diff --git a/Buildings/Templates/AirHandlersFans/Data/package.mo b/Buildings/Templates/AirHandlersFans/Data/package.mo new file mode 100644 index 00000000000..b5d21b2fde9 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Data/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.AirHandlersFans; +package Data "Records for design and operating parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + +annotation (Documentation(info=" ++This package provides records for design and operating parameters. +
+")); +end Data; diff --git a/Buildings/Templates/AirHandlersFans/Data/package.order b/Buildings/Templates/AirHandlersFans/Data/package.order new file mode 100644 index 00000000000..d53cb21682b --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Data/package.order @@ -0,0 +1,2 @@ +PartialAirHandler +VAVMultiZone diff --git a/Buildings/Templates/AirHandlersFans/Interfaces/Bus.mo b/Buildings/Templates/AirHandlersFans/Interfaces/Bus.mo new file mode 100644 index 00000000000..1388e92f03c --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Interfaces/Bus.mo @@ -0,0 +1,42 @@ +within Buildings.Templates.AirHandlersFans.Interfaces; +expandable connector Bus "Control bus for air handler" + extends Modelica.Icons.SignalBus; + + Buildings.Templates.Components.Interfaces.Bus fanSup + "Supply fan points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus fanRel + "Relief fan points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus fanRet + "Return fan points" + annotation (HideResult=false); + + Buildings.Templates.Components.Interfaces.Bus coiHea + "Heating coil (preheat or reheat position, only one coil allowed) points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus coiCoo + "Cooling coil points" + annotation (HideResult=false); + + Buildings.Templates.Components.Interfaces.Bus damOut + "OA damper points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus damOutMin + "Minimum OA damper points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus damRel + "Relief damper points" + annotation (HideResult=false); + Buildings.Templates.Components.Interfaces.Bus damRet + "Return damper points" + annotation (HideResult=false); + + annotation ( + defaultComponentName="bus", Documentation(info=" ++This expandable connector provides a standard interface for +all control signals required by an air handler controller. +
+")); +end Bus; diff --git a/Buildings/Templates/AirHandlersFans/Interfaces/PartialAirHandler.mo b/Buildings/Templates/AirHandlersFans/Interfaces/PartialAirHandler.mo new file mode 100644 index 00000000000..35c39095fa5 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Interfaces/PartialAirHandler.mo @@ -0,0 +1,236 @@ +within Buildings.Templates.AirHandlersFans.Interfaces; +partial model PartialAirHandler "Interface class for air handler" + inner replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium" + annotation(__ctrl_flow(enable=false)); + inner replaceable package MediumChiWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "CHW medium" + annotation(Dialog(enable=have_souChiWat), + __ctrl_flow(enable=false)); + inner replaceable package MediumHeaWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "HHW medium" + annotation(Dialog(enable=have_souHeaWat), + __ctrl_flow(enable=false)); + + parameter Buildings.Templates.AirHandlersFans.Types.Configuration typ + "Type of system" + annotation (Evaluate=true, Dialog(group="Configuration")); + + inner parameter Integer nZon(min=1) + "Number of served zones" + annotation ( + Evaluate=true, + Dialog(group="Configuration")); + + replaceable parameter + Buildings.Templates.AirHandlersFans.Data.PartialAirHandler dat( + final typ=typ, + final typFanSup=typFanSup, + final typFanRel=typFanRel, + final typFanRet=typFanRet, + final have_souChiWat=have_souChiWat, + final have_souHeaWat=have_souHeaWat) + "Design and operating parameters" + annotation (Placement(transformation(extent={{270,250},{290,270}}))); + + final parameter String id=dat.id + "System tag" + annotation (Dialog(group="Configuration")); + + parameter Boolean have_porRel= + typ==Buildings.Templates.AirHandlersFans.Types.Configuration.ExhaustOnly + "Set to true for relief (exhaust) fluid port" + annotation ( + Evaluate=true, + Dialog( + group="Configuration", + enable=false)); + parameter Boolean have_souChiWat + "Set to true if system uses CHW" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Boolean have_souHeaWat + "Set to true if system uses HHW" + annotation (Evaluate=true, Dialog(group="Configuration")); + + inner parameter Buildings.Templates.Components.Types.Fan typFanSup + "Type of supply fan" + annotation (Evaluate=true, Dialog(group="Configuration")); + inner parameter Buildings.Templates.Components.Types.Fan typFanRet + "Type of return fan" + annotation (Evaluate=true, Dialog(group="Configuration")); + inner parameter Buildings.Templates.Components.Types.Fan typFanRel + "Type of relief fan" + annotation (Evaluate=true, Dialog(group="Configuration")); + + // Design parameters + final parameter Modelica.Units.SI.MassFlowRate mAirSup_flow_nominal= + dat.mAirSup_flow_nominal + "Supply air mass flow rate" + annotation (Dialog(group="Nominal condition")); + final parameter Modelica.Units.SI.MassFlowRate mAirRet_flow_nominal= + dat.mAirRet_flow_nominal + "Return air mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.MassFlowRate mChiWat_flow_nominal + "Total CHW mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.MassFlowRate mHeaWat_flow_nominal + "Total HHW mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.HeatFlowRate QChiWat_flow_nominal + "Total CHW heat flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.HeatFlowRate QHeaWat_flow_nominal + "Total HHW heat flow rate" + annotation (Dialog(group="Nominal condition")); + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations"), + __ctrl_flow(enable=false)); + + final parameter Boolean allowFlowReversalAir=true + "= true to allow flow reversal, false restricts to design direction - Air side" + annotation (Dialog(tab="Assumptions"), Evaluate=true, + __ctrl_flow(enable=false)); + parameter Boolean allowFlowReversalLiq=true + "= true to allow flow reversal, false restricts to design direction - CHW and HW side" + annotation (Dialog(tab="Assumptions", enable=have_souChiWat or have_souHeaWat), + Evaluate=true, + __ctrl_flow(enable=false)); + parameter Boolean show_T = false + "= true, if actual temperature at ports of subcomponents is computed" + annotation(Dialog(tab="Advanced",group="Diagnostics"), + __ctrl_flow(enable=false)); + + Modelica.Fluid.Interfaces.FluidPort_a port_Out( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversalAir then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.Configuration.ExhaustOnly + "Outdoor air intake" + annotation (Placement(transformation( + extent={{-310,-210},{-290,-190}}), iconTransformation(extent={{-210, + -110},{-190,-90}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_Sup( + redeclare final package Medium =MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) if typ + == Buildings.Templates.AirHandlersFans.Types.Configuration.SupplyOnly or typ == + Buildings.Templates.AirHandlersFans.Types.Configuration.SingleDuct + "Supply air" annotation ( + Placement(transformation(extent={{290,-210},{310,-190}}), + iconTransformation(extent={{190,-110},{210,-90}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_SupCol( + redeclare final package Medium =MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ == Buildings.Templates.AirHandlersFans.Types.Configuration.DualDuct + "Dual duct cold deck air supply" + annotation (Placement(transformation( + extent={{290,-250},{310,-230}}), iconTransformation(extent={{190, + -180},{210,-160}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_SupHot( + redeclare final package Medium =MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ == Buildings.Templates.AirHandlersFans.Types.Configuration.DualDuct + "Dual duct hot deck air supply" + annotation (Placement( + transformation(extent={{290,-170},{310,-150}}), iconTransformation( + extent={{190,-40},{210,-20}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_Ret( + redeclare final package Medium =MediumAir, + m_flow(min=if allowFlowReversalAir then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.Configuration.SupplyOnly + "Return air" + annotation (Placement(transformation(extent={{290,-90},{310,-70}}), + iconTransformation(extent={{190,90},{210,110}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_Rel( + redeclare final package Medium = MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.AirHandlersFans.Types.Configuration.SupplyOnly and have_porRel + "Relief (exhaust) air" + annotation (Placement(transformation(extent={{-310,-90},{-290,-70}}), + iconTransformation(extent={{-210,90}, {-190,110}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bChiWat( + redeclare final package Medium = MediumChiWat, + m_flow(max=if allowFlowReversalLiq then +Modelica.Constants.inf else 0), + h_outflow(start=MediumChiWat.h_default, nominal=MediumChiWat.h_default)) + if have_souChiWat + "CHW return port" annotation ( + Placement(transformation(extent={{50,-290},{70,-270}}), + iconTransformation(extent={{40,-210},{60,-190}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_aChiWat( + redeclare final package Medium = MediumChiWat, + m_flow(min=if allowFlowReversalLiq then -Modelica.Constants.inf else 0), + h_outflow(start=MediumChiWat.h_default, nominal=MediumChiWat.h_default)) + if have_souChiWat + "CHW supply port" annotation ( + Placement(transformation(extent={{90,-290},{110,-270}}), + iconTransformation(extent={{120,-210},{140,-190}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bHeaWat( + redeclare final package Medium = MediumHeaWat, + m_flow(max=if allowFlowReversalLiq then +Modelica.Constants.inf else 0), + h_outflow(start=MediumHeaWat.h_default, nominal=MediumHeaWat.h_default)) + if have_souHeaWat + "HHW return port" annotation ( + Placement(transformation(extent={{-30,-290},{-10,-270}}), + iconTransformation(extent={{-140,-210},{-120,-190}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_aHeaWat( + redeclare final package Medium = MediumHeaWat, + m_flow(min=if allowFlowReversalLiq then -Modelica.Constants.inf else 0), + h_outflow(start=MediumHeaWat.h_default, nominal=MediumHeaWat.h_default)) + if have_souHeaWat + "HHW supply port" annotation ( + Placement(transformation(extent={{10,-290},{30,-270}}), + iconTransformation(extent={{-60,-210},{-40,-190}}))); + Buildings.Templates.AirHandlersFans.Interfaces.Bus bus + "AHU control bus" + annotation (Placement(transformation( + extent={{-20,-20},{20,20}}, + rotation=90, + origin={-300,0}), iconTransformation( + extent={{-20,-19},{20,19}}, + rotation=90, + origin={-199,160}))); + Buildings.BoundaryConditions.WeatherData.Bus busWea + "Weather bus" + annotation (Placement(transformation(extent={{-20,260},{20,300}}), + iconTransformation(extent={{-20,182},{20,218}}))); + Buildings.Templates.ZoneEquipment.Interfaces.Bus busTer[nZon] + "Terminal unit control bus" + annotation (Placement(transformation( + extent={{-20,-20},{20,20}}, + rotation=-90, + origin={300,0}), iconTransformation( + extent={{-20,-20},{20,20}}, + rotation=-90, + origin={198,160}))); + +annotation ( + Icon(coordinateSystem(preserveAspectRatio=false, + extent={{-200,-200},{200,200}}), graphics={ + Text( + extent={{-155,-218},{145,-258}}, + textColor={0,0,255}, + textString="%name"), Rectangle( + extent={{-200,200},{200,-200}}, + lineColor={0,0,255}, + fillColor={255,255,255}, + fillPattern=FillPattern.Solid)}), + Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-300,-280},{300, + 280}})), + Documentation(info=" ++This partial class provides a standard interface for air handler templates. +
+")); +end PartialAirHandler; diff --git a/Buildings/Templates/AirHandlersFans/Interfaces/package.mo b/Buildings/Templates/AirHandlersFans/Interfaces/package.mo new file mode 100644 index 00000000000..a48ce851615 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Interfaces/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.AirHandlersFans; +package Interfaces "Interface classes" +extends Modelica.Icons.InterfacesPackage; + +annotation (Documentation(info=" ++This package contains interface classes. +
+")); +end Interfaces; diff --git a/Buildings/Templates/AirHandlersFans/Interfaces/package.order b/Buildings/Templates/AirHandlersFans/Interfaces/package.order new file mode 100644 index 00000000000..bcf5a99f5ac --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Interfaces/package.order @@ -0,0 +1,2 @@ +Bus +PartialAirHandler diff --git a/Buildings/Templates/AirHandlersFans/Types.mo b/Buildings/Templates/AirHandlersFans/Types.mo new file mode 100644 index 00000000000..6b4da8eca3c --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Types.mo @@ -0,0 +1,68 @@ +within Buildings.Templates.AirHandlersFans; +package Types "Package with type definitions" + extends Modelica.Icons.TypesPackage; + type Configuration = enumeration( + SupplyOnly + "Supply only system", + ExhaustOnly + "Exhaust only system", + DualDuct + "Dual duct system with supply and return", + SingleDuct + "Single duct system with supply and return") + "Enumeration to configure the AHU"; + type Controller = enumeration( + G36VAVMultiZone + "Guideline 36 controller for multiple-zone VAV", + OpenLoop + "Open loop controller") + "Enumeration to configure the AHU controller"; + type ControlFanReturn = enumeration( + AirflowMeasured + "Airflow tracking with airflow measurement stations", + BuildingPressure + "Building pressure (via discharge static pressure)") + "Enumeration to configure the return fan control"; + // RFE: Add support for heat recovery. + type HeatRecovery = enumeration( + None + "No heat recovery", + FlatPlate + "Flat plate heat exchanger", + EnthalpyWheel + "Enthalpy wheel", + RunAroundCoil + "Run-around coil") + "Enumeration to configure the heat recovery"; + type OutdoorReliefReturnSection = enumeration( + HundredPctOutdoorAir + "100 % outdoor air system", + MixedAirWithDamper + "Mixed air system with return air damper - Optional economizer function", + MixedAirNoDamper + "Mixed air system without return air damper - No economizer function", + MixedAirNoRelief + "Mixed air system without relief branch - Optional economizer function") + "Enumeration to configure the outdoor/relief/return air section"; + /* RFE: Add support for the following configurations. + Barometric + "Barometric relief damper without fan", + */ + type ReliefReturnSection = enumeration( + NoRelief + "No relief branch", + NoReturn + "No return branch", + ReliefDamper + "Modulating relief damper without fan", + ReliefFan + "Relief fan with two-position relief damper", + ReturnFan + "Return fan with modulating relief damper") + "Enumeration to configure the relief/return air section"; + annotation (Documentation(info=" ++This package contains type definitions. +
+")); +end Types; diff --git a/Buildings/Templates/AirHandlersFans/VAVMultiZone.mo b/Buildings/Templates/AirHandlersFans/VAVMultiZone.mo new file mode 100644 index 00000000000..71637cb745b --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/VAVMultiZone.mo @@ -0,0 +1,771 @@ +within Buildings.Templates.AirHandlersFans; +model VAVMultiZone "Multiple-zone VAV" +/* + HACK: In Dymola only (ticket SR00860858-01), bindings for the parameter record + cannot be made final if propagation from a top-level record (whole building) + is needed. + Instead those parameter declarations are annoted with enable=false + in the record class. +*/ + extends Buildings.Templates.AirHandlersFans.Interfaces.PartialAirHandler( + nZon(final min=2), + redeclare Buildings.Templates.AirHandlersFans.Data.VAVMultiZone dat( + typCoiHeaPre=coiHeaPre.typ, + typCoiCoo=coiCoo.typ, + typCoiHeaReh=coiHeaReh.typ, + typValCoiHeaPre=coiHeaPre.typVal, + typValCoiCoo=coiCoo.typVal, + typValCoiHeaReh=coiHeaReh.typVal, + typDamOut=secOutRel.typDamOut, + typDamOutMin=secOutRel.typDamOutMin, + typDamRet=secOutRel.typDamRet, + typDamRel=secOutRel.typDamRel, + typSecOut=secOutRel.typSecOut, + typCtl=ctl.typ, + buiPreCon=ctl.buiPreCon, + stdVen=ctl.stdVen), + final typ=Buildings.Templates.AirHandlersFans.Types.Configuration.SingleDuct, + final have_porRel=secOutRel.typ <> Types.OutdoorReliefReturnSection.MixedAirNoRelief, + final have_souChiWat=coiCoo.have_sou, + final have_souHeaWat=coiHeaPre.have_sou or coiHeaReh.have_sou, + final typFanSup=if + fanSupDra.typ <> Buildings.Templates.Components.Types.Fan.None then + fanSupDra.typ elseif fanSupBlo.typ <> Buildings.Templates.Components.Types.Fan.None + then fanSupBlo.typ else Buildings.Templates.Components.Types.Fan.None, + final typFanRel=secOutRel.typFanRel, + final typFanRet=secOutRel.typFanRet, + final mChiWat_flow_nominal=if coiCoo.have_sou then dat.coiCoo.mWat_flow_nominal else 0, + final mHeaWat_flow_nominal=(if coiHeaPre.have_sou then dat.coiHeaPre.mWat_flow_nominal else 0) + + (if coiHeaReh.have_sou then dat.coiHeaReh.mWat_flow_nominal else 0), + final QChiWat_flow_nominal=if coiCoo.have_sou then dat.coiCoo.Q_flow_nominal else 0, + final QHeaWat_flow_nominal=(if coiHeaPre.have_sou then dat.coiHeaPre.Q_flow_nominal else 0) + + (if coiHeaReh.have_sou then dat.coiHeaReh.Q_flow_nominal else 0)); + + final parameter Boolean have_senPreBui= + secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefDamper or + secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReliefFan or + secOutRel.typSecRel==Buildings.Templates.AirHandlersFans.Types.ReliefReturnSection.ReturnFan and + secOutRel.typCtlFanRet==Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.BuildingPressure + "Set to true if building static pressure sensor is used" + annotation (Evaluate=true, Dialog(group="Configuration")); + + /* + RFE: Currently only the configuration with economizer is supported. + Hence, no choices annotation, but still replaceable to access parameter + dialog box of the component. + */ + inner Buildings.Templates.AirHandlersFans.Components.OutdoorReliefReturnSection.MixedAirWithDamper + secOutRel( + redeclare final package MediumAir = MediumAir, + final typCtlFanRet=ctl.typCtlFanRet, + final typCtlEco=ctl.typCtlEco, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversalAir, + dat( + final mOutMin_flow_nominal=dat.mOutMin_flow_nominal, + final damOut=dat.damOut, + final damOutMin=dat.damOutMin, + final damRel=dat.damRel, + final damRet=dat.damRet, + final fanRel=dat.fanRel, + final fanRet=dat.fanRet)) + "Outdoor/relief/return air section" + annotation ( + Dialog(group="Configuration"), Placement(transformation(extent={{-280,-220}, + {-120,-60}}))); + + Buildings.Templates.Components.Sensors.Temperature TAirMix( + redeclare final package Medium = MediumAir, + final have_sen=ctl.use_TMix, + final typ=Buildings.Templates.Components.Types.SensorTemperature.Averaging, + final m_flow_nominal=mAirSup_flow_nominal, + final allowFlowReversal=allowFlowReversalAir) + "Mixed air temperature sensor" + annotation (Placement( + transformation(extent={{-110,-210},{-90,-190}}))); + + inner replaceable Buildings.Templates.Components.Fans.None fanSupBlo + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversalAir, + final dat=dat.fanSup, + final have_senFlo=ctl.typCtlFanRet== + Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured) + "Supply fan - Blow through" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Fans.None fanSupBlo + "No fan"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.SingleVariable fanSupBlo + "Single fan - Variable speed"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.ArrayVariable fanSupBlo + "Fan array - Variable speed")), + Dialog(group="Configuration", + enable=fanSupDra.typ==Buildings.Templates.Components.Types.Fan.None), + Placement(transformation(extent={{-50,-210},{-30,-190}}))); + + Buildings.Templates.Components.Sensors.Temperature TAirCoiHeaLvg( + redeclare final package Medium = MediumAir, + final have_sen=coiHeaPre.typ <> Buildings.Templates.Components.Types.Coil.None + and coiCoo.typ <> Buildings.Templates.Components.Types.Coil.None, + final typ=Buildings.Templates.Components.Types.SensorTemperature.Averaging, + final m_flow_nominal=mAirSup_flow_nominal, + final allowFlowReversal=allowFlowReversalAir) + "Heating coil leaving air temperature sensor" + annotation ( + Placement(transformation(extent={{40,-210},{60,-190}}))); + + Buildings.Templates.Components.Sensors.Temperature TAirCoiCooLvg( + redeclare final package Medium = MediumAir, + final have_sen=coiCoo.typ <> Buildings.Templates.Components.Types.Coil.None + and coiHeaReh.typ <> Buildings.Templates.Components.Types.Coil.None, + final typ=Buildings.Templates.Components.Types.SensorTemperature.Averaging, + final m_flow_nominal=mAirSup_flow_nominal, + final allowFlowReversal=allowFlowReversalAir) + "Cooling coil leaving air temperature sensor" + annotation ( + Placement(transformation(extent={{100,-210},{120,-190}}))); + + inner replaceable Buildings.Templates.Components.Fans.SingleVariable fanSupDra + constrainedby Buildings.Templates.Components.Interfaces.PartialFan( + redeclare final package Medium = MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversalAir, + final dat=dat.fanSup, + final have_senFlo=ctl.typCtlFanRet== + Buildings.Templates.AirHandlersFans.Types.ControlFanReturn.AirflowMeasured) + "Supply fan - Draw through" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Fans.None fanSupDra + "No fan"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.SingleVariable fanSupDra + "Single fan - Variable speed"), + choice(redeclare replaceable Buildings.Templates.Components.Fans.ArrayVariable fanSupDra + "Fan array - Variable speed")), + Dialog(group="Configuration", + enable=fanSupBlo.typ==Buildings.Templates.Components.Types.Fan.None), + Placement(transformation(extent={{172,-210},{192,-190}}))); + + Buildings.Templates.Components.Sensors.Temperature TAirSup( + redeclare final package Medium = MediumAir, + final have_sen=true, + final typ=Buildings.Templates.Components.Types.SensorTemperature.Standard, + final m_flow_nominal=mAirSup_flow_nominal, + final allowFlowReversal=allowFlowReversalAir) + "Supply air temperature sensor" + annotation (Placement( + transformation(extent={{210,-210},{230,-190}}))); + + Buildings.Templates.Components.Sensors.DifferentialPressure pBui_rel( + redeclare final package Medium = MediumAir, + final have_sen=have_senPreBui, + final text_flip=true) + "Building static pressure" + annotation (Placement(transformation(extent={{10,30},{-10,50}}))); + + Buildings.Fluid.Sources.Outside out( + redeclare final package Medium=MediumAir, + final nPorts=3) + "Outdoor conditions" + annotation ( + Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={-40,90}))); + Buildings.Fluid.Sources.Boundary_pT bui( + redeclare final package Medium = MediumAir, + final use_p_in=have_senPreBui, + final nPorts=1) + "Building absolute pressure in representative space" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={40,60}))); + + Buildings.Templates.Components.Sensors.Temperature TAirRet( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversalAir, + final have_sen= + secOutRel.have_eco and + (ctl.typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialDryBulb or + ctl.typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.FixedDryBulbWithDifferentialDryBulb), + final typ=Buildings.Templates.Components.Types.SensorTemperature.Standard, + final m_flow_nominal=mAirRet_flow_nominal) + "Return air temperature sensor" + annotation ( + Placement(transformation(extent={{220,-90},{200,-70}}))); + + Buildings.Templates.Components.Sensors.SpecificEnthalpy hAirRet( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversalAir, + final have_sen= + secOutRel.have_eco and + ctl.typCtlEco==Buildings.Controls.OBC.ASHRAE.G36.Types.ControlEconomizer.DifferentialEnthalpyWithFixedDryBulb, + final m_flow_nominal=mAirRet_flow_nominal) + "Return air enthalpy sensor" + annotation ( + Placement(transformation(extent={{250,-90},{230,-70}}))); + + Buildings.Templates.Components.Sensors.DifferentialPressure pAirSup_rel( + redeclare final package Medium = MediumAir, + final have_sen=true) + "Duct static pressure sensor" + annotation ( + Placement(transformation(extent={{250,-230},{270,-210}}))); + + inner replaceable Buildings.Templates.Components.Coils.WaterBasedHeating coiHeaPre( + redeclare final package MediumHeaWat=MediumHeaWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + constrainedby Buildings.Templates.Components.Interfaces.PartialCoil( + final dat=dat.coiHeaPre, + redeclare final package MediumAir=MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversalAir=allowFlowReversalAir, + final allowFlowReversalLiq=allowFlowReversalLiq, + final show_T=show_T) + "Heating coil in preheat position" + annotation ( + choices( + choice( + redeclare replaceable Buildings.Templates.Components.Coils.None coiHeaPre + "No coil"), + choice( + redeclare replaceable Buildings.Templates.Components.Coils.WaterBasedHeating coiHeaPre( + redeclare final package MediumHeaWat=MediumHeaWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + "Hot water coil with two-way valve"), + choice( + redeclare replaceable Buildings.Templates.Components.Coils.ElectricHeating coiHeaPre + "Modulating electric heating coil")), + Dialog(group="Configuration", + enable=coiHeaReh.typ==Buildings.Templates.Components.Types.Coil.None), + Placement(transformation(extent={{10,-210},{30,-190}}))); + + inner replaceable Buildings.Templates.Components.Coils.WaterBasedCooling coiCoo( + redeclare final package MediumChiWat=MediumChiWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + constrainedby Buildings.Templates.Components.Interfaces.PartialCoil( + final dat=dat.coiCoo, + redeclare final package MediumAir=MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversalAir=allowFlowReversalAir, + final allowFlowReversalLiq=allowFlowReversalLiq, + final show_T=show_T) + "Cooling coil" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Coils.None coiCoo + "No coil"), + choice(redeclare replaceable Buildings.Templates.Components.Coils.WaterBasedCooling coiCoo( + redeclare final package MediumChiWat=MediumChiWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + "Chilled water coil with two-way valve")), + Dialog(group="Configuration"), + Placement(transformation(extent={{70,-210},{90,-190}}))); + inner replaceable Buildings.Templates.Components.Coils.None coiHeaReh + constrainedby Buildings.Templates.Components.Interfaces.PartialCoil( + final dat=dat.coiHeaReh, + redeclare final package MediumAir=MediumAir, + final energyDynamics=energyDynamics, + final allowFlowReversalAir=allowFlowReversalAir, + final allowFlowReversalLiq=allowFlowReversalLiq, + final show_T=show_T) + "Heating coil in reheat position" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Coils.None coiHeaReh + "No coil"), + choice(redeclare replaceable Buildings.Templates.Components.Coils.WaterBasedHeating coiHeaReh( + redeclare final package MediumHeaWat=MediumHeaWat) + "Hot water coil"), + choice( + redeclare replaceable Buildings.Templates.Components.Coils.ElectricHeating coiHeaReh + "Modulating electric heating coil")), + Dialog(group="Configuration", + enable=coiHeaPre.typ==Buildings.Templates.Components.Types.Coil.None and + ctl.typ<>Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone), + Placement(transformation(extent={{130,-210},{150,-190}}))); + Buildings.Fluid.FixedResistances.Junction junHeaWatSup( + redeclare final package Medium = MediumHeaWat, + final m_flow_nominal=mHeaWat_flow_nominal*{1,-1,-1}, + energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial, + dp_nominal=fill(0, 3), + final portFlowDirection_1=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering, + final portFlowDirection_2=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving, + final portFlowDirection_3=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving) if have_souHeaWat + "HHW supply junction" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=90, + origin={20,-260}))); + Buildings.Fluid.FixedResistances.Junction junHeaWatRet( + redeclare final package Medium = MediumHeaWat, + final m_flow_nominal=mHeaWat_flow_nominal*{1,-1,1}, + energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial, + dp_nominal=fill(0, 3), + final portFlowDirection_1=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering, + final portFlowDirection_2=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering, + final portFlowDirection_3=if allowFlowReversalLiq then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving) if have_souHeaWat + "HHW return junction" annotation ( + Placement(transformation( + extent={{10,-10},{-10,10}}, + rotation=90, + origin={-20,-240}))); + inner replaceable Buildings.Templates.AirHandlersFans.Components.Controls.G36VAVMultiZone ctl + constrainedby + Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialControllerVAVMultizone( + final dat=dat.ctl, + final nZon=nZon) + "Control selections" + annotation ( + Dialog(group="Controls"), + Placement(transformation(extent={{-220,-10},{-200,10}}))); + +initial equation + assert(typFanSup<>Buildings.Templates.Components.Types.Fan.None, + "In "+ getInstanceName() + ": "+ + "The template is configured with no supply fan, which is not supported."); + assert(not (fanSupBlo.typ<>Buildings.Templates.Components.Types.Fan.None and + fanSupDra.typ<>Buildings.Templates.Components.Types.Fan.None), + "In "+ getInstanceName() + ": "+ + "The template is configured with both a blow-through fan and a draw-through fan, which is not supported."); +equation + /* Control point connection - start */ + connect(TAirMix.y, bus.TAirMix); + connect(TAirCoiHeaLvg.y, bus.TAirCoiHeaLvg); + connect(TAirSup.y, bus.TAirSup); + connect(pAirSup_rel.y, bus.pAirSup_rel); + connect(hAirRet.y, bus.hAirRet); + connect(TAirRet.y, bus.TAirRet); + connect(fanSupDra.bus, bus.fanSup); + connect(fanSupBlo.bus, bus.fanSup); + connect(coiHeaPre.bus, bus.coiHea); + connect(coiCoo.bus, bus.coiCoo); + connect(coiHeaReh.bus, bus.coiHea); + connect(secOutRel.bus, bus); + connect(bui.p_in, bus.pBui); + connect(pBui_rel.y, bus.pBui_rel); + /* Control point connection - stop */ + + connect(port_aChiWat, coiCoo.port_aSou) annotation (Line(points={{100,-280},{ + 100,-268},{85,-268},{85,-210}}, + color={0,127,255})); + connect(coiCoo.port_bSou, port_bChiWat) annotation (Line(points={{75,-210},{ + 75,-268},{60,-268},{60,-280}}, + color={0,127,255})); + connect(busWea,coiCoo.busWea) annotation (Line( + points={{0,280},{0,100},{76,100},{76,-190}}, + color={255,204,51}, + thickness=0.5)); + connect(TAirMix.port_b, fanSupBlo.port_a) + annotation (Line(points={{-90,-200},{-50,-200}}, color={0,127,255})); + connect(coiHeaReh.port_b, fanSupDra.port_a) + annotation (Line(points={{150,-200},{172,-200}}, color={0,127,255})); + connect(busWea, out.weaBus) annotation (Line( + points={{0,280},{0,100},{-39.8,100}}, + color={255,204,51}, + thickness=0.5)); + connect(pBui_rel.port_b, out.ports[1]) annotation (Line(points={{-10,40},{-40, + 40},{-40,80},{-41.3333,80}}, + color={0,127,255})); + connect(bui.ports[1], pBui_rel.port_a) annotation (Line(points={{40,50},{40,40}, + {10,40}}, color={0,127,255})); + + connect(ctl.busTer, busTer) annotation (Line( + points={{-200,0},{300,0}}, + color={255,204,51}, + thickness=0.5), Text( + string="%second", + index=1, + extent={{6,3},{6,3}}, + horizontalAlignment=TextAlignment.Left)); + connect(ctl.bus, bus) annotation (Line( + points={{-220,0},{-300,0}}, + color={255,204,51}, + thickness=0.5), Text( + string="%second", + index=1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + connect(port_Ret, hAirRet.port_a) + annotation (Line(points={{300,-80},{250,-80}}, color={0,127,255})); + connect(hAirRet.port_b, TAirRet.port_a) + annotation (Line(points={{230,-80},{220,-80}}, color={0,127,255})); + connect(coiHeaPre.port_b, TAirCoiHeaLvg.port_a) + annotation (Line(points={{30,-200},{40,-200}}, color={0,127,255})); + connect(TAirCoiHeaLvg.port_b, coiCoo.port_a) + annotation (Line(points={{60,-200},{70,-200}}, color={0,127,255})); + connect(coiCoo.port_b, TAirCoiCooLvg.port_a) + annotation (Line(points={{90,-200},{100,-200}}, color={0,127,255})); + connect(TAirCoiCooLvg.port_b, coiHeaReh.port_a) + annotation (Line(points={{120,-200},{130,-200}}, color={0,127,255})); + connect(secOutRel.port_Sup, TAirMix.port_a) + annotation (Line(points={{-120,-200},{-110,-200}}, color={0,127,255})); + connect(secOutRel.port_bPre, out.ports[2]) annotation (Line(points={{-162,-60}, + {-162,80},{-40,80}}, color={0,127,255})); + connect(port_Rel, secOutRel.port_Rel) + annotation (Line(points={{-300,-80},{-280,-80}}, color={0,127,255})); + connect(port_Out, secOutRel.port_Out) + annotation (Line(points={{-300,-200},{-280,-200}}, color={0,127,255})); + connect(TAirSup.port_b, port_Sup) + annotation (Line(points={{230,-200},{300,-200}}, color={0,127,255})); + connect(TAirSup.port_b, pAirSup_rel.port_a) annotation (Line(points={{230,-200}, + {240,-200},{240,-220},{250,-220}}, color={0,127,255})); + connect(fanSupDra.port_b, TAirSup.port_a) + annotation (Line(points={{192,-200},{210,-200}}, color={0,127,255})); + connect(port_aHeaWat, junHeaWatSup.port_1) + annotation (Line(points={{20,-280},{20,-270}}, color={0,127,255})); + connect(port_bHeaWat, junHeaWatRet.port_2) + annotation (Line(points={{-20,-280},{-20,-250}}, color={0,127,255})); + connect(junHeaWatSup.port_3, coiHeaReh.port_aSou) annotation (Line(points={{ + 30,-260},{145,-260},{145,-210}}, color={0,127,255})); + connect(coiHeaReh.port_bSou, junHeaWatRet.port_3) annotation (Line(points={{135, + -210},{135,-240},{-10,-240}}, color={0,127,255})); + connect(coiHeaPre.port_bSou, junHeaWatRet.port_1) annotation (Line(points={{15, + -210},{15,-220},{-20,-220},{-20,-230}}, color={0,127,255})); + connect(junHeaWatSup.port_2, coiHeaPre.port_aSou) annotation (Line(points={{20,-250}, + {20,-220},{25,-220},{25,-210}}, color={0,127,255})); + connect(out.ports[3], pAirSup_rel.port_b) annotation (Line(points={{-38.6667, + 80},{280,80},{280,-220},{270,-220}}, + color={0,127,255})); + connect(secOutRel.port_Ret, TAirRet.port_b) annotation (Line(points={{-120,-80.2}, + {40,-80.2},{40,-80},{200,-80}}, color={0,127,255})); + connect(fanSupBlo.port_b, coiHeaPre.port_a) + annotation (Line(points={{-30,-200},{10,-200}}, color={0,127,255})); + annotation ( + defaultComponentName="VAV", + Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Rectangle( + extent={{-200,120},{200,80}}, + pattern=LinePattern.None, + fillPattern=FillPattern.Solid, + fillColor={0,127,127}, + lineColor={0,127,127}), + Rectangle( + extent={{-200,-80},{200,-120}}, + pattern=LinePattern.None, + fillPattern=FillPattern.Solid, + fillColor={0,127,127}, + lineColor={0,127,127}), + Ellipse( + extent={{110,-80},{150,-120}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Sphere, + fillColor={0,100,199}, + visible=typFanSup <> Buildings.Templates.Components.Types.Fan.None), + Polygon( + points={{130,-81},{130,-119},{149,-100},{130,-81}}, + lineColor={0,0,0}, + pattern=LinePattern.None, + fillPattern=FillPattern.HorizontalCylinder, + fillColor={255,255,255}, + visible=typFanSup <> Buildings.Templates.Components.Types.Fan.None), + Ellipse( + extent={{-20,120},{20,80}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Sphere, + fillColor={0,100,199}, + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + or typFanRel <> Buildings.Templates.Components.Types.Fan.None), + Polygon( + points={{0,119},{0,81},{-19,100},{0,119}}, + lineColor={0,0,0}, + pattern=LinePattern.None, + fillPattern=FillPattern.HorizontalCylinder, + fillColor={255,255,255}, + visible=typFanRet <> Buildings.Templates.Components.Types.Fan.None + or typFanRel <> Buildings.Templates.Components.Types.Fan.None), + Rectangle( + extent={{48,-80},{78,-120}}, + lineColor={0,0,0}, + fillColor={95,95,95}, + fillPattern=FillPattern.Solid, + lineThickness=0.5, + visible=coiCoo.typ <> Buildings.Templates.Components.Types.Coil.None), + Line( + points={{78,-80},{48,-120}}, + color={0,0,0}, + thickness=0.5, + visible=coiCoo.typ <> Buildings.Templates.Components.Types.Coil.None), + Rectangle( + extent={{-78,-80},{-48,-120}}, + lineColor={0,0,0}, + fillColor={95,95,95}, + fillPattern=FillPattern.Solid, + lineThickness=0.5, + visible=coiHeaPre.typ <> Buildings.Templates.Components.Types.Coil.None + or coiHeaReh.typ <> Buildings.Templates.Components.Types.Coil.None), + Line( + points={{-48,-80},{-78,-120}}, + color={0,0,0}, + thickness=0.5, + visible=coiHeaPre.typ <> Buildings.Templates.Components.Types.Coil.None + or coiHeaReh.typ <> Buildings.Templates.Components.Types.Coil.None), + Line( + points={{-160,-80},{-180,-120}}, + color={0,0,0}, + thickness=0.5), + Ellipse( + extent={{-174,-96},{-166,-104}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Solid, + fillColor={0,0,0}), + Line( + points={{-160,120},{-180,80}}, + color={0,0,0}, + thickness=0.5), + Ellipse( + extent={{-174,104},{-166,96}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Solid, + fillColor={0,0,0}), + Rectangle( + extent={{-80,20},{80,-20}}, + pattern=LinePattern.None, + fillPattern=FillPattern.Solid, + fillColor={0,127,127}, + lineColor={0,127,127}, + origin={-130,0}, + rotation=-90), + Line( + points={{20,10},{-20,-10}}, + color={0,0,0}, + thickness=0.5, + origin={-130,0}, + rotation=360), + Ellipse( + extent={{-134,4},{-126,-4}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Solid, + fillColor={0,0,0}), + Line( + points={{50,-200},{50,-120}}, + color={28,108,200}, + pattern=LinePattern.Dash, + thickness=5, + visible=have_souChiWat), + Line( + points={{-50,-200},{-50,-120}}, + color={238,46,47}, + thickness=5, + visible=have_souHeaWat), + Line( + points={{130,-200},{130,-194},{76,-194},{76,-120}}, + color={28,108,200}, + thickness=5, + visible=have_souChiWat), + Line( + points={{-130,-200},{-130,-194},{-76,-194},{-76,-120}}, + color={238,46,47}, + thickness=5, + visible=have_souHeaWat, + pattern=LinePattern.Dash)}), +Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-300,-280},{300,280}}), + graphics={ + Line(points={{300,-70},{-120,-70}}, color={0,0,0}), + Line(points={{300,-90},{-120,-90}}, color={0,0,0}), + Line(points={{300,-210},{-120,-210}}, color={0,0,0}), + Line(points={{300,-190},{-120,-190}}, color={0,0,0}), + Line( + visible=have_senPreBui, + points={{-16,40},{-10,40}}, + color={0,0,0}, + thickness=1), + Line( + visible=have_senPreBui, + points={{16,40},{10,40}}, + color={0,0,0}, + thickness=1), + Text( + visible=have_senPreBui, + extent={{18,46},{60,34}}, + textColor={0,0,0}, + horizontalAlignment=TextAlignment.Left, + fontName="sans-serif", + textString="REPRESENTATIVE SPACE INSIDE BUILDING"), + Text( + visible=have_senPreBui, + extent={{-60,46},{-18,34}}, + textColor={0,0,0}, + horizontalAlignment=TextAlignment.Right, + fontName="sans-serif", + textString="REFERENCE OUTSIDE BUILDING"), + Polygon(points={{251,-220},{251,-206},{250,-206},{250,-221},{256,-221},{ + 256,-220},{251,-220}}, lineColor={0,0,0}), + Rectangle(extent={{264,-220},{270,-221}}, lineColor={0,0,0})}), + Documentation(info=" ++This template represents a multiple-zone VAV air handler for +a single duct system serving at least two terminal units. +
+
+The possible configuration options are enumerated in the table below.
+The user may refer to ASHRAE (2021) for further details.
+The first option displayed in bold characters corresponds to the default configuration.
+
| Configuration parameter | Options | Notes |
|---|---|---|
| Outdoor air section | +
+Single damper for ventilation and economizer, with airflow measurement station +Separate dampers for ventilation and economizer, with airflow measurement station +Separate dampers for ventilation and economizer, with differential pressure sensor + |
++ |
| Relief/return air section | +
+Return fan with modulating relief damper +Modulating relief damper without fan +Relief fan with two-position relief damper + |
+Nonactuated barometric relief is currently not supported. | +
| Supply fan - Blow-through position | +
+No fan +Single fan - Variable speed +Fan array - Variable speed + |
+At least one supply fan must be specified, either in blow-through
+or draw-through position. Those two configurations are exclusive from
+one another. +ASHRAE Guideline 36 does not have any particular logic yet for handling fan arrays. +If a fan array is selected, all of the fans are currently controlled together at +the same speed, regardless of the number of VFDs. + |
+
| Heating coil - Preheat position | +
+Hot water coil with two-way valve +Modulating electric heating coil +No coil + |
++ |
| Cooling coil | +
+Chilled water coil with two-way valve +No coil + |
++ |
| Heating coil - Reheat position | ++No coil + | ++ASHRAE Guideline 36 does not support heating coils in reheat position +yet. + | +
| Supply fan - Draw-through position | +
+Single fan - Variable speed +Fan array - Variable speed +No fan + |
+At least one supply fan must be specified, either in blow-through
+or draw-through position. Those two configurations are exclusive from
+one another. +ASHRAE Guideline 36 does not have any particular logic yet for handling fan arrays. +If a fan array is selected, all of the fans are currently controlled together at +the same speed, regardless of the number of VFDs. + |
+
| Return fan | +
+Single fan - Variable speed +Fan array - Variable speed +No fan + |
+The relief fan and the return fan are both optional and +they are exclusive from one another. | +
| Relief fan | +
+No fan +Single fan - Variable speed +Fan array - Variable speed + |
+The relief fan and the return fan are both optional and +they are exclusive from one another. | +
| Controller | ++ASHRAE Guideline 36 controller + | ++An open loop controller is also available for validation purposes only. + | +
| Exhaust fan | ++Not available: see note + | +All exhaust fans that normally operate with the air handler must +be configured separately, by means of a dedicated template. + + | +
| Heat recovery | ++Not available: see note + | +Currently no heat recovery equipment is supported. + + | +
+The duct static pressure sensors use the outdoor absolute pressure +as an approximation of the reference pressure in the mechanical room +where the air handler is located. +
+
+When a building static pressure measurement is required by the control
+sequence
+(ctl.typCtlFanRet=AirHandlersFans.Types.ControlFanReturn.BuildingPressure),
+the corresponding sensor pBui_rel is instantiated
+within the current class.
+In this case, an additional variable pBui needs to be
+connected to the control bus to pass in the value of the absolute pressure
+in a representative space of the building.
+This is a modeling requirement, the actual control point remains the
+relative building static pressure.
+
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Outdoor air section | No economizer |
| Relief/return air section | No economizer |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Heating coil | Modulating electric heating coil - Preheat position |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Cooling coil | Evaporator coil with multi-stage compressor |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Cooling coil | Evaporator coil with variable speed compressor |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Heating coil | Hot water coil - Three-way modulating valve - Reheat position |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Heating coil | Hot water coil - Two-way modulating valve - Preheat position |
| Cooling coil | Chilled water coil - Two-way modulating valve |
| Controller | Guideline 36 controller - Return fan with airflow tracking control |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Heating coil | Hot water coil - Two-way modulating valve - Preheat position |
| Cooling coil | Chilled water coil - Two-way modulating valve |
| Controller | Guideline 36 controller - Return fan with building pressure control |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Outdoor air section | Separate dedicated OA dampers with differential pressure sensor |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Relief/return air section | Relief fan with two-position relief damper |
| Return fan | No fan |
| Relief fan | Single fan - Variable speed |
+This is a configuration model with the same default options as
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+except for the following options.
+
| Component | Configuration |
|---|---|
| Supply fan | Single fan - Variable speed - Blow-through position |
+This package contains models used for validation purposes. +
+")); +end AirHandlersFans; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/AirHandlersFans/package.order b/Buildings/Templates/AirHandlersFans/Validation/UserProject/AirHandlersFans/package.order new file mode 100644 index 00000000000..26399a7d0a3 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/AirHandlersFans/package.order @@ -0,0 +1,10 @@ +VAVMZBase +VAVMZCoilElectricHeating +VAVMZCoilEvaporatorMultiStage +VAVMZCoilEvaporatorVariable +VAVMZCoilWaterHeating3WVReheat +VAVMZControlG36Airflow +VAVMZControlG36Pressure +VAVMZDedicatedDampersPressure +VAVMZFanRelief +VAVMZFanSupplyBlowThrough diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/AllSystems.mo b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/AllSystems.mo new file mode 100644 index 00000000000..7f5ee5c2e4f --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/AllSystems.mo @@ -0,0 +1,110 @@ +within Buildings.Templates.AirHandlersFans.Validation.UserProject.Data; +class AllSystems "Top-level (whole building) system parameters" + extends Buildings.Templates.Data.AllSystems; + + /* + The construct below where a replaceable model is used inside the `outer` + component declaration is for validation purposes only, where various configuration + classes are tested with the same instance name `VAV_1`. + It is needed here because + - the `inner` instance must be a subtype of the `outer` component, and + - the `outer` component references only the subcomponents from its own type + (as opposed to all the subcomponents from the `inner` type), and + - modification of an outer declaration is prohibited. + The standard export workflow should use an explicit reference to the configuration + class for each MZVAV model instance. + */ + replaceable model VAV = + Buildings.Templates.AirHandlersFans.Interfaces.PartialAirHandler + "Model of MZVAV"; + + outer VAV VAV_1 + "Instance of MZVAV model"; + + parameter Buildings.Templates.AirHandlersFans.Data.VAVMultiZone dat_VAV_1( + final typ=VAV_1.typ, + final typFanSup=VAV_1.typFanSup, + final typFanRet=VAV_1.typFanRet, + final typFanRel=VAV_1.typFanRel, + final have_souChiWat=VAV_1.have_souChiWat, + final have_souHeaWat=VAV_1.have_souHeaWat, + final typCoiHeaPre=VAV_1.coiHeaPre.typ, + final typCoiCoo=VAV_1.coiCoo.typ, + final typCoiHeaReh=VAV_1.coiHeaReh.typ, + final typValCoiHeaPre=VAV_1.coiHeaPre.typVal, + final typValCoiCoo=VAV_1.coiCoo.typVal, + final typValCoiHeaReh=VAV_1.coiHeaReh.typVal, + final typDamOut=VAV_1.secOutRel.typDamOut, + final typDamOutMin=VAV_1.secOutRel.typDamOutMin, + final typDamRet=VAV_1.secOutRel.typDamRet, + final typDamRel=VAV_1.secOutRel.typDamRel, + final typCtl=VAV_1.ctl.typ, + final typSecOut=VAV_1.ctl.typSecOut, + final buiPreCon=VAV_1.ctl.buiPreCon, + final stdVen=VAV_1.ctl.stdVen, + id="VAV_1", + damOut(dp_nominal=15), + damOutMin(dp_nominal=15), + damRel(dp_nominal=15), + damRet(dp_nominal=15), + mOutMin_flow_nominal=0.2, + fanSup(m_flow_nominal=1, dp_nominal=500), + fanRel(m_flow_nominal=1, dp_nominal=200), + fanRet(m_flow_nominal=1, dp_nominal=200), + coiHeaPre( + cap_nominal=1e4, + dpAir_nominal=100, + dpWat_nominal=0.5e4, + dpValve_nominal=0.3e4, + mWat_flow_nominal=1e4/4186/10, + TAirEnt_nominal=273.15, + TWatEnt_nominal=50 + 273.15), + coiHeaReh( + cap_nominal=1e4, + dpAir_nominal=100, + dpWat_nominal=0.5e4, + dpValve_nominal=0.3e4, + mWat_flow_nominal=1e4/4186/10, + TAirEnt_nominal=273.15, + TWatEnt_nominal=50 + 273.15), + coiCoo( + cap_nominal=1e4, + dpAir_nominal=100, + dpWat_nominal=3e4, + dpValve_nominal=2e4, + mWat_flow_nominal=1e4/4186/5, + TAirEnt_nominal=30 + 273.15, + TWatEnt_nominal=7 + 273.15, + wAirEnt_nominal=0.012), + ctl( + VOutUnc_flow_nominal=0.4, + VOutTot_flow_nominal=0.5, + VOutAbsMin_flow_nominal=0.3, + VOutMin_flow_nominal=0.4, + dpDamOutMinAbs=10, + dpDamOutMin_nominal=15, + pAirSupSet_rel_max=500, + pAirRetSet_rel_min=10, + pAirRetSet_rel_max=40, + yFanSup_min=0.1, + yFanRel_min=0.1, + yFanRet_min=0.1, + dVFanRet_flow=0.1, + TAirSupSet_min=12+273.15, + TAirSupSet_max=18+273.15, + TOutRes_min=16+273.15, + TOutRes_max=21+273.15)) + "Parameters for system VAV_1" + annotation (Dialog(group="Air handlers and fans")); + +annotation ( + defaultComponentPrefixes = "inner parameter", + defaultComponentName = "datAll", + Documentation(info=" ++This class provides the set of sizing and operating parameters for +the whole HVAC system. +It is aimed for validation purposes only. +
+")); +end AllSystems; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.mo b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.mo new file mode 100644 index 00000000000..2ad36748e54 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.AirHandlersFans.Validation.UserProject; +package Data "Package with classes for storing system parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + +annotation (Documentation(info=" ++This package provides records for design and operating parameters +that are used for validation purposes. +
+")); +end Data; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.order b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.order new file mode 100644 index 00000000000..3831742ec60 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/Data/package.order @@ -0,0 +1 @@ +AllSystems diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/VAVBoxControlPoints.mo b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/VAVBoxControlPoints.mo new file mode 100644 index 00000000000..2bd0aa1a9cd --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/VAVBoxControlPoints.mo @@ -0,0 +1,116 @@ +within Buildings.Templates.AirHandlersFans.Validation.UserProject.ZoneEquipment; +block VAVBoxControlPoints "Emulation of VAV box control points" + extends Modelica.Blocks.Icons.Block; + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen + "Ventilation standard" + annotation(Evaluate=true); + + Buildings.Templates.ZoneEquipment.Interfaces.Bus bus + "Terminal unit control bus" + annotation (Placement(transformation( + extent={{-20,20},{20,-20}}, + rotation=90, + origin={200,0}), iconTransformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={100,0}))); + + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant tNexOcc(final k=3600) + "Time next occupancy" + annotation (Placement(transformation(extent={{-140,130},{-120,150}}))); + + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant VAirDis_flow(final k=1) + annotation (Placement(transformation(extent={{-140,-50},{-120,-30}}))); + Buildings.Controls.OBC.CDL.Integers.Sources.Constant yReqZonTemRes(final k=1) + "Request" + annotation (Placement(transformation(extent={{-140,-110},{-120,-90}}))); + Buildings.Controls.OBC.CDL.Integers.Sources.Constant yReqZonPreRes(final k=1) + "Request" + annotation (Placement(transformation(extent={{-140,-150},{-120,-130}}))); + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant TAirDis(final k=303.15) + "Discharge temperature" + annotation (Placement(transformation(extent={{-140,30},{-120,50}}))); + + Controls.OBC.CDL.Integers.Sources.Constant uOpeMod( + k=Buildings.Controls.OBC.ASHRAE.G36.Types.OperationModes.occupied) + "Operating mode" + annotation (Placement(transformation(extent={{40,10},{60,30}}))); + Buildings.Controls.OBC.ASHRAE.G36.ZoneGroups.ZoneStatus sta + "Evaluate zone temperature status" + annotation (Placement(transformation(extent={{100,-74},{120,-46}}))); + Controls.OBC.CDL.Continuous.Sources.Constant cooDowTim(final k=1800) + "Cooling down time" + annotation (Placement(transformation(extent={{40,-50},{60,-30}}))); + Controls.OBC.CDL.Continuous.Sources.Constant warUpTim(final k=1800) + "Warm-up time" + annotation (Placement(transformation(extent={{40,-90},{60,-70}}))); + Controls.OBC.ASHRAE.G36.VentilationZones.Title24.Setpoints setMinOA_T24( + VOccMin_flow=2.5e-3, + VAreMin_flow=3e-3, + VMin_flow=5e-3) if stdVen== + Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24 + "Zone level calculation of the minimum outdoor airflow setpoint" + annotation (Placement(transformation(extent={{100,-20},{120,0}}))); + Buildings.Controls.OBC.ASHRAE.G36.VentilationZones.ASHRAE62_1.Setpoints setMinOA_62_1( + VAreBreZon_flow=3e-3, + VPopBreZon_flow=2.5e-3, + VMin_flow=5.5e-3) if stdVen== + Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1 + "Zone level calculation of the minimum outdoor airflow setpoint" + annotation (Placement(transformation(extent={{100,20},{120,40}}))); +equation + connect(tNexOcc.y, bus.tNexOcc); + connect(TAirDis.y, bus.TAirDis); + connect(VAirDis_flow.y, bus.VAirDis_flow); + connect(yReqZonTemRes.y, bus.yReqZonTemRes); + connect(yReqZonPreRes.y, bus.yReqZonPreRes); + + connect(bus.y1Win, setMinOA_62_1.u1Win); + connect(bus.TZon, setMinOA_62_1.TZon); + connect(bus.TAirDis, setMinOA_62_1.TDis); + + connect(setMinOA_62_1.VAdjPopBreZon_flow, bus.VAdjPopBreZon_flow); + connect(setMinOA_62_1.VOccZonMin_flow, bus.VOccZonMin_flow); + connect(setMinOA_62_1.VAdjAreBreZon_flow, bus.VAdjAreBreZon_flow); + connect(setMinOA_62_1.VMinOA_flow, bus.VMinOA_flow); + + connect(setMinOA_T24.VZonAbsMin_flow, bus.VZonAbsMin_flow); + connect(setMinOA_T24.VZonDesMin_flow, bus.VZonDesMin_flow); + connect(setMinOA_T24.VOccZonMin_flow, bus.VOccZonMin_flow); + connect(setMinOA_T24.yCO2, bus.yCO2); + connect(setMinOA_T24.VMinOA_flow, bus.VMinOA_flow); + + connect(cooDowTim.y, sta.cooDowTim); + connect(warUpTim.y, sta.warUpTim); + connect(bus.u1Win, sta.u1Win); + connect(bus.TZon, sta.TZon); + connect(bus.TZonHeaOccSet, sta.TOccHeaSet); + connect(bus.TZonCooOccSet, sta.TOccCooSet); + connect(bus.TZonHeaUnoSet, sta.TUnoHeaSet); + connect(bus.TZonCooUnoSet, sta.TUnoCooSet); + + connect(sta.yCooTim, bus.yCooTim); + connect(sta.yWarTim, bus.yWarTim); + connect(sta.yOccHeaHig, bus.yOccHeaHig); + connect(sta.yHigOccCoo, bus.yHigOccCoo); + connect(sta.yUnoHeaHig, bus.yUnoHeaHig); + connect(sta.yEndSetBac, bus.yEndSetBac); + connect(sta.yHigUnoCoo, bus.yHigUnoCoo); + connect(sta.yEndSetUp, bus.yEndSetUp); + + connect(uOpeMod.y, setMinOA_62_1.uOpeMod) annotation (Line(points={{62,20},{80, + 20},{80,35},{98,35}}, color={255,127,0})); + annotation ( + defaultComponentName="conPoiDum", + Icon(coordinateSystem(preserveAspectRatio=false, extent={{-100,-100}, + {100,100}})), Diagram(coordinateSystem(preserveAspectRatio= + false, extent={{-200,-180},{200,180}})), + Documentation(info=" ++This class generates signals typically provided by the terminal +unit controller. +It is aimed for validation purposes only. +
+")); +end VAVBoxControlPoints; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.mo b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.mo new file mode 100644 index 00000000000..6a04fc9bac6 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.mo @@ -0,0 +1,8 @@ +within Buildings.Templates.AirHandlersFans.Validation.UserProject; +package ZoneEquipment "Zone equipment" +annotation (Documentation(info=" ++This package contains models used for validation purposes. +
+")); +end ZoneEquipment; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.order b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.order new file mode 100644 index 00000000000..2fe1821bfb4 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/ZoneEquipment/package.order @@ -0,0 +1 @@ +VAVBoxControlPoints diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.mo b/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.mo new file mode 100644 index 00000000000..b1f1b846f2d --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.AirHandlersFans.Validation; +package UserProject "Package with configured models" + extends Modelica.Icons.VariantsPackage; + + +annotation (Documentation(info=" ++This package contains models used for validation purposes. +
+")); +end UserProject; diff --git a/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.order b/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.order new file mode 100644 index 00000000000..fceaa312fe3 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/UserProject/package.order @@ -0,0 +1,3 @@ +AirHandlersFans +ZoneEquipment +Data diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZBase.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZBase.mo new file mode 100644 index 00000000000..b5bfcaa39fc --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZBase.mo @@ -0,0 +1,181 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZBase + "Validation model for multiple-zone VAV - Base model with open loop controls" + extends Modelica.Icons.Example; + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + replaceable package MediumChiWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Cooling medium (such as CHW)"; + replaceable package MediumHeaWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Heating medium (such as HHW)"; + + inner parameter UserProject.Data.AllSystems datAll( + sysUni=Buildings.Templates.Types.Units.SI, + redeclare replaceable model VAV = UserProject.AirHandlersFans.VAVMZBase, + stdEne=Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard.ASHRAE90_1, + stdVen=Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1, + ashCliZon=Buildings.Controls.OBC.ASHRAE.G36.Types.ASHRAEClimateZone.Zone_3B) + "Design and operating parameters" + annotation (Placement(transformation(extent={{90,92},{110,112}}))); + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.FixedInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, + Dialog(tab = "Dynamics", group="Conservation equations")); + + inner replaceable UserProject.AirHandlersFans.VAVMZBase VAV_1 constrainedby + Buildings.Templates.AirHandlersFans.VAVMultiZone( + final dat=datAll.dat_VAV_1, + redeclare final package MediumAir = MediumAir, + redeclare final package MediumChiWat = MediumChiWat, + final energyDynamics=energyDynamics) + "Air handling unit" + annotation (Placement(transformation(extent={{-20,-50},{20,-10}}))); + Buildings.Fluid.Sources.Boundary_pT bouOut( + redeclare final package Medium =MediumAir, + nPorts=2) + "Boundary conditions for outdoor environment" + annotation (Placement(transformation(extent={{-100,-40},{-80,-20}}))); + Buildings.Fluid.Sources.Boundary_pT bouBui( + redeclare final package Medium =MediumAir, + nPorts=3) + "Boundary conditions for indoor environment" + annotation (Placement(transformation(extent={{90,-40},{70,-20}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium=MediumAir, + m_flow_nominal=1, dp_nominal=100) + annotation (Placement(transformation(extent={{-50,-50},{-30,-30}}))); + Fluid.FixedResistances.PressureDrop res1( + redeclare final package Medium = MediumAir, + m_flow_nominal=1, + dp_nominal=100) + annotation (Placement(transformation(extent={{30,-50},{50,-30}}))); + Fluid.Sensors.Pressure pBui(redeclare final package Medium = MediumAir) + "Building absolute pressure in representative space" + annotation (Placement(transformation(extent={{80,0},{60,20}}))); + BoundaryConditions.WeatherData.ReaderTMY3 weaDat(filNam= + Modelica.Utilities.Files.loadResource( + "modelica://Buildings/Resources/weatherdata/USA_IL_Chicago-OHare.Intl.AP.725300_TMY3.mos")) + annotation (Placement(transformation(extent={{-100,-10},{-80,10}}))); + Fluid.FixedResistances.PressureDrop res2( + redeclare final package Medium = MediumAir, + m_flow_nominal=1, + dp_nominal=100) + annotation (Placement(transformation(extent={{-30,-30},{-50,-10}}))); + Fluid.FixedResistances.PressureDrop res3( + redeclare final package Medium = MediumAir, + m_flow_nominal=1, + dp_nominal=100) + annotation (Placement(transformation(extent={{50,-30},{30,-10}}))); + Fluid.Sources.Boundary_pT bouHeaWat( + redeclare final package Medium = MediumHeaWat, + nPorts=2) if VAV_1.have_souHeaWat + "Boundary conditions for HHW distribution system" + annotation (Placement(transformation(extent={{-100,-80},{-80,-60}}))); + Fluid.Sources.Boundary_pT bouChiWat( + redeclare final package Medium = MediumChiWat, + nPorts=2) if VAV_1.have_souChiWat + "Boundary conditions for CHW distribution system" + annotation (Placement(transformation(extent={{-100,-110},{-80,-90}}))); + UserProject.ZoneEquipment.VAVBoxControlPoints sigVAVBox[VAV_1.nZon]( + each final stdVen=datAll.stdVen) + if VAV_1.ctl.typ==Buildings.Templates.AirHandlersFans.Types.Controller.G36VAVMultiZone + "Control signals from VAV box" + annotation (Placement(transformation(extent={{-100,20},{-80,40}}))); + ZoneEquipment.Validation.UserProject.BASControlPoints sigBAS( + final nZon=VAV_1.nZon) + "BAS control points" + annotation (Placement(transformation(extent={{-100,80},{-80,100}}))); + ZoneEquipment.Validation.UserProject.ZoneControlPoints sigZon[VAV_1.nZon] + "Zone control points" + annotation (Placement(transformation(extent={{-100,50},{-80,70}}))); +protected + Interfaces.Bus busAHU + "Gateway bus" + annotation ( + Placement( + transformation(extent={{-40,-10},{0,30}}),iconTransformation( + extent={{-258,-26},{-238,-6}}))); + +equation + connect(bouHeaWat.ports[1], VAV_1.port_aHeaWat) + annotation (Line(points={{-80,-71},{-5,-71},{-5,-50}}, color={0,127,255})); + connect(bouChiWat.ports[2], VAV_1.port_bChiWat) + annotation (Line(points={{-80,-99},{5,-99},{5,-50}}, color={0,127,255})); + connect(VAV_1.port_bHeaWat, bouHeaWat.ports[2]) annotation (Line(points={{-13,-50}, + {-13,-68},{-80,-68},{-80,-69}}, color={0,127,255})); + connect(VAV_1.port_aChiWat, bouChiWat.ports[1]) annotation (Line(points={{13,-50}, + {13,-102},{-80,-102},{-80,-101}}, + color={0,127,255})); + connect(bouOut.ports[1], res.port_a) annotation (Line(points={{-80,-31},{-60, + -31},{-60,-40},{-50,-40}}, + color={0,127,255})); + connect(res.port_b, VAV_1.port_Out) + annotation (Line(points={{-30,-40},{-20,-40}}, color={0,127,255})); + connect(VAV_1.port_Sup, res1.port_a) + annotation (Line(points={{20,-40},{30,-40}}, color={0,127,255})); + connect(res1.port_b, bouBui.ports[1]) annotation (Line(points={{50,-40},{60, + -40},{60,-31.3333},{70,-31.3333}}, + color={0,127,255})); + connect(bouBui.ports[2], pBui.port) + annotation (Line(points={{70,-30},{70,0}}, color={0,127,255})); + connect(weaDat.weaBus, VAV_1.busWea) annotation (Line( + points={{-80,0},{0,0},{0,-10}}, + color={255,204,51}, + thickness=0.5)); + connect(busAHU, VAV_1.bus) annotation (Line( + points={{-20,10},{-20,-14},{-19.9,-14}}, + color={255,204,51}, + thickness=0.5)); + connect(VAV_1.port_Rel, res2.port_a) + annotation (Line(points={{-20,-20},{-30,-20}}, + color={0,127,255})); + connect(res2.port_b, bouOut.ports[2]) annotation (Line(points={{-50,-20},{-60, + -20},{-60,-29},{-80,-29}}, + color={0,127,255})); + connect(VAV_1.port_Ret, res3.port_b) + annotation (Line(points={{20,-20},{30,-20}}, + color={0,127,255})); + connect(res3.port_a, bouBui.ports[3]) annotation (Line(points={{50,-20},{60, + -20},{60,-28.6667},{70,-28.6667}}, + color={0,127,255})); + connect(pBui.p, busAHU.pBui) annotation (Line(points={{59,10},{-20,10}}, + color={0,0,127}), Text( + string="%second", + index=1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + connect(sigVAVBox.bus, VAV_1.busTer) annotation (Line( + points={{-80,30},{19.8,30},{19.8,-14}}, + color={255,204,51}, + thickness=0.5)); + + connect(sigBAS.busTer, VAV_1.busTer) annotation (Line( + points={{-80,90},{19.8,90},{19.8,-14}}, + color={255,204,51}, + thickness=0.5)); + connect(sigZon.bus, VAV_1.busTer) annotation (Line( + points={{-80,60},{19.8,60},{19.8,-14}}, + color={255,204,51}, + thickness=0.5)); + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZBase.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZBase. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+"), + Diagram(coordinateSystem(extent={{-120,-120},{120,120}}))); +end VAVMZBase; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilElectricHeating.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilElectricHeating.mo new file mode 100644 index 00000000000..05489522f95 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilElectricHeating.mo @@ -0,0 +1,24 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZCoilElectricHeating "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll(redeclare model VAV = + UserProject.AirHandlersFans.VAVMZCoilElectricHeating), + redeclare + UserProject.AirHandlersFans.VAVMZCoilElectricHeating VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZCoilElectricHeating.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZCoilElectricHeating. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZCoilElectricHeating; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorMultiStage.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorMultiStage.mo new file mode 100644 index 00000000000..66260e59974 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorMultiStage.mo @@ -0,0 +1,28 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZCoilEvaporatorMultiStage "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZCoilEvaporatorMultiStage, + dat_VAV_1(coiCoo(redeclare + Buildings.Fluid.DXSystems.Cooling.AirSource.Data.DoubleSpeed.Lennox_SCA240H4B + datCoi))), + redeclare + UserProject.AirHandlersFans.VAVMZCoilEvaporatorMultiStage VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorMultiStage.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZCoilEvaporatorMultiStage. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZCoilEvaporatorMultiStage; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorVariable.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorVariable.mo new file mode 100644 index 00000000000..b3c9987849d --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorVariable.mo @@ -0,0 +1,24 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZCoilEvaporatorVariable "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZCoilEvaporatorVariable), + redeclare UserProject.AirHandlersFans.VAVMZCoilEvaporatorVariable VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZCoilEvaporatorVariable.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZCoilEvaporatorVariable. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZCoilEvaporatorVariable; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilWaterHeating3WVReheat.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilWaterHeating3WVReheat.mo new file mode 100644 index 00000000000..f632c559322 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZCoilWaterHeating3WVReheat.mo @@ -0,0 +1,24 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZCoilWaterHeating3WVReheat "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZCoilWaterHeating3WVReheat), + redeclare UserProject.AirHandlersFans.VAVMZCoilWaterHeating3WVReheat VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZCoilWaterHeating3WVReheat.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZCoilWaterHeating3WVReheat. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZCoilWaterHeating3WVReheat; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Airflow.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Airflow.mo new file mode 100644 index 00000000000..39fe7bb9555 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Airflow.mo @@ -0,0 +1,21 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZControlG36Airflow "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll(redeclare model VAV = + UserProject.AirHandlersFans.VAVMZControlG36Airflow), + redeclare UserProject.AirHandlersFans.VAVMZControlG36Airflow VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZControlG36Airflow.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=10000), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZControlG36Airflow. +It is intended to check whether the template model is well-defined for +this particular system configuration. +
+")); +end VAVMZControlG36Airflow; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Pressure.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Pressure.mo new file mode 100644 index 00000000000..0f14e2881b5 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZControlG36Pressure.mo @@ -0,0 +1,22 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZControlG36Pressure + "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll(redeclare model VAV = + UserProject.AirHandlersFans.VAVMZControlG36Pressure), + redeclare UserProject.AirHandlersFans.VAVMZControlG36Pressure VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZControlG36Pressure.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=10000), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZControlG36Pressure. +It is intended to check whether the template model is well-defined for +this particular system configuration. +
+")); +end VAVMZControlG36Pressure; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZDedicatedDampersPressure.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZDedicatedDampersPressure.mo new file mode 100644 index 00000000000..4fe88738898 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZDedicatedDampersPressure.mo @@ -0,0 +1,24 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZDedicatedDampersPressure "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZDedicatedDampersPressure), + redeclare UserProject.AirHandlersFans.VAVMZDedicatedDampersPressure VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZDedicatedDampersPressure.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZDedicatedDampersPressure. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZDedicatedDampersPressure; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanRelief.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanRelief.mo new file mode 100644 index 00000000000..749111ec6b0 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanRelief.mo @@ -0,0 +1,25 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZFanRelief "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZFanRelief), + redeclare + UserProject.AirHandlersFans.VAVMZFanRelief VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZFanRelief.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZFanRelief. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZFanRelief; diff --git a/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanSupplyBlowThrough.mo b/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanSupplyBlowThrough.mo new file mode 100644 index 00000000000..c8149489f49 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/VAVMZFanSupplyBlowThrough.mo @@ -0,0 +1,24 @@ +within Buildings.Templates.AirHandlersFans.Validation; +model VAVMZFanSupplyBlowThrough "Validation model for multiple-zone VAV" + extends VAVMZBase( + datAll( + redeclare model VAV = + UserProject.AirHandlersFans.VAVMZFanSupplyBlowThrough), + redeclare UserProject.AirHandlersFans.VAVMZFanSupplyBlowThrough VAV_1); + + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/AirHandlersFans/Validation/VAVMZFanSupplyBlowThrough.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans.VAVMZFanSupplyBlowThrough. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+")); +end VAVMZFanSupplyBlowThrough; diff --git a/Buildings/Templates/AirHandlersFans/Validation/package.mo b/Buildings/Templates/AirHandlersFans/Validation/package.mo new file mode 100644 index 00000000000..351edd40126 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/package.mo @@ -0,0 +1,26 @@ +within Buildings.Templates.AirHandlersFans; +package Validation "Package with validation models" + extends Modelica.Icons.ExamplesPackage; + + annotation ( + preferredView="info", + Documentation(info=" ++This package contains models validating the templates within + +Buildings.Templates.AirHandlersFans +for various system configurations. +
++Each system configuration is specified by extending the original template class +to create a so-called configuration class (under + +Buildings.Templates.AirHandlersFans.Validation.UserProject.AirHandlersFans), +that is instantiated in the validation model. +
++The models also illustrate parameter propagation from a top-level +HVAC system record. +
+")); +end Validation; diff --git a/Buildings/Templates/AirHandlersFans/Validation/package.order b/Buildings/Templates/AirHandlersFans/Validation/package.order new file mode 100644 index 00000000000..ef10535e0c8 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/Validation/package.order @@ -0,0 +1,11 @@ +VAVMZBase +VAVMZCoilElectricHeating +VAVMZCoilEvaporatorMultiStage +VAVMZCoilEvaporatorVariable +VAVMZCoilWaterHeating3WVReheat +VAVMZControlG36Airflow +VAVMZControlG36Pressure +VAVMZDedicatedDampersPressure +VAVMZFanRelief +VAVMZFanSupplyBlowThrough +UserProject diff --git a/Buildings/Templates/AirHandlersFans/package.mo b/Buildings/Templates/AirHandlersFans/package.mo new file mode 100644 index 00000000000..ecce01041c4 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates; +package AirHandlersFans "Air handlers and fans" + extends Modelica.Icons.Package; + + annotation (Documentation(info=" ++This package contains templates for air handlers and fans. +
+")); +end AirHandlersFans; diff --git a/Buildings/Templates/AirHandlersFans/package.order b/Buildings/Templates/AirHandlersFans/package.order new file mode 100644 index 00000000000..0aab08bf782 --- /dev/null +++ b/Buildings/Templates/AirHandlersFans/package.order @@ -0,0 +1,6 @@ +VAVMultiZone +Components +Data +Types +Validation +Interfaces diff --git a/Buildings/Templates/Components/Coils/ElectricHeating.mo b/Buildings/Templates/Components/Coils/ElectricHeating.mo new file mode 100644 index 00000000000..d164cc58b10 --- /dev/null +++ b/Buildings/Templates/Components/Coils/ElectricHeating.mo @@ -0,0 +1,38 @@ +within Buildings.Templates.Components.Coils; +model ElectricHeating "Modulating electric heating coil" + extends Buildings.Templates.Components.Interfaces.PartialCoil( + final typ=Buildings.Templates.Components.Types.Coil.ElectricHeating, + final typVal=Buildings.Templates.Components.Types.Valve.None); + + Buildings.Fluid.HeatExchangers.HeaterCooler_u hex( + redeclare final package Medium = MediumAir, + final Q_flow_nominal=dat.Q_flow_nominal, + final m_flow_nominal=dat.mAir_flow_nominal, + final dp_nominal=dat.dpAir_nominal, + final energyDynamics=energyDynamics, + final tau=tau, + final allowFlowReversal=allowFlowReversalAir, + final show_T=show_T) + "Heat exchanger" + annotation (Placement(transformation(extent={{-10,-10},{10,10}}))); +equation + connect(port_a, hex.port_a) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(hex.port_b, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(bus.y, hex.u) annotation (Line( + points={{0,100},{0,20},{-20,20},{-20,6},{-12,6}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + annotation (Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is a model for a modulating electric heating coil. +
+")); +end ElectricHeating; diff --git a/Buildings/Templates/Components/Coils/EvaporatorMultiStage.mo b/Buildings/Templates/Components/Coils/EvaporatorMultiStage.mo new file mode 100644 index 00000000000..6b776830a48 --- /dev/null +++ b/Buildings/Templates/Components/Coils/EvaporatorMultiStage.mo @@ -0,0 +1,70 @@ +within Buildings.Templates.Components.Coils; +model EvaporatorMultiStage + "Evaporator coil with multi-stage compressor" + extends Buildings.Templates.Components.Interfaces.PartialCoil( + final typ=Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage, + final typVal=Buildings.Templates.Components.Types.Valve.None); + + parameter Boolean have_dryCon = true + "Set to true for air-cooled condenser, false for evaporative condenser"; + + Buildings.Fluid.DXSystems.Cooling.AirSource.MultiStage hex( + redeclare final package Medium = MediumAir, + final datCoi=dat.datCoi, + final dp_nominal=dpAir_nominal, + final energyDynamics=energyDynamics, + final tau=tau, + final allowFlowReversal=allowFlowReversalAir, + final show_T=show_T) + "Heat exchanger" + annotation (Placement(transformation(extent={{-10,-10},{10,10}}))); + + Modelica.Blocks.Routing.RealPassThrough TWetBul if not have_dryCon + annotation (Placement(transformation(extent={{-50,50},{-30,70}}))); + Modelica.Blocks.Routing.RealPassThrough TDry if have_dryCon + annotation (Placement(transformation(extent={{-50,10},{-30,30}}))); +equation + connect(port_a, hex.port_a) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(hex.port_b, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(busWea.TWetBul, TWetBul.u) annotation (Line( + points={{-60,100},{-60,60},{-52,60}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + connect(busWea.TDryBul, TDry.u) annotation (Line( + points={{-60,100},{-60,20},{-52,20}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + connect(TWetBul.y, hex.TOut) annotation (Line(points={{-29,60},{-20,60},{-20,3}, + {-11,3}}, color={0,0,127})); + connect(TDry.y, hex.TOut) annotation (Line(points={{-29,20},{-20,20},{-20,3}, + {-11,3}}, color={0,0,127})); + connect(bus.y, hex.stage) annotation (Line( + points={{0,100},{0,20},{-14,20},{-14,8},{-11,8}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + annotation ( + Diagram( + coordinateSystem(preserveAspectRatio=false)), Documentation(info=" +
+This is a model for a direct expansion cooling coil with a
+multi-stage compressor.
+The compressor stage is selected with the control
+signal y (integer between 0 and the number
+of stages).
+
+This is a model for a direct expansion cooling coil with a
+variable speed compressor.
+The compressor speed is modulated with the fractional speed
+signal y (real between 0 and 1).
+
+This is a direct fluid pass-through model to represent +a configuration with no coil. +
+")); +end None; diff --git a/Buildings/Templates/Components/Coils/WaterBasedCooling.mo b/Buildings/Templates/Components/Coils/WaterBasedCooling.mo new file mode 100644 index 00000000000..b590090b630 --- /dev/null +++ b/Buildings/Templates/Components/Coils/WaterBasedCooling.mo @@ -0,0 +1,132 @@ +within Buildings.Templates.Components.Coils; +model WaterBasedCooling "Chilled water coil" + extends Buildings.Templates.Components.Interfaces.PartialCoil( + final typ=Buildings.Templates.Components.Types.Coil.WaterBasedCooling, + final typVal=val.typ, + redeclare final package MediumSou = MediumChiWat); + + replaceable package MediumChiWat=Buildings.Media.Water + "Source side medium"; + + final parameter Modelica.Units.SI.MassFlowRate mWat_flow_nominal= + dat.mWat_flow_nominal + "Liquid mass flow rate"; + final parameter Modelica.Units.SI.PressureDifference dpWat_nominal= + dat.dpWat_nominal + "Liquid pressure drop across coil"; + final parameter Modelica.Units.SI.PressureDifference dpValve_nominal= + dat.dpValve_nominal + "Nominal pressure drop across fully open valve"; + + replaceable Buildings.Templates.Components.Valves.TwoWayModulating val constrainedby + Buildings.Templates.Components.Interfaces.PartialValve( + redeclare final package Medium = MediumChiWat, + final energyDynamics=energyDynamics, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversalLiq, + final show_T=show_T, + final dat=datVal) + "Valve" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Valves.ThreeWayModulating val + "Three-way modulating valve"), + choice(redeclare replaceable Buildings.Templates.Components.Valves.TwoWayModulating val + "Two-way modulating valve")), + Placement(transformation(extent={{-10,10},{10,-10}}, + rotation=-90, + origin={-40,-60}))); + + replaceable Buildings.Fluid.HeatExchangers.WetCoilEffectivenessNTU hex( + configuration=Buildings.Fluid.Types.HeatExchangerConfiguration.CounterFlow, + final use_Q_flow_nominal=true, + final Q_flow_nominal=Q_flow_nominal, + final T_a1_nominal=dat.TWatEnt_nominal, + final T_a2_nominal=dat.TAirEnt_nominal, + final w_a2_nominal=dat.wAirEnt_nominal, + final dp1_nominal=if val.typ==Buildings.Templates.Components.Types.Valve.None + then dpWat_nominal else 0, + final dp2_nominal=dpAir_nominal) + constrainedby Buildings.Fluid.Interfaces.PartialFourPortInterface( + redeclare final package Medium1 = MediumChiWat, + redeclare final package Medium2 = MediumAir, + final m1_flow_nominal=mWat_flow_nominal, + final m2_flow_nominal=mAir_flow_nominal, + final allowFlowReversal1=allowFlowReversalLiq, + final allowFlowReversal2=allowFlowReversalAir, + final show_T=show_T) + "Heat exchanger" + annotation ( + __ctrl_flow(enable=false), + Placement(transformation(extent={{10,4},{-10,-16}}))); + + Buildings.Fluid.FixedResistances.Junction jun( + redeclare final package Medium = MediumChiWat, + final m_flow_nominal=mWat_flow_nominal*{1,-1,-1}, + energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial, + dp_nominal=fill(0, 3), + final portFlowDirection_1=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering, + final portFlowDirection_2=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving, + final portFlowDirection_3=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving) + if typVal==Buildings.Templates.Components.Types.Valve.ThreeWayModulating + "Junction" + annotation ( + Placement(transformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={40,-60}))); + Buildings.Templates.Components.Routing.PassThroughFluid pas( + redeclare final package Medium = MediumChiWat, + final allowFlowReversal=allowFlowReversalLiq) + if typVal <> Buildings.Templates.Components.Types.Valve.ThreeWayModulating + "Direct pass through" annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=90, + origin={60,-60}))); +equation + connect(port_a,hex. port_a2) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(hex.port_b2, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(val.port_a, hex.port_b1) annotation (Line(points={{-40,-50},{-40,-12}, + {-10,-12}}, color={0,127,255})); + connect(val.port_b, port_bSou) + annotation (Line(points={{-40,-70},{-40,-100}}, color={0,127,255})); + connect(val.portByp_a, jun.port_3) + annotation (Line(points={{-30,-60},{30,-60}}, color={0,127,255})); + connect(jun.port_2, hex.port_a1) + annotation (Line(points={{40,-50},{40,-12},{10,-12}}, color={0,127,255})); + connect(port_aSou, jun.port_1) + annotation (Line(points={{40,-100},{40,-70}}, color={0,127,255})); + connect(port_aSou, pas.port_a) annotation (Line(points={{40,-100},{40,-80},{60, + -80},{60,-70}}, color={0,127,255})); + connect(pas.port_b, hex.port_a1) + annotation (Line(points={{60,-50},{60,-12},{10,-12}}, color={0,127,255})); + connect(val.bus, bus) annotation (Line( + points={{-50,-60},{-60,-60},{-60,20},{0,20},{0,100}}, + color={255,204,51}, + thickness=0.5), Text( + string="%second", + index=1, + extent={{-6,3},{-6,3}}, + horizontalAlignment=TextAlignment.Right)); + annotation ( + Icon( + coordinateSystem(preserveAspectRatio=false)), Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" +
+This is a model for a chilled water coil with an optional
+modulating valve.
+The valve position is modulated with the fractional opening
+signal y (real between 0 and 1).
+If no valve is used, no signal is required.
+
+This is a model for a hot water coil with an optional
+modulating valve.
+The valve position is modulated with the fractional opening
+signal y (real between 0 and 1).
+If no valve is used, no signal is required.
+
+This package contains models for heating and cooling coils. +
+")); +end Coils; diff --git a/Buildings/Templates/Components/Coils/package.order b/Buildings/Templates/Components/Coils/package.order new file mode 100644 index 00000000000..7701041b9a7 --- /dev/null +++ b/Buildings/Templates/Components/Coils/package.order @@ -0,0 +1,6 @@ +ElectricHeating +EvaporatorMultiStage +EvaporatorVariableSpeed +None +WaterBasedCooling +WaterBasedHeating diff --git a/Buildings/Templates/Components/Dampers/Modulating.mo b/Buildings/Templates/Components/Dampers/Modulating.mo new file mode 100644 index 00000000000..fcd9854cd17 --- /dev/null +++ b/Buildings/Templates/Components/Dampers/Modulating.mo @@ -0,0 +1,53 @@ +within Buildings.Templates.Components.Dampers; +model Modulating "Modulating damper" + extends Buildings.Templates.Components.Interfaces.PartialDamper( + final typ=Buildings.Templates.Components.Types.Damper.Modulating, + typBla=Buildings.Templates.Components.Types.DamperBlades.Parallel); + + Buildings.Fluid.Actuators.Dampers.Exponential dam( + redeclare final package Medium = Medium, + final m_flow_nominal=m_flow_nominal, + final dpDamper_nominal=dp_nominal, + final dpFixed_nominal=dat.dpFixed_nominal, + final use_inputFilter=use_inputFilter, + final riseTime=riseTime, + final init=init, + final y_start=y_start, + final allowFlowReversal=allowFlowReversal, + final show_T=show_T) + "Exponential damper" + annotation (Placement(transformation(extent={{-10,-10},{10,10}}))); +equation + connect(port_a, dam.port_a) annotation (Line(points={{-100,0},{-56,0},{-56,0}, + {-10,0}}, color={0,127,255})); + connect(dam.port_b, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(dam.y_actual, bus.y_actual) annotation (Line(points={{5,7},{40,7},{40, + 96},{0,96},{0,100}}, color={0,0,127})); + connect(bus.y, dam.y) annotation (Line( + points={{0,100},{0,12}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + annotation (Documentation(info=" ++This is a model for a modulating damper. +
+y (real).y = 0 corresponds to fully closed.
+y = 1 corresponds to fully open.
+y_actual (real) is returned.y_actual = 0 corresponds to fully closed.
+y_actual = 1 corresponds to fully open.
++This is a direct fluid pass-through model to represent +a configuration with no damper. +
+")); +end None; diff --git a/Buildings/Templates/Components/Dampers/PressureIndependent.mo b/Buildings/Templates/Components/Dampers/PressureIndependent.mo new file mode 100644 index 00000000000..e41684b515a --- /dev/null +++ b/Buildings/Templates/Components/Dampers/PressureIndependent.mo @@ -0,0 +1,54 @@ +within Buildings.Templates.Components.Dampers; +model PressureIndependent "Pressure independent damper" + extends Buildings.Templates.Components.Interfaces.PartialDamper( + final typ=Buildings.Templates.Components.Types.Damper.PressureIndependent, + final typBla=Buildings.Templates.Components.Types.DamperBlades.VAV); + + Buildings.Fluid.Actuators.Dampers.PressureIndependent dam( + redeclare final package Medium = Medium, + final m_flow_nominal=m_flow_nominal, + final dpDamper_nominal=dp_nominal, + final dpFixed_nominal=dat.dpFixed_nominal, + final use_inputFilter=use_inputFilter, + final riseTime=riseTime, + final init=init, + final y_start=y_start, + final allowFlowReversal=allowFlowReversal, + final show_T=show_T) + "Pressure independent damper" + annotation (Placement(transformation(extent={{-10,-10},{10,10}}))); +equation + connect(dam.port_b, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(dam.y_actual, bus.y_actual) + annotation (Line(points={{5,7},{40,7},{40,96},{0,96},{0,100}}, + color={0,0,127})); + connect(port_a, dam.port_a) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(bus.y, dam.y) annotation (Line( + points={{0,100},{0,12}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + annotation (Documentation(info=" ++This is a model for a pressure independent damper. +
+y (real).y = 0 corresponds to zero airflow.
+y = 1 corresponds to the maximum airflow.
+y_actual (real) is returned.y_actual = 0 corresponds to fully closed.
+y_actual = 1 corresponds to fully open.
++This is a model for a two-position damper. +
+y1.y1 = 0 corresponds to fully closed.
+y1 = 1 corresponds to fully open.
+y1_actual and
+closed end switch status y0_actual (Booleans)
+are returned.y1_actual = false corresponds to fully closed.
+y1_actual = true corresponds to fully open.
+And the opposite for y0_actual.
++This package contains models for dampers. +
+")); +end Dampers; diff --git a/Buildings/Templates/Components/Dampers/package.order b/Buildings/Templates/Components/Dampers/package.order new file mode 100644 index 00000000000..8548dedfa36 --- /dev/null +++ b/Buildings/Templates/Components/Dampers/package.order @@ -0,0 +1,4 @@ +Modulating +None +PressureIndependent +TwoPosition diff --git a/Buildings/Templates/Components/Data/Coil.mo b/Buildings/Templates/Components/Data/Coil.mo new file mode 100644 index 00000000000..805ef2eda79 --- /dev/null +++ b/Buildings/Templates/Components/Data/Coil.mo @@ -0,0 +1,134 @@ +within Buildings.Templates.Components.Data; +record Coil "Record for coil model" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.Components.Types.Coil typ + "Equipment type" + annotation (Dialog(group="Configuration", enable=false), Evaluate=true); + parameter Buildings.Templates.Components.Types.Valve typVal + "Type of valve" + annotation (Dialog(group="Configuration", enable=false), Evaluate=true); + parameter Boolean have_sou + "Set to true for fluid ports on the source side" + annotation (Dialog(group="Configuration"), Evaluate=true); + + /* +For evaporator coils this is also provided by the performance data record. +The coil model shall generate a warning in case the design value exceeds +the maximum value from the performance data record. +*/ + parameter Modelica.Units.SI.MassFlowRate mAir_flow_nominal( + final min=0, + start=if typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed then + datCoi.sta[datCoi.nSta].nomVal.m_flow_nominal + else 1) + "Air mass flow rate" + annotation ( + Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Coil.None and + typ<>Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage and + typ<>Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed)); + parameter Modelica.Units.SI.PressureDifference dpAir_nominal( + final min=0, + displayUnit="Pa", + start=if typ==Buildings.Templates.Components.Types.Coil.None then 0 else + 100) + "Air pressure drop" + annotation ( + Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Coil.None)); + parameter Modelica.Units.SI.MassFlowRate mWat_flow_nominal( + final min=0, + start=if typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating then + Q_flow_nominal / 4186 / 10 elseif + typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling then + -Q_flow_nominal / 4186 / 5 else + 0) + "Liquid mass flow rate" + annotation ( + Dialog(group="Nominal condition", enable=have_sou)); + parameter Modelica.Units.SI.PressureDifference dpWat_nominal( + final min=0, + displayUnit="Pa", + start=if typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating then + 0.5e4 elseif typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling then + 3e4 else + 0) + "Liquid pressure drop across coil" + annotation(Dialog(group="Nominal condition", + enable=have_sou)); + parameter Modelica.Units.SI.PressureDifference dpValve_nominal( + final min=0, + displayUnit="Pa", + start=if typVal==Buildings.Templates.Components.Types.Valve.None then 0 + else dpWat_nominal / 2) + "Liquid pressure drop across fully open valve" + annotation(Dialog(group="Nominal condition", + enable=have_sou and typVal<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Units.SI.HeatFlowRate cap_nominal( + start=if typ==Buildings.Templates.Components.Types.Coil.None then 0 + elseif typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed then + datCoi.sta[datCoi.nSta].nomVal.Q_flow_nominal + elseif typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling then -1E4 + else 1E4) + "Coil capacity" + annotation(Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Coil.None and + typ<>Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage and + typ<>Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed)); + /* +For evaporator coils this is also provided by the performance data record. +The coil model shall generate a warning in case the design value exceeds +the maximum value from the performance data record. +*/ + final parameter Modelica.Units.SI.HeatFlowRate Q_flow_nominal= + if typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating or + typ==Buildings.Templates.Components.Types.Coil.ElectricHeating then abs(cap_nominal) + else -1 * abs(cap_nominal) + "Nominal heat flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.Temperature TWatEnt_nominal( + final min=273.15, + displayUnit="degC", + start=if typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating then 50+273.15 + elseif typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling then 7+273.15 + else 273.15) + "Nominal entering liquid temperature" + annotation (Dialog( + group="Nominal condition", + enable=have_sou)); + parameter Modelica.Units.SI.Temperature TAirEnt_nominal( + final min=243.15, + displayUnit="degC", + start=if typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling then 30+273.15 + else 273.15) + "Nominal entering air temperature" + annotation (Dialog( + group="Nominal condition", + enable=have_sou)); + parameter Modelica.Units.SI.MassFraction wAirEnt_nominal( + final min=0, + start=0.01) + "Nominal entering air humidity ratio" + annotation (Dialog( + group="Nominal condition", + enable=typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling)); + replaceable parameter + Buildings.Fluid.DXSystems.Cooling.AirSource.Data.SingleSpeed.Carrier_Centurion_50PG06 datCoi + constrainedby + Buildings.Fluid.DXSystems.Cooling.AirSource.Data.Generic.DXCoil + "Performance data record of evaporator coil" + annotation(choicesAllMatching=true, Dialog( + enable=typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed)); + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +the classes within + +Buildings.Templates.Components.Coils. +
+")); +end Coil; diff --git a/Buildings/Templates/Components/Data/Damper.mo b/Buildings/Templates/Components/Data/Damper.mo new file mode 100644 index 00000000000..6f89ad08e79 --- /dev/null +++ b/Buildings/Templates/Components/Data/Damper.mo @@ -0,0 +1,40 @@ +within Buildings.Templates.Components.Data; +record Damper "Record for damper model" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.Components.Types.Damper typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter Modelica.Units.SI.MassFlowRate m_flow_nominal( + final min=0, + start=1) + "Air mass flow rate" + annotation ( + Dialog(group="Mechanical", + enable=typ<>Buildings.Templates.Components.Types.Damper.None)); + parameter Modelica.Units.SI.PressureDifference dp_nominal( + final min=0, + displayUnit="Pa", + start=if typ==Buildings.Templates.Components.Types.Damper.None then 0 + elseif typ==Buildings.Templates.Components.Types.Damper.PressureIndependent then 50 + else 15) + "Air pressure drop" + annotation ( + Dialog(group="Mechanical", + enable=typ<>Buildings.Templates.Components.Types.Damper.None)); + parameter Modelica.Units.SI.PressureDifference dpFixed_nominal( + final min=0, + displayUnit="Pa")=0 + "Air pressure drop of fixed elements in series with damper" + annotation ( + Dialog(group="Mechanical", enable=false)); + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +the classes within + +Buildings.Templates.Components.Dampers. +
+")); +end Damper; diff --git a/Buildings/Templates/Components/Data/Fan.mo b/Buildings/Templates/Components/Data/Fan.mo new file mode 100644 index 00000000000..0222046de79 --- /dev/null +++ b/Buildings/Templates/Components/Data/Fan.mo @@ -0,0 +1,48 @@ +within Buildings.Templates.Components.Data; +record Fan "Record for fan model" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.Components.Types.Fan typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Integer nFan( + final min=0, + start=if typ==Buildings.Templates.Components.Types.Fan.None then 0 else 1) + "Number of fans" + annotation (Evaluate=true, Dialog(group="Configuration", + enable=typ==Buildings.Templates.Components.Types.Fan.ArrayVariable)); + parameter Modelica.Units.SI.MassFlowRate m_flow_nominal( + final min=0, + start=1) + "Air mass flow rate" + annotation ( + Dialog(group="Nominal condition", + enable=typ <> Buildings.Templates.Components.Types.Fan.None)); + parameter Modelica.Units.SI.PressureDifference dp_nominal( + final min=0, + displayUnit="Pa", + start=if typ==Buildings.Templates.Components.Types.Fan.None then 1 + else 500) + "Total pressure rise" + annotation ( + Dialog(group="Nominal condition", + enable=typ <> Buildings.Templates.Components.Types.Fan.None)); + replaceable parameter Buildings.Fluid.Movers.Data.Generic per( + pressure( + V_flow={0, 1, 2} * m_flow_nominal / 1.2 / max(1, nFan), + dp={1.5, 1, 0} * dp_nominal)) + constrainedby Buildings.Fluid.Movers.Data.Generic + "Performance data" + annotation ( + choicesAllMatching=true, + Dialog(enable=typ <> Buildings.Templates.Components.Types.Fan.None), + Placement(transformation(extent={{-90,-88},{-70,-68}}))); + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +the classes within + +Buildings.Templates.Components.Fans. +
+")); +end Fan; diff --git a/Buildings/Templates/Components/Data/Valve.mo b/Buildings/Templates/Components/Data/Valve.mo new file mode 100644 index 00000000000..24c7c4ae01a --- /dev/null +++ b/Buildings/Templates/Components/Data/Valve.mo @@ -0,0 +1,44 @@ +within Buildings.Templates.Components.Data; +record Valve "Record for valve model" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.Components.Types.Valve typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter Modelica.Units.SI.MassFlowRate m_flow_nominal( + final min=0, + start=1) + "Nominal mass flow rate of fully open valve" + annotation(Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Units.SI.PressureDifference dpValve_nominal( + final min=0, + displayUnit="Pa", + start=0) + "Nominal pressure drop of fully open valve" + annotation(Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Units.SI.PressureDifference dpFixed_nominal( + final min=0, + displayUnit="Pa")=0 + "Nominal pressure drop of pipes and other equipment in flow leg" + annotation(Dialog(group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Units.SI.PressureDifference dpFixedByp_nominal( + final min=0, + displayUnit="Pa")=dpFixed_nominal + "Nominal pressure drop in the bypass line" + annotation(Dialog(group="Nominal condition", + enable=typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating)); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +the classes within + +Buildings.Templates.Components.Valves. +
+")); +end Valve; diff --git a/Buildings/Templates/Components/Data/package.mo b/Buildings/Templates/Components/Data/package.mo new file mode 100644 index 00000000000..7d696a7f433 --- /dev/null +++ b/Buildings/Templates/Components/Data/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.Components; +package Data "Records for design and operating parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + +annotation (Documentation(info=" ++This package provides records for design and operating parameters. +
+")); +end Data; diff --git a/Buildings/Templates/Components/Data/package.order b/Buildings/Templates/Components/Data/package.order new file mode 100644 index 00000000000..96dad205471 --- /dev/null +++ b/Buildings/Templates/Components/Data/package.order @@ -0,0 +1,4 @@ +Coil +Damper +Fan +Valve diff --git a/Buildings/Templates/Components/Fans/ArrayVariable.mo b/Buildings/Templates/Components/Fans/ArrayVariable.mo new file mode 100644 index 00000000000..c83b441d196 --- /dev/null +++ b/Buildings/Templates/Components/Fans/ArrayVariable.mo @@ -0,0 +1,133 @@ +within Buildings.Templates.Components.Fans; +model ArrayVariable "Fan array - Variable speed" + extends Buildings.Templates.Components.Interfaces.PartialFan( + final typ=Buildings.Templates.Components.Types.Fan.ArrayVariable); + + Buildings.Fluid.Movers.SpeedControlled_y fan[nFan]( + redeclare each final package Medium=Medium, + each final inputType=Buildings.Fluid.Types.InputType.Continuous, + each final per=dat.per, + each final energyDynamics=energyDynamics, + each final tau=tau, + each use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + each final allowFlowReversal=allowFlowReversal) + "Fan array" + annotation (Placement(transformation(extent={{-10,-10},{10,10}}))); + + Buildings.Controls.OBC.CDL.Routing.RealScalarReplicator repSig( + final nout=nFan) + "Replicate signal" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,30}))); + Buildings.Controls.OBC.CDL.Conversions.BooleanToReal sigSta + "Start/stop signal" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={-46,80}))); + Buildings.Controls.OBC.CDL.Continuous.Multiply sigCon + "Resulting control signal" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={-40,50}))); + Buildings.Controls.OBC.CDL.Continuous.GreaterThreshold evaSta[nFan]( + each t=1E-2, + each h=0.5E-2) "Evaluate fan status" + annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,-40}))); + Buildings.Fluid.Delays.DelayFirstOrder volInl( + redeclare final package Medium=Medium, + energyDynamics=Modelica.Fluid.Types.Dynamics.SteadyState, + final m_flow_nominal=m_flow_nominal, + tau=1, + final nPorts=nFan+1) + "Fluid volume at inlet" + annotation (Placement(transformation(extent={{-90,0},{-70,20}}))); + Buildings.Fluid.Delays.DelayFirstOrder volOut( + redeclare final package Medium = Medium, + energyDynamics=Modelica.Fluid.Types.Dynamics.SteadyState, + final m_flow_nominal=m_flow_nominal, + tau=1, + final nPorts=nFan+1) + "Fluid volume at outet" + annotation (Placement(transformation(extent={{50,0},{70,20}}))); + Buildings.Controls.OBC.CDL.Logical.MultiAnd evaStaArr( + final nin=nFan) + "Evaluate fan array status" annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,-70}))); +equation + connect(repSig.y, fan.y) + annotation (Line(points={{-2.22045e-15,18},{-2.22045e-15,25},{0,25},{0,12}}, + color={0,0,127})); + connect(sigSta.y, sigCon.u2) + annotation (Line(points={{-46,68},{-46,62}}, color={0,0,127})); + connect(sigCon.y, repSig.u) annotation (Line(points={{-40,38},{-40,30},{-20, + 30},{-20,50},{0,50},{0,46},{2.22045e-15,46},{2.22045e-15,42}}, + color={0,0,127})); + connect(fan.y_actual, evaSta.u) annotation (Line(points={{11,7},{20,7},{20,-20}, + {2.22045e-15,-20},{2.22045e-15,-28}}, + color={0,0,127})); + connect(volInl.ports[1:nFan], fan.port_a) + annotation (Line(points={{-80,0},{-10,0}}, color={0,127,255})); + connect(fan.port_b, volOut.ports[1:nFan]) + annotation (Line(points={{10,0},{60,0}}, color={0,127,255})); + connect(volOut.ports[nFan+1], V_flow.port_a) + annotation (Line(points={{60,0},{70,0}}, color={0,127,255})); + connect(volInl.ports[nFan+1], port_a) + annotation (Line(points={{-80,0},{-100,0}}, color={0,127,255})); + connect(evaSta.y, evaStaArr.u) annotation (Line(points={{-2.22045e-15,-52},{-2.22045e-15, + -55},{2.22045e-15,-55},{2.22045e-15,-58}}, color={255,0,255})); + connect(evaStaArr.y, bus.y1_actual) annotation (Line(points={{0,-82},{0,-90},{40, + -90},{40,96},{0,96},{0,100}}, color={255,0,255}), Text( + string="%second", + index=1, + extent={{-3,-6},{-3,-6}}, + horizontalAlignment=TextAlignment.Right)); + connect(bus.y1, sigSta.u) annotation (Line( + points={{0,100},{0,96},{-46,96},{-46,92}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + connect(bus.y, sigCon.u1) annotation (Line( + points={{0,100},{0,66},{-34,66},{-34,62}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + annotation (Placement(transformation(extent={{-10,-10},{10,10}})), + Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is a model for a parallel arrangement of identical variable speed fans +(or fan array). +
+y1 (VFD Run).
+y (real).y = 0 corresponds to 0 Hz.
+y = 1 corresponds to the maximum speed set in the VFD.
+y1_actual (Boolean) is returned.y1_actual = true means that all fans are On.
++This is a direct fluid pass-through model to represent +a configuration with no fan. +
+")); +end None; diff --git a/Buildings/Templates/Components/Fans/SingleConstant.mo b/Buildings/Templates/Components/Fans/SingleConstant.mo new file mode 100644 index 00000000000..0495c9c17c3 --- /dev/null +++ b/Buildings/Templates/Components/Fans/SingleConstant.mo @@ -0,0 +1,73 @@ +within Buildings.Templates.Components.Fans; +model SingleConstant "Single fan - Constant speed" + extends Buildings.Templates.Components.Interfaces.PartialFan( + final nFan=1, + final typ=Buildings.Templates.Components.Types.Fan.SingleConstant); + + Buildings.Fluid.Movers.SpeedControlled_y fan( + redeclare final package Medium =Medium, + final inputType=Buildings.Fluid.Types.InputType.Continuous, + final per=dat.per, + final energyDynamics=energyDynamics, + final tau=tau, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversal) + "Fan" + annotation ( + Placement(transformation(extent={{-10,-10},{10,10}}))); + + Buildings.Controls.OBC.CDL.Conversions.BooleanToReal sigSta + "Start/stop signal" annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,50}))); + Buildings.Controls.OBC.CDL.Continuous.GreaterThreshold evaSta( + t=1E-2, + h=0.5E-2) + "Evaluate fan status" annotation (Placement(transformation( + extent={{-10,-10},{10,10}}, + rotation=-90, + origin={0,-50}))); +equation + connect(sigSta.y, fan.y) + annotation (Line(points={{-2.22045e-15,38},{0,12}}, color={0,0,127})); + connect(port_a, fan.port_a) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(fan.y_actual, evaSta.u) annotation (Line(points={{11,7},{20,7},{20,-20}, + {2.22045e-15,-20},{2.22045e-15,-38}}, + color={0,0,127})); + connect(bus.y1, sigSta.u) annotation (Line( + points={{0,100},{2.22045e-15,62}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + connect(evaSta.y, bus.y1_actual) annotation (Line(points={{0,-62},{0,-80},{60, + -80},{60,96},{0,96},{0,100}}, color={255,0,255}), Text( + string="%second", + index=1, + extent={{-3,-6},{-3,-6}}, + horizontalAlignment=TextAlignment.Right)); + connect(fan.port_b, V_flow.port_a) + annotation (Line(points={{10,0},{70,0}}, color={0,127,255})); + annotation (Placement(transformation(extent={{-10,-10},{10,10}})), + Icon( + coordinateSystem(preserveAspectRatio=false)), Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is a model for a constant speed fan. +
+y1 (starter contact).
+y1_actual (Boolean) is returned.
+y1_actual = true means that the fan is On.
++This is a model for a variable speed fan (with VFD). +
+y1 (VFD Run).
+y (real).y = 0 corresponds to 0 Hz.
+y = 1 corresponds to the maximum speed set in the VFD.
+y1_actual (Boolean) is returned.y1_actual = true means that the fan is on.
++This package contains models for fans. +
+")); +end Fans; diff --git a/Buildings/Templates/Components/Fans/package.order b/Buildings/Templates/Components/Fans/package.order new file mode 100644 index 00000000000..05ba6d437f8 --- /dev/null +++ b/Buildings/Templates/Components/Fans/package.order @@ -0,0 +1,4 @@ +ArrayVariable +None +SingleConstant +SingleVariable diff --git a/Buildings/Templates/Components/Interfaces/Bus.mo b/Buildings/Templates/Components/Interfaces/Bus.mo new file mode 100644 index 00000000000..760cddbef48 --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/Bus.mo @@ -0,0 +1,12 @@ +within Buildings.Templates.Components.Interfaces; +expandable connector Bus "Control bus" + extends Modelica.Icons.SignalBus; + + annotation ( + defaultComponentName="bus", Documentation(info=" ++This expandable connector provides a standard interface for +all control signals of the component models. +
+")); +end Bus; diff --git a/Buildings/Templates/Components/Interfaces/PartialCoil.mo b/Buildings/Templates/Components/Interfaces/PartialCoil.mo new file mode 100644 index 00000000000..04bc99e62ef --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/PartialCoil.mo @@ -0,0 +1,222 @@ +within Buildings.Templates.Components.Interfaces; +partial model PartialCoil "Interface class for coil" + extends Buildings.Fluid.Interfaces.PartialTwoPortInterface( + redeclare final package Medium=MediumAir, + final m_flow_nominal=mAir_flow_nominal, + final allowFlowReversal=allowFlowReversalAir) + annotation(__ctrl_flow(enable=false)); + + replaceable package MediumAir=Buildings.Media.Air + "Air medium" + annotation(__ctrl_flow(enable=false)); + /* + The following definition is needed only for Dymola that does not allow + port_aSou and port_bSou to be instantiated without redeclaring their medium + to a non-partial class (which is done only in the derived class). + */ + replaceable package MediumSou=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Source-side medium" + annotation(Dialog(enable=false), __ctrl_flow(enable=false)); + + parameter Buildings.Templates.Components.Types.Coil typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Buildings.Templates.Components.Types.Valve typVal + "Type of valve" + annotation (Dialog(group="Configuration")); + final parameter Boolean have_sou= + typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating or + typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling + "Set to true for fluid ports on the source side" + annotation (Evaluate=true, Dialog(group="Configuration")); + final parameter Boolean have_weaBus= + typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed + "Set to true to use a weather bus" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Buildings.Templates.Components.Data.Coil dat( + final have_sou=have_sou, + final typ=typ, + final typVal=typVal) + "Design and operating parameters" + annotation ( + Placement(transformation(extent={{70,70},{90,90}})), + __ctrl_flow(enable=false)); + + final parameter Modelica.Units.SI.MassFlowRate mAir_flow_nominal( + final min=0) = dat.mAir_flow_nominal + "Air mass flow rate"; + final parameter Modelica.Units.SI.PressureDifference dpAir_nominal( + final min=0, + displayUnit="Pa") = dat.dpAir_nominal + "Air pressure drop"; + final parameter Modelica.Units.SI.HeatFlowRate Q_flow_nominal= + dat.Q_flow_nominal + "Nominal heat flow rate"; + + parameter Modelica.Units.SI.Time tau=20 + "Time constant at nominal flow" + annotation (Dialog(tab="Dynamics", group="Nominal condition", + enable=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState and ( + typ==Buildings.Templates.Components.Types.Coil.ElectricHeating or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed)), + __ctrl_flow(enable=false)); + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations", + enable=typ==Buildings.Templates.Components.Types.Coil.ElectricHeating or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed), + __ctrl_flow(enable=false)); + + parameter Boolean allowFlowReversalAir=true + "= true to allow flow reversal, false restricts to design direction - Air side" + annotation (Dialog(tab="Assumptions"), Evaluate=true, + __ctrl_flow(enable=false)); + parameter Boolean allowFlowReversalLiq=true + "= true to allow flow reversal, false restricts to design direction - CHW and HW side" + annotation (Dialog(tab="Assumptions", + enable=typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling or + typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating), + Evaluate=true, + __ctrl_flow(enable=false)); + + Modelica.Fluid.Interfaces.FluidPort_a port_aSou( + redeclare final package Medium = MediumSou, + m_flow(min=if allowFlowReversalLiq then -Modelica.Constants.inf else 0), + h_outflow(start=MediumSou.h_default, nominal=MediumSou.h_default)) + if have_sou + "Fluid connector a (positive design flow direction is from port_a to port_b)" + annotation (Placement(transformation(extent={{30,-110},{50,-90}}), + iconTransformation(extent={{40,-110},{60,-90}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bSou( + redeclare final package Medium = MediumSou, + m_flow(max=if allowFlowReversalLiq then +Modelica.Constants.inf else 0), + h_outflow(start = MediumSou.h_default, nominal = MediumSou.h_default)) + if have_sou + "Fluid connector b (positive design flow direction is from port_a to port_b)" + annotation (Placement(transformation(extent={{-30,-110},{-50,-90}}), + iconTransformation(extent={{-40,-110},{-60,-90}}))); + Buildings.BoundaryConditions.WeatherData.Bus busWea if have_weaBus + "Weather bus" + annotation (Placement( + transformation(extent={{-80,80},{-40,120}}), iconTransformation(extent={{-50,90}, + {-30,110}}))); + Buildings.Templates.Components.Interfaces.Bus bus + if typ <> Buildings.Templates.Components.Types.Coil.None + "Control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,100}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,100}))); + +protected + parameter Buildings.Templates.Components.Data.Valve datVal( + final typ=typVal, + final m_flow_nominal=dat.mWat_flow_nominal, + final dpValve_nominal=dat.dpValve_nominal, + final dpFixed_nominal=if typVal <> Buildings.Templates.Components.Types.Valve.None + then dat.dpWat_nominal else 0) + "Local record for control valve with lumped flow resistance"; +initial equation + if typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed then + assert(mAir_flow_nominal<=dat.datCoi.sta[dat.datCoi.nSta].nomVal.m_flow_nominal, + "In "+ getInstanceName() + ": "+ + "The coil design airflow ("+String(mAir_flow_nominal)+ + ") exceeds the maximum airflow provided in the performance data record ("+ + String(dat.datCoi.sta[dat.datCoi.nSta].nomVal.m_flow_nominal)+").", + level=AssertionLevel.warning); + assert(abs(Q_flow_nominal)<=abs(dat.datCoi.sta[dat.datCoi.nSta].nomVal.Q_flow_nominal), + "In "+ getInstanceName() + ": "+ + "The coil design capacity ("+String(Q_flow_nominal)+ + ") exceeds the maximum capacity provided in the performance data record ("+ + String(dat.datCoi.sta[dat.datCoi.nSta].nomVal.Q_flow_nominal)+").", + level=AssertionLevel.warning); + end if; + + annotation ( + Icon( + graphics={ + Bitmap( + visible=typ <> Buildings.Templates.Components.Types.Coil.None and + typVal == Buildings.Templates.Components.Types.Valve.TwoWayModulating, + extent={{-140,-300},{60,-100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Valves/TwoWay.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorMultiStage or + typ==Buildings.Templates.Components.Types.Coil.EvaporatorVariableSpeed, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Coils/Cooling.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Coil.WaterBasedCooling, + extent={{-100,-500},{100,-300}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Coils/ChilledWaterSupplyReturn.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating or + typ==Buildings.Templates.Components.Types.Coil.ElectricHeating, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Coils/Heating.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating, + extent={{-100,-500},{100,-300}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Coils/HotWaterSupplyReturn.svg"), + Line( + visible=typ<>Buildings.Templates.Components.Types.Coil.None and + typVal<>Buildings.Templates.Components.Types.Valve.None, + points={{-100,-200},{-40,-200}}, color={0,0,0}), + Line( + visible=typ<>Buildings.Templates.Components.Types.Coil.None, + points={{-40,-240},{-40,-320}}, + color={0,0,0}, + thickness=5), + Line( visible=typ <> Buildings.Templates.Components.Types.Coil.None, + points={{-40,-160},{-40,-100}}, + color={0,0,0}, + thickness=5), + Line( visible=typ <> Buildings.Templates.Components.Types.Coil.None and + typVal == Buildings.Templates.Components.Types.Valve.None, + points={{-40,-160},{-40,-240}}, + color={0,0,0}, + thickness=5), + Line( + visible=typ<>Buildings.Templates.Components.Types.Coil.None, + points={{40,-100},{40,-320}}, + color={0,0,0}, + thickness=5), + Line( + visible=typ<>Buildings.Templates.Components.Types.Coil.None and + (typVal==Buildings.Templates.Components.Types.Valve.ThreeWayModulating or + typVal==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition), + points={{0,-200},{40,-200}}, + color={0,0,0}, + thickness=5), + Bitmap( + visible=typ<>Buildings.Templates.Components.Types.Coil.None and + (typVal==Buildings.Templates.Components.Types.Valve.TwoWayModulating or + typVal==Buildings.Templates.Components.Types.Valve.ThreeWayModulating), + extent={{-180,-238},{-100,-158}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + visible=typ <> Buildings.Templates.Components.Types.Coil.None and + typVal == Buildings.Templates.Components.Types.Valve.ThreeWayModulating, + extent={{-140,-300},{60,-100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Valves/ThreeWay.svg")}, + coordinateSystem(preserveAspectRatio=false)), + Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This partial class provides a standard interface for coil models. +
+")); +end PartialCoil; diff --git a/Buildings/Templates/Components/Interfaces/PartialDamper.mo b/Buildings/Templates/Components/Interfaces/PartialDamper.mo new file mode 100644 index 00000000000..0400ba1cd73 --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/PartialDamper.mo @@ -0,0 +1,102 @@ +within Buildings.Templates.Components.Interfaces; +partial model PartialDamper "Interface class for damper" + extends Buildings.Fluid.Interfaces.PartialTwoPortInterface( + final m_flow_nominal=dat.m_flow_nominal) + annotation(__ctrl_flow(enable=false)); + + parameter Buildings.Templates.Components.Types.Damper typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Buildings.Templates.Components.Data.Damper dat(final typ=typ) + "Design and operating parameters" + annotation (Placement(transformation(extent={{70,70},{90,90}}))); + + final parameter Modelica.Units.SI.PressureDifference dp_nominal= + dat.dp_nominal + "Damper pressure drop"; + + parameter Boolean use_inputFilter=true + "= true, if opening is filtered with a 2nd order CriticalDamping filter" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enabel=typ<>Buildings.Templates.Components.Types.Damper.None)); + parameter Modelica.Units.SI.Time riseTime=120 + "Rise time of the filter (time to reach 99.6 % of an opening step)" + annotation (Dialog( + tab="Dynamics", + group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Damper.None)); + parameter Modelica.Blocks.Types.Init init=Modelica.Blocks.Types.Init.InitialOutput + "Type of initialization (no init/steady state/initial state/initial output)" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Damper.None)); + parameter Real y_start=1 "Initial position of actuator" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Damper.None)); + + parameter Buildings.Templates.Components.Types.DamperBlades typBla= + Buildings.Templates.Components.Types.DamperBlades.Parallel + "Type of blades" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Integer text_rotation = 0 + "Text rotation angle in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Boolean text_flip = false + "True to flip text horizontally in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + + Buildings.Templates.Components.Interfaces.Bus bus + if typ <> Buildings.Templates.Components.Types.Damper.None + and typ <> Buildings.Templates.Components.Types.Damper.Barometric and typ + <> Buildings.Templates.Components.Types.Damper.NoPath + "Control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,100}), + iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,100}))); + + annotation ( + Icon( + graphics={ + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Damper.TwoPosition, + extent=if text_flip then {{40,-240},{-40,-160}} else {{-40,-240},{40,-160}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/TwoPosition.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Damper.Modulating or + typ==Buildings.Templates.Components.Types.Damper.PressureIndependent, + extent=if text_flip then {{40,-240},{-40,-160}} else {{-40,-240},{40,-160}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + extent={{-130,-160},{130,100}}, + visible=typ<>Buildings.Templates.Components.Types.Damper.None and + typBla==Buildings.Templates.Components.Types.DamperBlades.Opposed, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesOpposed.svg"), + Bitmap( + extent={{-130,-160},{130,100}}, + visible=typ<>Buildings.Templates.Components.Types.Damper.None and + typBla==Buildings.Templates.Components.Types.DamperBlades.Parallel, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesParallel.svg"), + Bitmap( + extent={{-130,-160},{130,100}}, + visible=typ<>Buildings.Templates.Components.Types.Damper.None and + typBla==Buildings.Templates.Components.Types.DamperBlades.VAV, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Dampers/BladesVAV.svg")}, + coordinateSystem(preserveAspectRatio=false, + extent={{-100,-100},{100,100}})), + Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-100,-100},{100,100}})), + Documentation(info=" ++This partial class provides a standard interface for damper models. +
+")); + +end PartialDamper; diff --git a/Buildings/Templates/Components/Interfaces/PartialFan.mo b/Buildings/Templates/Components/Interfaces/PartialFan.mo new file mode 100644 index 00000000000..b5c8580aef5 --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/PartialFan.mo @@ -0,0 +1,133 @@ +within Buildings.Templates.Components.Interfaces; +partial model PartialFan "Interface class for fan" + extends Buildings.Fluid.Interfaces.PartialTwoPortInterface( + final m_flow_nominal=dat.m_flow_nominal) + annotation(__ctrl_flow(enable=false)); + + parameter Buildings.Templates.Components.Types.Fan typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Boolean have_senFlo = false + "Set to true for air flow measurement" + annotation (Evaluate=true, Dialog(group="Configuration", + enable=typ<>Buildings.Templates.Components.Types.Fan.None)); + + parameter Modelica.Units.SI.Time tau=1 + "Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic" + annotation (Dialog( + tab="Dynamics", + group="Nominal condition", + enable=typ<>Buildings.Templates.Components.Types.Fan.None and + energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState), + __ctrl_flow(enable=false)); + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, + Dialog(tab = "Dynamics", group="Conservation equations", + enable=typ<>Buildings.Templates.Components.Types.Fan.None), + __ctrl_flow(enable=false)); + + parameter Buildings.Templates.Components.Types.FanSingle typSin= + Buildings.Templates.Components.Types.FanSingle.Housed + "Type of single fan" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Integer text_rotation = 0 + "Text rotation angle in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Boolean text_flip = false + "True to flip text horizontally in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + + parameter Buildings.Templates.Components.Data.Fan dat( + final typ=typ, + final nFan=nFan) + "Design and operating parameters" + annotation(Placement(transformation(extent={{70,70},{90,90}})), + __ctrl_flow(enable=false)); + + parameter Integer nFan( + final min=0, + start=0) + "Number of fans" + annotation (Dialog(group="Configuration", + enable=typ==Buildings.Templates.Components.Types.Fan.ArrayVariable)); + final parameter Modelica.Units.SI.PressureDifference dp_nominal=dat.dp_nominal + "Total pressure rise"; + + Buildings.Templates.Components.Interfaces.Bus bus + if typ <> Buildings.Templates.Components.Types.Fan.None + "Control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,100}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,100}))); + Buildings.Templates.Components.Sensors.VolumeFlowRate V_flow( + redeclare final package Medium = Medium, + final have_sen=have_senFlo, + final m_flow_nominal=m_flow_nominal, + final typ=Buildings.Templates.Components.Types.SensorVolumeFlowRate.AFMS) + "Air volume flow rate sensor" + annotation ( + Placement(transformation(extent={{70,-10},{90,10}}))); +equation + /* Control point connection - start */ + connect(V_flow.y, bus.V_flow); + /* Control point connection - stop */ + connect(port_b, V_flow.port_b) + annotation (Line(points={{100,0},{90,0}}, color={0,127,255})); + annotation (Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Line( visible=typ == Buildings.Templates.Components.Types.Fan.SingleVariable + or typ == Buildings.Templates.Components.Types.Fan.ArrayVariable, + points={{0,-30},{0,-160}}, + color={0,0,0}), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Fan.ArrayVariable, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Array.svg"), + Bitmap( + visible=(typ==Buildings.Templates.Components.Types.Fan.SingleVariable or + typ==Buildings.Templates.Components.Types.Fan.SingleConstant) and + typSin==Buildings.Templates.Components.Types.FanSingle.Housed, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Housed.svg"), + Bitmap( + visible=(typ==Buildings.Templates.Components.Types.Fan.SingleVariable or + typ==Buildings.Templates.Components.Types.Fan.SingleConstant) and + typSin==Buildings.Templates.Components.Types.FanSingle.Plug, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Plug.svg"), + Bitmap( + visible=(typ==Buildings.Templates.Components.Types.Fan.SingleVariable or + typ==Buildings.Templates.Components.Types.Fan.SingleConstant) and + typSin==Buildings.Templates.Components.Types.FanSingle.Propeller, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Fans/Propeller.svg"), + Bitmap( + visible=have_senFlo and typ<>Buildings.Templates.Components.Types.Fan.None, + extent=if text_flip then {{-140,-240},{-220,-160}} else {{-220,-240},{-140,-160}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/VolumeFlowRate.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Fan.SingleVariable or + typ==Buildings.Templates.Components.Types.Fan.ArrayVariable, + extent=if text_flip then {{100,-360},{-100,-160}} else {{-100,-360},{100,-160}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/VFD.svg"), + Polygon( + points={{-185,-160},{-185,5},{-100,5},{-100,-5},{-175,-5},{-175,-160}, + {-185,-160}}, + lineColor={0,0,0}, + visible=have_senFlo and typ <> Buildings.Templates.Components.Types.Fan.None)}), + Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This partial class provides a standard interface for fan models. +
+")); +end PartialFan; diff --git a/Buildings/Templates/Components/Interfaces/PartialSensor.mo b/Buildings/Templates/Components/Interfaces/PartialSensor.mo new file mode 100644 index 00000000000..24dd22ed63b --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/PartialSensor.mo @@ -0,0 +1,57 @@ +within Buildings.Templates.Components.Interfaces; +partial model PartialSensor "Interface class for sensor" + extends Buildings.Fluid.Interfaces.PartialTwoPortInterface + annotation(__ctrl_flow(enable=false)); + + parameter Boolean have_sen=true + "Set to true for sensor, false for direct pass through" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Boolean isDifPreSen=false + "Set to true for differential pressure sensor, false for any other sensor" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Integer text_rotation = 0 + "Text rotation angle in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Boolean text_flip = false + "True to flip text horizontally in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + + Buildings.Controls.OBC.CDL.Interfaces.RealOutput y if have_sen + "Connector for measured value" + annotation (Placement(iconVisible=false, + transformation( + extent={{-20,-20},{20,20}}, + rotation=90, + origin={0,120}))); + +equation + if isDifPreSen and (not have_sen) then + // Zero flow equations for connectors + port_a.m_flow = 0; + port_b.m_flow = 0; + + // No contribution of specific quantities + port_a.h_outflow = 0; + port_b.h_outflow = 0; + port_a.Xi_outflow = zeros(Medium.nXi); + port_b.Xi_outflow = zeros(Medium.nXi); + port_a.C_outflow = zeros(Medium.nC); + port_b.C_outflow = zeros(Medium.nC); + end if; + + annotation ( + Icon(coordinateSystem(preserveAspectRatio=false), + graphics={ + Line( + visible=(not have_sen) and (not isDifPreSen), + points={{-100,0},{100,0}}, + color={28,108,200}, + thickness=1)}), + Diagram(coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This partial class provides a standard interface for sensor models. +
+")); +end PartialSensor; diff --git a/Buildings/Templates/Components/Interfaces/PartialValve.mo b/Buildings/Templates/Components/Interfaces/PartialValve.mo new file mode 100644 index 00000000000..7c25a2cbba5 --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/PartialValve.mo @@ -0,0 +1,134 @@ +within Buildings.Templates.Components.Interfaces; +partial model PartialValve "Interface class for valve" + extends Buildings.Fluid.Interfaces.PartialTwoPortInterface( + final m_flow_nominal=dat.m_flow_nominal) + annotation(__ctrl_flow(enable=false)); + + parameter Buildings.Templates.Components.Types.Valve typ + "Equipment type" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Buildings.Templates.Components.Data.Valve dat(final typ=typ) + "Design and operating parameters" + annotation (Placement(transformation(extent={{70,70},{90,90}})), + __ctrl_flow(enable=false)); + + final parameter Modelica.Units.SI.PressureDifference dpValve_nominal= + dat.dpValve_nominal + "Nominal pressure drop of fully open valve"; + final parameter Modelica.Units.SI.PressureDifference dpFixed_nominal= + dat.dpFixed_nominal + "Nominal pressure drop of pipes and other equipment in flow leg"; + final parameter Modelica.Units.SI.PressureDifference dpFixedByp_nominal= + dat.dpFixedByp_nominal + "Nominal pressure drop in the bypass line"; + + parameter Boolean use_inputFilter=true + "= true, if opening is filtered with a 2nd order CriticalDamping filter" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enable=typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Units.SI.Time riseTime=120 + "Rise time of the filter (time to reach 99.6 % of an opening step)" + annotation (Dialog( + tab="Dynamics", + group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Modelica.Blocks.Types.Init init=Modelica.Blocks.Types.Init.InitialOutput + "Type of initialization (no init/steady state/initial state/initial output)" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Valve.None)); + parameter Real y_start=1 "Initial position of actuator" + annotation(Dialog(tab="Dynamics", group="Filtered opening", + enable=use_inputFilter and typ<>Buildings.Templates.Components.Types.Valve.None)); + + parameter Modelica.Units.SI.Time tau=10 + "Time constant at nominal flow" + annotation (Dialog(tab="Dynamics", group="Nominal condition", + enable=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState and ( + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition)), + __ctrl_flow(enable=false)); + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations", + enable=typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition), + __ctrl_flow(enable=false)); + + parameter Integer text_rotation = 0 + "Text rotation angle in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Boolean text_flip = false + "True to flip text horizontally in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + + Modelica.Fluid.Interfaces.FluidPort_a portByp_a( + redeclare final package Medium = Medium, + p(start=Medium.p_default), + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + if typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating + "Fluid connector with bypass line" + annotation (Placement(transformation(extent={{-10,-110},{10,-90}}))); + Buildings.Templates.Components.Interfaces.Bus bus + if typ<>Buildings.Templates.Components.Types.Valve.None + "Control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=0, + origin={0,100}), iconTransformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={0,100}))); + annotation ( + Icon(graphics={ + Line( + points={{-100,0},{-40,0}}, + color={0,0,0}, + thickness=5), + Line( + points={{40,0},{100,0}}, + color={0,0,0}, + thickness=5), + Line( + visible=typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating, + points={{0,-100},{0,-40}}, + color={0,0,0}, + thickness=5), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Valve.TwoWayModulating or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating, + extent=if text_flip then {{40,60},{-40,140}} else {{-40,60},{40,140}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/Modulating.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Valve.TwoWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition, + extent=if text_flip then {{40,60},{-40,140}} else {{-40,60},{40,140}}, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Actuators/TwoPosition.svg"), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Valve.TwoWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.TwoWayModulating, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Valves/TwoWay.svg", + rotation=-90), + Bitmap( + visible=typ==Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition or + typ==Buildings.Templates.Components.Types.Valve.ThreeWayModulating, + extent={{-100,-100},{100,100}}, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Valves/ThreeWay.svg", + rotation=-90), + Line( + visible=typ<>Buildings.Templates.Components.Types.Valve.None, + points={{0,60},{0,0}}, color={0,0,0})}), + Documentation(info=" ++This partial class provides a standard interface for valve models. +
+")); +end PartialValve; diff --git a/Buildings/Templates/Components/Interfaces/package.mo b/Buildings/Templates/Components/Interfaces/package.mo new file mode 100644 index 00000000000..537e7dc3ba8 --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.Components; +package Interfaces "Interface classes" + extends Modelica.Icons.InterfacesPackage; + + annotation (Documentation(info=" ++This package contains interface classes. +
+")); +end Interfaces; diff --git a/Buildings/Templates/Components/Interfaces/package.order b/Buildings/Templates/Components/Interfaces/package.order new file mode 100644 index 00000000000..9c481d0f47a --- /dev/null +++ b/Buildings/Templates/Components/Interfaces/package.order @@ -0,0 +1,6 @@ +Bus +PartialCoil +PartialDamper +PartialFan +PartialSensor +PartialValve diff --git a/Buildings/Templates/Components/Routing/MultipleToMultiple.mo b/Buildings/Templates/Components/Routing/MultipleToMultiple.mo new file mode 100644 index 00000000000..e23e8ac3d7c --- /dev/null +++ b/Buildings/Templates/Components/Routing/MultipleToMultiple.mo @@ -0,0 +1,229 @@ +within Buildings.Templates.Components.Routing; +model MultipleToMultiple + "Multiple inlet ports, multiple outlet ports" + + replaceable package Medium = + Modelica.Media.Interfaces.PartialMedium "Medium in the component" + annotation (choices( + choice(redeclare package Medium = Buildings.Media.Air "Moist air"), + choice(redeclare package Medium = Buildings.Media.Water "Water"), + choice(redeclare package Medium = + Buildings.Media.Antifreeze.PropyleneGlycolWater ( + property_T=293.15, + X_a=0.40) + "Propylene glycol water, 40% mass fraction"))); + parameter Integer nPorts_a + "Number of inlet ports" + annotation(Evaluate=true, Dialog(group="Configuration")); + parameter Integer nPorts_b = nPorts_a + "Number of outlet ports" + annotation(Evaluate=true, Dialog(group="Configuration", enable=not have_comLeg)); + parameter Boolean have_comLeg = false + "Set to true for common leg between inlet and outlet ports (headered connection)" + annotation(Evaluate=true, Dialog(group="Configuration")); + + parameter Modelica.Units.SI.MassFlowRate m_flow_nominal(min=0) + "Nominal mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.Time tau=10 + "Time constant at nominal flow" + annotation (Dialog(tab="Dynamics", group="Nominal condition")); + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + parameter Boolean allowFlowReversal=true + "= true to allow flow reversal, false restricts to design direction (ports_a -> ports_b)" + annotation (Dialog(tab="Assumptions"), Evaluate=true); + // Diagnostics + parameter Boolean show_T = false + "Set to true if actual temperature at port is computed" + annotation ( + Dialog(tab="Advanced", group="Diagnostics"), HideResult=true); + + parameter Integer icon_extend = 0 + "Extend lines by this amount in x-direction in icon layer: >0 at outlet, <0 at inlet" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Integer icon_dy = 100 + "Distance in y-direction between each branch in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Buildings.Templates.Components.Types.IconPipe icon_pipe = + Buildings.Templates.Components.Types.IconPipe.Supply + "Pipe symbol" + annotation(Dialog(tab="Graphics", enable=false)); + + Modelica.Fluid.Interfaces.FluidPorts_a ports_a[nPorts_a]( + redeclare each final package Medium = Medium, + each m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + each h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + "Fluid connector a (positive design flow direction is from ports_a to ports_b)" + annotation (Placement(transformation(extent={{-110,-40},{-90,40}}), + iconTransformation(extent={{-110,-40},{-90,40}}))); + Modelica.Fluid.Interfaces.FluidPorts_b ports_b[nPorts_b]( + redeclare each final package Medium = Medium, + each m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + each h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + "Fluid connectors b (positive design flow direction is from ports_a to ports_b)" + annotation (Placement(transformation(extent={{90,-40},{110,40}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_aComLeg( + redeclare final package Medium=Medium, + m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + if have_comLeg "Common leg port - Case with common leg" + annotation (Placement(transformation(extent={{-10,-70},{10,-50}}), + iconTransformation(extent={{-10,-10},{10,10}}))); + + PassThroughFluid pasDed[nPorts_a]( + redeclare each final package Medium=Medium) if not have_comLeg + "Dedicated fluid pass-through if dedicated arrangement" + annotation (Placement(transformation(extent={{-10,10},{10,30}}))); + + Medium.ThermodynamicState sta_a[nPorts_a]= + Medium.setState_phX(ports_a.p, + noEvent(actualStream(ports_a.h_outflow)), + noEvent(actualStream(ports_a.Xi_outflow))) + if show_T "Medium properties in ports_a"; + + Medium.ThermodynamicState sta_b[nPorts_b]= + Medium.setState_phX(ports_b.p, + noEvent(actualStream(ports_b.h_outflow)), + noEvent(actualStream(ports_b.Xi_outflow))) + if show_T "Medium properties in ports_b"; + + Fluid.Delays.DelayFirstOrder del( + redeclare final package Medium=Medium, + final tau=tau, + final m_flow_nominal=m_flow_nominal, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final prescribedHeatFlowRate=false, + final nPorts=nPorts_a+nPorts_b+1) + if have_controlVolume and have_comLeg + "Fluid volume to break algebraic loop - Case with common leg" + annotation (Placement(transformation(extent={{-10,-20},{10,0}}))); + + PassThroughFluid pasSteInl(redeclare final package Medium = Medium) + if have_comLeg and not have_controlVolume + "Fluid pass-through in lieu of control volume - Case with common leg" + annotation (Placement(transformation(extent={{-60,-70},{-40,-50}}))); + PassThroughFluid pasSteOut(redeclare final package Medium = Medium) + if have_comLeg and not have_controlVolume + "Fluid pass-through in lieu of control volume - Case with common leg" + annotation (Placement(transformation(extent={{40,-70},{60,-50}}))); + +protected + parameter Boolean have_controlVolume= + energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState + "Boolean flag used to remove conditional components" + annotation(Evaluate=true); + +initial equation + if not have_comLeg then + assert(nPorts_a==nPorts_b, + "In "+ getInstanceName() + ": "+ + "In the absence of a common leg (dedicated connection), the number of inlet ports (" + + String(nPorts_a) + ") must be equal to the number of outlet ports (" + + String(nPorts_b) +")"); + end if; +equation + for i in 1:nPorts_a loop + connect(ports_a[i], pasSteInl.port_a) annotation (Line(points={{-100,0},{-80,0}, + {-80,-60},{-60,-60}}, color={0,127,255})); + end for; + for i in 1:nPorts_b loop + connect(pasSteOut.port_b, ports_b[i]) annotation (Line(points={{60,-60},{80,-60}, + {80,0},{100,0}}, color={0,127,255})); + end for; + connect(ports_a, pasDed.port_a) annotation (Line(points={{-100,0},{-20,0},{-20, + 20},{-10,20}}, color={0,127,255})); + connect(pasDed.port_b, ports_b) annotation (Line(points={{10,20},{20,20},{20,0}, + {100,0}}, color={0,127,255})); + connect(del.ports[nPorts_a+nPorts_b+1], port_aComLeg) annotation (Line(points={{0,-20}, + {0,-20},{0,-60}}, + color={0,127,255})); + connect(ports_a, del.ports[1:nPorts_a]) + annotation (Line(points={{-100,0},{-20,0},{-20, + -20},{0,-20}}, color={0,127,255})); + connect(del.ports[(nPorts_a+1):(nPorts_a+nPorts_b)], ports_b) + annotation (Line(points={{0,-20},{20,-20},{20,0},{100,0}}, + color={0,127,255})); + connect(pasSteInl.port_b, port_aComLeg) + annotation (Line(points={{-40,-60},{0,-60}}, color={0,127,255})); + connect(port_aComLeg, pasSteOut.port_a) + annotation (Line(points={{0,-60},{40,-60}}, color={0,127,255})); + + + annotation ( + defaultComponentName="rou", + Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Text( extent={{-149,-114},{151,-154}}, + textColor={0,0,255}, + textString="%name"), + Line( points={{-100 + min(0,icon_extend), 0}, {100 + max(0, icon_extend),0}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_a>=2, + points=if have_comLeg then + {{-100 + min(0,icon_extend), icon_dy}, {-40,icon_dy}, {-40, 0}} + else {{-100 + min(0,icon_extend),icon_dy}, {100 + max(0, icon_extend),icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_a>=3, + points=if have_comLeg then + {{-100 + min(0,icon_extend), 2*icon_dy}, {-40, 2*icon_dy}, {-40, icon_dy}} + else {{-100 + min(0,icon_extend),2*icon_dy}, {100 + max(0, icon_extend),2*icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_a>=4, + points=if have_comLeg then + {{-100 + min(0,icon_extend), 3*icon_dy}, {-40, 3*icon_dy}, {-40, 2*icon_dy}} + else {{-100 + min(0,icon_extend),3*icon_dy}, {100 + max(0, icon_extend),3*icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_b>=2 and have_comLeg, + points={{40, 0}, {40, icon_dy}, {100 + max(0, icon_extend), icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_b>=3 and have_comLeg, + points={{40, icon_dy}, {40, 2*icon_dy}, {100 + max(0, icon_extend), 2*icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts_b>=4 and have_comLeg, + points={{40, 2*icon_dy}, {40, 3*icon_dy}, {100 + max(0, icon_extend), 3*icon_dy}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash)}), + Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(revisions=" ++This is a model of a many-to-many fluid connector with an +optional control volume, and an optional mixing port (common leg). +It is typically used to connect parallel pumps with parallel +chillers or boilers. +Selecting a mixing port allows modeling a headered pumping arrangement. +Without any mixing port, a dedicated pumping arrangement is modeled. +
+")); +end MultipleToMultiple; diff --git a/Buildings/Templates/Components/Routing/MultipleToSingle.mo b/Buildings/Templates/Components/Routing/MultipleToSingle.mo new file mode 100644 index 00000000000..df088e2bfe3 --- /dev/null +++ b/Buildings/Templates/Components/Routing/MultipleToSingle.mo @@ -0,0 +1,167 @@ +within Buildings.Templates.Components.Routing; +model MultipleToSingle "Multiple inlet port, single outlet ports" + replaceable package Medium = + Modelica.Media.Interfaces.PartialMedium "Medium in the component" + annotation (choices( + choice(redeclare package Medium = Buildings.Media.Air "Moist air"), + choice(redeclare package Medium = Buildings.Media.Water "Water"), + choice(redeclare package Medium = + Buildings.Media.Antifreeze.PropyleneGlycolWater ( + property_T=293.15, + X_a=0.40) + "Propylene glycol water, 40% mass fraction"))); + parameter Integer nPorts + "Number of ports" + annotation(Evaluate=true, Dialog(group="Configuration")); + + parameter Modelica.Units.SI.MassFlowRate m_flow_nominal(min=0) + "Nominal mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.Time tau=10 + "Time constant at nominal flow" + annotation (Dialog(tab="Dynamics", group="Nominal condition")); + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + parameter Boolean allowFlowReversal=true + "Set to true to allow flow reversal, false restricts to design direction (ports_a -> port_b)" + annotation (Evaluate=true, Dialog(tab="Assumptions")); + // Diagnostics + parameter Boolean show_T = false + "Set to true if actual temperature at port is computed" + annotation ( + Dialog(tab="Advanced", group="Diagnostics"), + HideResult=true); + + parameter Integer icon_offset = 0 + "Offset in y-direction between inlet and outlet in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Integer icon_dy = 100 + "Distance in y-direction between each branch in icon layer" + annotation(Dialog(tab="Graphics", enable=false)); + parameter Buildings.Templates.Components.Types.IconPipe icon_pipe = + Buildings.Templates.Components.Types.IconPipe.Supply + "Pipe symbol" + annotation(Dialog(tab="Graphics", enable=false)); + + Modelica.Fluid.Interfaces.FluidPorts_a ports_a[nPorts]( + redeclare each final package Medium = Medium, + each m_flow(min=if allowFlowReversal then -Modelica.Constants.inf else 0), + each h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + "Fluid connector a (positive design flow direction is from ports_a to port_b)" + annotation (Placement(transformation(extent={{-110,-40},{-90,40}}), + iconTransformation(extent={{-110,-40},{-90,40}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_b( + redeclare final package Medium = Medium, + m_flow(max=if allowFlowReversal then +Modelica.Constants.inf else 0), + h_outflow(start=Medium.h_default, nominal=Medium.h_default)) + "Fluid connectors b (positive design flow direction is from ports_a to port_b)" + annotation (Placement(transformation(extent={{90,-10},{110,10}}))); + + Fluid.Delays.DelayFirstOrder del( + redeclare final package Medium = Medium, + final tau=tau, + final m_flow_nominal=m_flow_nominal, + final energyDynamics=energyDynamics, + final allowFlowReversal=allowFlowReversal, + final prescribedHeatFlowRate=false, + final nPorts=nPorts+1) + if have_controlVolume + "Fluid volume to break algebraic loop" + annotation (Placement(transformation(extent={{-10,-20},{10,0}}))); + PassThroughFluid pasSte( + redeclare final package Medium=Medium) + if not have_controlVolume + "Fluid pass-through in lieu of control volume" + annotation (Placement(transformation(extent={{-10,10},{10,30}}))); + + Medium.ThermodynamicState sta_a[nPorts]= + Medium.setState_phX(ports_a.p, + noEvent(actualStream(ports_a.h_outflow)), + noEvent(actualStream(ports_a.Xi_outflow))) + if show_T "Medium properties in ports_a"; + Medium.ThermodynamicState sta_b= + Medium.setState_phX(port_b.p, + noEvent(actualStream(port_b.h_outflow)), + noEvent(actualStream(port_b.Xi_outflow))) + if show_T "Medium properties in port_b"; + +protected + parameter Boolean have_controlVolume= + energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState + "Boolean flag used to remove conditional components" + annotation(Evaluate=true); + +equation + for i in 1:nPorts loop + connect(ports_a[i], pasSte.port_a) annotation (Line(points={{-100,0},{-20,0},{ + -20,20},{-10,20}}, color={0,127,255})); + end for; + connect(ports_a, del.ports[1:nPorts]) annotation (Line(points={{-100,0},{-20,0}, + {-20,-20},{0,-20}}, + color={0,127,255})); + connect(del.ports[nPorts+1], port_b) annotation (Line(points={{0,-20},{20,-20}, + {20,0},{100,0}}, color={0,127,255})); + connect(pasSte.port_b, port_b) annotation (Line(points={{10,20},{20,20},{20,0}, + {100,0}}, color={0,127,255})); + annotation ( + defaultComponentName="rou", + Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Text( extent={{-149,-114},{151,-154}}, + textColor={0,0,255}, + textString="%name"), + Line( points={{-100, icon_offset}, {0, icon_offset}, {0,0}, {100,0}}, + color={0,0,0}, + thickness=5, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash), + Line( visible=nPorts>=2, + points=if icon_offset*icon_dy>=0 then + {{0,icon_offset},{0,icon_offset+icon_dy},{-100,icon_offset+icon_dy}} + elseif icon_offset>0 and icon_offset+icon_dy<0 or icon_offset<0 and icon_offset+icon_dy>0 then + {{0,0},{0,icon_offset+icon_dy},{-100,icon_offset+icon_dy}} + else {{0,icon_offset+icon_dy},{-100,icon_offset+icon_dy}}, + color={0,0,0}, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash, + thickness=5), + Line( visible=nPorts>=3, + points=if icon_offset*icon_dy>=0 then + {{0, icon_offset+icon_dy},{0, icon_offset+2*icon_dy},{-100, icon_offset+2*icon_dy}} + elseif icon_offset>0 and icon_offset+2*icon_dy<0 or icon_offset<0 and icon_offset+2*icon_dy>0 then + {{0, 0},{0, icon_offset+2*icon_dy},{-100, icon_offset+2*icon_dy}} + else {{0, icon_offset+2*icon_dy},{-100, icon_offset+2*icon_dy}}, + color={0,0,0}, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash, + thickness=5), + Line( visible=nPorts>=4, + points=if icon_offset*icon_dy>=0 then + {{0, icon_offset+2*icon_dy},{0, icon_offset+3*icon_dy},{-100, icon_offset+3*icon_dy}} + elseif icon_offset>0 and icon_offset+3*icon_dy<0 or icon_offset<0 and icon_offset+3*icon_dy>0 then + {{0, 0},{0, icon_offset+3*icon_dy},{-100, icon_offset+3*icon_dy}} + else {{0, icon_offset+3*icon_dy},{-100, icon_offset+3*icon_dy}}, + color={0,0,0}, + pattern=if icon_pipe==Buildings.Templates.Components.Types.IconPipe.Supply + then LinePattern.Solid else LinePattern.Dash, + thickness=5)}), + Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(revisions=" ++This is a model of a many-to-one fluid connector with an +optional control volume. +It is typically used to represent an outlet manifold or +multiple junctions converging into a single pipe. +
+")); +end MultipleToSingle; diff --git a/Buildings/Templates/Components/Routing/PassThroughFluid.mo b/Buildings/Templates/Components/Routing/PassThroughFluid.mo new file mode 100644 index 00000000000..410acee7d08 --- /dev/null +++ b/Buildings/Templates/Components/Routing/PassThroughFluid.mo @@ -0,0 +1,28 @@ +within Buildings.Templates.Components.Routing; +model PassThroughFluid "Direct fluid pass-through" + extends Buildings.Fluid.Interfaces.PartialTwoPort; + +equation + connect(port_a, port_b) annotation (Line(points={{-100,0},{0,0},{0,0},{100,0}}, + color={0,127,255})); + annotation ( + defaultComponentName="pas", + Icon(coordinateSystem(preserveAspectRatio=false), + graphics={Line( + points={{-100,0},{100,0}}, + color={28,108,200}, + thickness=1)}), Diagram(coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is a model of a direct fluid pass-through used for +templating purposes. +
+", revisions=" ++This is a model of a one-to-many fluid connector with an +optional control volume. +It is typically used to represent an inlet manifold or +a single pipe diverging into multiple junctions. +
+")); +end SingleToMultiple; diff --git a/Buildings/Templates/Components/Routing/package.mo b/Buildings/Templates/Components/Routing/package.mo new file mode 100644 index 00000000000..1559f82ce92 --- /dev/null +++ b/Buildings/Templates/Components/Routing/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.Components; +package Routing "Connection models for fluid routing" + extends Modelica.Icons.VariantsPackage; + +annotation (Documentation(info=" ++This package contains models that allow connecting component +fluid ports together with various routing arrangements. +
+")); +end Routing; diff --git a/Buildings/Templates/Components/Routing/package.order b/Buildings/Templates/Components/Routing/package.order new file mode 100644 index 00000000000..cb417ce6c69 --- /dev/null +++ b/Buildings/Templates/Components/Routing/package.order @@ -0,0 +1,4 @@ +MultipleToMultiple +MultipleToSingle +PassThroughFluid +SingleToMultiple diff --git a/Buildings/Templates/Components/Sensors/DifferentialPressure.mo b/Buildings/Templates/Components/Sensors/DifferentialPressure.mo new file mode 100644 index 00000000000..55206014d71 --- /dev/null +++ b/Buildings/Templates/Components/Sensors/DifferentialPressure.mo @@ -0,0 +1,55 @@ +within Buildings.Templates.Components.Sensors; +model DifferentialPressure "Differential pressure sensor" + extends Buildings.Templates.Components.Interfaces.PartialSensor( + y(final unit="Pa", displayUnit="Pa"), + final m_flow_nominal=0, + final isDifPreSen=true); + + Buildings.Fluid.Sensors.RelativePressure senRelPre( + redeclare final package Medium=Medium) if have_sen + "Relative pressure sensor" + annotation (Placement(transformation(extent={{-10,10},{10,-10}}))); +equation + connect(port_a, senRelPre.port_a) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(senRelPre.p_rel, y) + annotation (Line(points={{0,9},{0,120}}, color={0,0,127})); + connect(senRelPre.port_b, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + annotation (Icon(coordinateSystem(preserveAspectRatio=false), graphics={ + Bitmap( + extent=if text_flip then {{40,-40},{-40,40}} else {{-40,-40},{40,40}}, + visible=have_sen, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/DifferentialPressure.svg"), + Bitmap( + extent=if text_flip then {{-30,-70},{-110,10}} else {{-110,-70},{-30,10}}, + visible=have_sen, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/DifferentialPressureHigh.svg"), + Bitmap( + extent=if text_flip then {{110,-70},{30,10}} else {{30,-70},{110,10}}, + visible=have_sen, + rotation=text_rotation, + fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/DifferentialPressureLow.svg")}), + Diagram(coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" +
+This is a model for a differential pressure sensor that can be
+enabled or disabled with the Boolean parameter have_sen.
+If disabled, the control input variable y is removed
+and the model simply consists of two fluid ports that are not connected
+to each other and for which the following equations are used.
+So the model must still be provided with pressure conditions
+at each port.
+
+// Zero flow equations
+port_(a|b).m_flow = 0;
+// No contribution of specific quantities
+port_(a|b).h_outflow = 0;
+port_(a|b).Xi_outflow = zeros(Medium.nXi);
+port_(a|b).C_outflow = zeros(Medium.nC);
+
+"));
+end DifferentialPressure;
diff --git a/Buildings/Templates/Components/Sensors/HumidityRatio.mo b/Buildings/Templates/Components/Sensors/HumidityRatio.mo
new file mode 100644
index 00000000000..1178cabf263
--- /dev/null
+++ b/Buildings/Templates/Components/Sensors/HumidityRatio.mo
@@ -0,0 +1,58 @@
+within Buildings.Templates.Components.Sensors;
+model HumidityRatio "Humidity ratio sensor"
+ extends Buildings.Templates.Components.Interfaces.PartialSensor(
+ y(final unit="kg/kg"),
+ final isDifPreSen=false);
+
+ Buildings.Fluid.Sensors.MassFractionTwoPort senMasFra(
+ redeclare final package Medium=Medium,
+ final m_flow_nominal=m_flow_nominal,
+ final allowFlowReversal=allowFlowReversal) if have_sen
+ "Mass fraction sensor"
+ annotation (Placement(transformation(extent={{-10,-10},{10,10}})));
+ Buildings.Utilities.Psychrometrics.ToDryAir toDryAir if have_sen
+ "Conversion into kg/kg dry air"
+ annotation (Placement(
+ transformation(
+ extent={{-10,-10},{10,10}},
+ rotation=90,
+ origin={0,30})));
+
+ Buildings.Templates.Components.Routing.PassThroughFluid pas(
+ redeclare final package Medium = Medium,
+ final allowFlowReversal=allowFlowReversal) if not have_sen "Pass through"
+ annotation (Placement(transformation(extent={{-10,-50},{10,-30}})));
+equation
+ connect(port_a, senMasFra.port_a)
+ annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255}));
+ connect(senMasFra.port_b, port_b)
+ annotation (Line(points={{10,0},{100,0}}, color={0,127,255}));
+ connect(senMasFra.X, toDryAir.XiTotalAir)
+ annotation (Line(points={{0,11},{0,19}}, color={0,0,127}));
+
+ connect(port_a, pas.port_a) annotation (Line(points={{-100,0},{-80,0},{-80,-40},
+ {-10,-40}}, color={0,127,255}));
+ connect(pas.port_b, port_b) annotation (Line(points={{10,-40},{80,-40},{80,0},
+ {100,0}}, color={0,127,255}));
+ connect(toDryAir.XiDry, y)
+ annotation (Line(points={{0,41},{0,120}}, color={0,0,127}));
+ annotation (Icon(coordinateSystem(preserveAspectRatio=false), graphics={
+ Bitmap(
+ extent={{-100,-160},{100,40}},
+ visible=have_sen,
+ fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/ProbeStandard.svg"),
+ Bitmap(
+ extent=if text_flip then {{40,-240},{-40,-160}} else {{-40,-240},{40,-160}},
+ visible=have_sen,
+ rotation=text_rotation,
+ fileName="modelica://Buildings/Resources/Images/Templates/Components/Sensors/HumidityRatio.svg")}),
+ Diagram(coordinateSystem(preserveAspectRatio=false)),
+ Documentation(info="
+
+This is a model for a humidity ratio (in kg/kg dry air) sensor that can be
+enabled or disabled with the Boolean parameter have_sen.
+If disabled, the control input variable y is removed
+and the model is a direct fluid pass-through.
+
+This is a model for a specific enthalpy sensor that can be
+enabled or disabled with the Boolean parameter have_sen.
+If disabled, the control input variable y is removed
+and the model is a direct fluid pass-through.
+
+This is a model for a dry bulb temperature sensor that can be
+enabled or disabled with the Boolean parameter have_sen.
+If disabled, the control input variable y is removed
+and the model is a direct fluid pass-through.
+
+This is a model for a volume flow rate sensor that can be
+enabled or disabled with the Boolean parameter have_sen.
+If disabled, the control input variable y is removed
+and the model is a direct fluid pass-through.
+
+This package contains models for sensors. +
+")); +end Sensors; diff --git a/Buildings/Templates/Components/Sensors/package.order b/Buildings/Templates/Components/Sensors/package.order new file mode 100644 index 00000000000..2417b06398e --- /dev/null +++ b/Buildings/Templates/Components/Sensors/package.order @@ -0,0 +1,5 @@ +DifferentialPressure +HumidityRatio +SpecificEnthalpy +Temperature +VolumeFlowRate diff --git a/Buildings/Templates/Components/Types.mo b/Buildings/Templates/Components/Types.mo new file mode 100644 index 00000000000..a864929df7a --- /dev/null +++ b/Buildings/Templates/Components/Types.mo @@ -0,0 +1,136 @@ +within Buildings.Templates.Components; +package Types "Package with type definitions" + extends Modelica.Icons.TypesPackage; + type Chiller = enumeration( + AirCooled + "Air-cooled compression chiller", + WaterCooled + "Water-cooled compression chiller") + "Enumeration to specify the type of chiller"; + type Coil = enumeration( + ElectricHeating + "Modulating electric heating coil", + EvaporatorMultiStage + "Evaporator coil with multi-stage compressor", + EvaporatorVariableSpeed + "Evaporator coil with variable speed compressor", + None + "No coil", + WaterBasedCooling + "Chilled water coil", + WaterBasedHeating + "Hot water coil") + "Enumeration to configure the coil"; + type Cooler = enumeration( + None + "No external cooler (typically for air-cooled chillers)", + CoolingTowerClosed + "Closed-circuit cooling tower", + CoolingTowerOpen + "Open-circuit cooling tower", + DryCooler + "Dry cooler") + "Enumeration to configure the condenser water cooling equipment"; + type Damper = enumeration( + NoPath + "No fluid path", + Barometric + "Barometric damper", + Modulating + "Modulating damper", + None + "No damper", + PressureIndependent + "Pressure independent damper", + TwoPosition + "Two-position damper") + "Enumeration to configure the damper"; + type DamperBlades = enumeration( + Opposed + "Opposed blades", + Parallel + "Parallel blades", + VAV + "VAV damper") + "Enumeration to specify the type of damper blades"; + type Fan = enumeration( + None + "No fan", + SingleConstant + "Single fan - Constant speed", + SingleVariable + "Single fan - Variable speed", + ArrayVariable + "Fan array - Variable speed") + "Enumeration to configure the fan"; + type FanSingle = enumeration( + Housed + "Housed centrifugal fan", + Plug + "Plug fan", + Propeller + "Propeller fan") + "Enumeration to specify the type of single fan"; + type IconPipe = enumeration( + None + "No line", + Return + "Return pipe - Dashed line", + Supply + "Supply pipe - Solid line") + "Enumeration to specify the pipe symbol"; + type Sensor = enumeration( + DifferentialPressure + "Differential pressure", + HumidityRatio + "Humidity ratio", + PPM + "PPM", + RelativeHumidity + "Relative humidity", + SpecificEnthalpy + "Specific enthalpy", + Temperature + "Temperature", + VolumeFlowRate + "Volume flow rate") + "Enumeration to configure the sensor"; + type SensorTemperature = enumeration( + Standard + "Standard sensor", + Averaging + "Averaging sensor", + InWell + "Sensor in well") + "Enumeration to specify the type of temperature sensor"; + type SensorVolumeFlowRate = enumeration( + AFMS + "Airflow measuring station", + FlowCross + "Flow cross", + FlowMeter + "Flow meter") + "Enumeration to specify the type of volume flow rate sensor"; + // RFE: Add support for PICV. + type Valve = enumeration( + None + "No valve", + PumpedCoilThreeWay + "Pumped coil with three-way valve", + PumpedCoilTwoWay + "Pumped coil with two-way valve", + ThreeWayModulating + "Three-way modulating valve", + ThreeWayTwoPosition + "Three-way two-position valve", + TwoWayModulating + "Two-way modulating valve", + TwoWayTwoPosition + "Two-way two-position valve") + "Enumeration to configure the valve"; + annotation (Documentation(info=" ++This package contains type definitions. +
+")); +end Types; diff --git a/Buildings/Templates/Components/Validation/Coils.mo b/Buildings/Templates/Components/Validation/Coils.mo new file mode 100644 index 00000000000..5c4c4af962c --- /dev/null +++ b/Buildings/Templates/Components/Validation/Coils.mo @@ -0,0 +1,289 @@ +within Buildings.Templates.Components.Validation; +model Coils "Validation model for coil components" + extends Modelica.Icons.Example; + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + replaceable package MediumLiq=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "HW or CHW medium"; + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.FixedInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + Fluid.Sources.Boundary_pT bouAirEntCoo( + redeclare final package Medium = MediumAir, + X={coiCoo.dat.wAirEnt_nominal/(1 + coiCoo.dat.wAirEnt_nominal),1 - coiCoo.dat.wAirEnt_nominal + /(1 + coiCoo.dat.wAirEnt_nominal)}, + p=bouAirLvg.p + coiCoo.dat.dpAir_nominal, + T=coiCoo.dat.TAirEnt_nominal, + nPorts=2) "Boundary conditions for entering air" + annotation (Placement(transformation(extent={{-90,110},{-70,130}}))); + Fluid.Sources.Boundary_pT bouChiWatEnt( + redeclare final package Medium = MediumLiq, + p=bouLiqLvg.p + coiCoo.dat.dpWat_nominal + coiCoo.dat.dpValve_nominal, + T=coiCoo.dat.TWatEnt_nominal, + nPorts=1) "Boundary conditions for entering CHW" + annotation (Placement(transformation(extent={{110,70},{90,90}}))); + Fluid.Sources.Boundary_pT bouLiqLvg( + redeclare final package Medium =MediumLiq, nPorts=2) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{-90,70},{-70,90}}))); + Fluid.Sources.Boundary_pT bouAirLvg( + redeclare final package Medium =MediumAir, nPorts=6) "Boundary conditions for leaving air" + annotation (Placement(transformation(extent={{110,110},{90,130}}))); + + Buildings.Templates.Components.Coils.WaterBasedCooling coiCoo( + redeclare final package MediumAir=MediumAir, + redeclare final package MediumChiWat=MediumLiq, + dat( + mAir_flow_nominal=1, + dpAir_nominal=200, + mWat_flow_nominal=1, + dpWat_nominal=2E4, + dpValve_nominal=coiCoo.dat.dpWat_nominal, + cap_nominal=-5E4, + TWatEnt_nominal=280.15, + TAirEnt_nominal=308.15, + wAirEnt_nominal=0.017), + final energyDynamics=energyDynamics, + redeclare replaceable + Buildings.Templates.Components.Valves.TwoWayModulating val(y_start=0) + "Two-way modulating valve") "Water-based cooling coil" + annotation (Placement(transformation(extent={{10,110},{30,130}}))); + Interfaces.Bus bus "Control bus" + annotation (Placement(transformation(extent={{-20,120},{20, + 160}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Continuous.Sources.Ramp y(height=1, + duration=10) "Coil/valve control signal" + annotation (Placement(transformation(extent={{-90,150},{-70,170}}))); + + Buildings.Templates.Components.Coils.WaterBasedHeating coiHea( + redeclare final package MediumAir = MediumAir, + redeclare final package MediumHeaWat=MediumLiq, + dat( + mAir_flow_nominal=1, + dpAir_nominal=200, + mWat_flow_nominal=1, + dpWat_nominal=2E4, + dpValve_nominal=coiCoo.dat.dpWat_nominal, + cap_nominal=5E4, + TWatEnt_nominal=323.15, + TAirEnt_nominal=263.15), + final energyDynamics=energyDynamics, + redeclare replaceable + Buildings.Templates.Components.Valves.TwoWayModulating val(y_start=0) + "Two-way modulating valve") "Water-based heating" + annotation (Placement(transformation(extent={{10,30},{30,50}}))); + Interfaces.Bus bus1 "Control bus" + annotation (Placement(transformation(extent={{-20,40},{20,80}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Fluid.Sources.Boundary_pT bouAirEntHea( + redeclare final package Medium = MediumAir, + p=bouAirLvg.p + coiHea.dat.dpAir_nominal, + T=coiHea.dat.TAirEnt_nominal, + nPorts=2) "Boundary conditions for entering air" + annotation (Placement(transformation(extent={{-90,30},{-70,50}}))); + Fluid.Sources.Boundary_pT bouHeaWatEnt( + redeclare final package Medium = MediumLiq, + p=bouLiqLvg.p + coiHea.dat.dpWat_nominal + coiHea.dat.dpValve_nominal, + T=coiHea.dat.TWatEnt_nominal, + nPorts=1) "Boundary conditions for entering HW" + annotation (Placement(transformation(extent={{110,10},{90,30}}))); + + Buildings.Templates.Components.Coils.ElectricHeating coiEle( + redeclare final package MediumAir = MediumAir, + dat( + mAir_flow_nominal=1, + dpAir_nominal=200, + cap_nominal=5E4), + final energyDynamics=energyDynamics) "Electric heating" + annotation (Placement(transformation(extent={{10,-50},{30,-30}}))); + Interfaces.Bus bus2 "Control bus" + annotation (Placement(transformation(extent={{-20,-40},{20,0}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Buildings.Templates.Components.Coils.EvaporatorVariableSpeed coiEva( + redeclare final package MediumAir = MediumAir, + dat(dpAir_nominal=200), + final energyDynamics=energyDynamics) "Variable speed evaporator coil" + annotation (Placement(transformation(extent={{10,-110},{30,-90}}))); + BoundaryConditions.WeatherData.Bus + weaBus "Weather data bus" annotation (Placement(transformation(extent={{-50, + -110},{-10,-70}}), iconTransformation(extent={{190,-10},{210,10}}))); + Interfaces.Bus bus3 "Control bus" + annotation (Placement(transformation(extent={{-20,-100},{20,-60}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TOut(k=coiEva.dat.datCoi.sta[1].nomVal.TConIn_nominal) + "Outdoor temperature" + annotation (Placement(transformation(extent={{-130,-110},{-110,-90}}))); + Controls.OBC.CDL.Continuous.Sources.Constant XOut(k=0.015) + "Water mass fraction in outdoor air" + annotation (Placement(transformation(extent={{-130,-150},{-110,-130}}))); + Utilities.Psychrometrics.TWetBul_TDryBulXi wetBul( + redeclare final package Medium = MediumAir) + "Compute wet bulb temperature" + annotation (Placement(transformation(extent={{-60,-130},{-40,-110}}))); + Controls.OBC.CDL.Continuous.Sources.Constant pOut(k=101325) + "Outdoor pressure" + annotation (Placement(transformation(extent={{-130,-190},{-110,-170}}))); + Fluid.Sources.Boundary_pT bouAirEntCoo1( + redeclare final package Medium = MediumAir, + use_Xi_in=true, + p=bouAirLvg.p + coiEva.dat.dpAir_nominal, + T=coiEva.dat.datCoi.sta[1].nomVal.TEvaIn_nominal, + nPorts=2) "Boundary conditions for entering air" + annotation (Placement(transformation(extent={{-90,-70},{-70,-50}}))); + Utilities.Psychrometrics.X_pTphi x_pTphi(use_p_in=false) + "Compute wet bulb temperature" + annotation (Placement(transformation(extent={{-88,-10},{-68,10}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TAirEnt(k=coiEva.dat.datCoi.sta[1].nomVal.TEvaIn_nominal) + "Entering air temperature" + annotation (Placement(transformation(extent={{-130,10},{-110,30}}))); + Controls.OBC.CDL.Continuous.Sources.Constant phiAirEnt(k=coiEva.dat.datCoi.sta[1].nomVal.phiIn_nominal) + "Enetring air relative humidity" + annotation (Placement(transformation(extent={{-130,-30},{-110,-10}}))); + Buildings.Templates.Components.Coils.EvaporatorMultiStage coiMul( + redeclare final package MediumAir = MediumAir, + dat( + redeclare + Buildings.Fluid.DXSystems.Cooling.AirSource.Data.DoubleSpeed.Lennox_SCA240H4B + datCoi, + dpAir_nominal=200), + final energyDynamics=energyDynamics) "Multiple stage evaporator coil" + annotation (Placement(transformation(extent={{10,-170},{30,-150}}))); + Controls.OBC.CDL.Integers.Sources.TimeTable y1( + table=[0,0; 1,1; 2,2], + timeScale=50, + period=200) "Coil/valve control signal" + annotation (Placement(transformation(extent={{-80,-190},{-60,-170}}))); + Interfaces.Bus bus4 "Control bus" + annotation (Placement(transformation(extent={{-20,-160},{20,-120}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium = MediumAir, + final m_flow_nominal=coiCoo.dat.mAir_flow_nominal, + final dp_nominal=coiCoo.dat.dpAir_nominal) "Flow resistance" + annotation (Placement(transformation(extent={{-30,170},{-10,190}}))); + Buildings.Templates.Components.Coils.None non( + redeclare final package MediumAir =MediumAir) "No coilamper" + annotation (Placement(transformation(extent={{10,170},{30,190}}))); +equation + connect(bouAirEntCoo.ports[1], coiCoo.port_a) annotation (Line(points={{-70,119}, + {-30,119},{-30,120},{10,120}}, color={0,127,255})); + connect(coiCoo.port_b, bouAirLvg.ports[1]) annotation (Line(points={{30,120}, + {60,120},{60,118.333},{90,118.333}}, + color={0,127,255})); + connect(bouChiWatEnt.ports[1], coiCoo.port_aSou) + annotation (Line(points={{90,80},{25,80},{25,110}}, + color={0,127,255})); + connect(bouLiqLvg.ports[1], coiCoo.port_bSou) + annotation (Line(points={{-70,79},{15,79},{15,110}}, + color={0,127,255})); + connect(y.y, bus.y) annotation (Line(points={{-68,160},{0,160},{0,140}}, + color={0,0,127})); + connect(bus, coiCoo.bus) annotation (Line( + points={{0,140},{20,140},{20,130}}, + color={255,204,51}, + thickness=0.5)); + connect(coiHea.bus, bus1) annotation (Line( + points={{20,50},{20,60},{0,60}}, + color={255,204,51}, + thickness=0.5)); + connect(y.y, bus1.y) + annotation (Line(points={{-68,160},{0,160},{0,60}}, color={0,0,127})); + connect(bouAirEntHea.ports[1], coiHea.port_a) annotation (Line(points={{-70,39}, + {-16,39},{-16,40},{10,40}}, color={0,127,255})); + connect(coiHea.port_b, bouAirLvg.ports[2]) annotation (Line(points={{30,40},{60, + 40},{60,119},{90,119}}, color={0,127,255})); + connect(bouHeaWatEnt.ports[1], coiHea.port_aSou) + annotation (Line(points={{90,20},{25,20},{25,30}}, color={0,127,255})); + connect(coiHea.port_bSou, bouLiqLvg.ports[2]) annotation (Line(points={{15,30}, + {15,20},{-20,20},{-20,81},{-70,81}}, color={0,127,255})); + connect(bouAirEntHea.ports[2], coiEle.port_a) annotation (Line(points={{-70,41}, + {-40,41},{-40,-40},{10,-40}}, color={0,127,255})); + connect(coiEle.bus, bus2) annotation (Line( + points={{20,-30},{20,-20},{0,-20}}, + color={255,204,51}, + thickness=0.5)); + connect(coiEle.port_b, bouAirLvg.ports[3]) annotation (Line(points={{30,-40}, + {64,-40},{64,119.667},{90,119.667}}, color={0,127,255})); + connect(y.y, bus2.y) + annotation (Line(points={{-68,160},{0,160},{0,-20}}, color={0,0,127})); + connect(coiEva.port_b, bouAirLvg.ports[4]) annotation (Line(points={{30,-100}, + {68,-100},{68,118},{90,118},{90,120.333}}, + color={0,127,255})); + connect(bus3, coiEva.bus) annotation (Line( + points={{0,-80},{20,-80},{20,-90}}, + color={255,204,51}, + thickness=0.5)); + connect(weaBus, coiEva.busWea) annotation (Line( + points={{-30,-90},{16,-90}}, + color={255,204,51}, + thickness=0.5)); + connect(y.y, bus3.y) annotation (Line(points={{-68,160},{0,160},{0,-80}}, + color={0,0,127})); + connect(TOut.y, weaBus.TDryBul) annotation (Line(points={{-108,-100},{-70,-100}, + {-70,-90},{-30,-90}}, color={0,0,127})); + connect(TOut.y, wetBul.TDryBul) annotation (Line(points={{-108,-100},{-70,-100}, + {-70,-112},{-61,-112}}, color={0,0,127})); + connect(pOut.y, wetBul.p) annotation (Line(points={{-108,-180},{-100,-180},{-100, + -128},{-61,-128}}, color={0,0,127})); + connect(wetBul.TWetBul, weaBus.TWetBul) annotation (Line(points={{-39,-120},{-32, + -120},{-32,-90},{-30,-90}}, + color={0,0,127})); + connect(XOut.y, wetBul.Xi[1]) annotation (Line(points={{-108,-140},{-84,-140}, + {-84,-120},{-61,-120}}, color={0,0,127})); + connect(bouAirEntCoo1.ports[1], coiEva.port_a) annotation (Line(points={{-70,-61}, + {-14,-61},{-14,-100},{10,-100}}, + color={0,127,255})); + connect(phiAirEnt.y, x_pTphi.phi) annotation (Line(points={{-108,-20},{-100,-20}, + {-100,-6},{-90,-6}}, color={0,0,127})); + connect(TAirEnt.y, x_pTphi.T) annotation (Line(points={{-108,20},{-100,20},{-100, + 0},{-90,0}}, color={0,0,127})); + connect(x_pTphi.X[1], bouAirEntCoo1.Xi_in[1]) annotation (Line(points={{-67,0}, + {-60,0},{-60,-20},{-96,-20},{-96,-64},{-92,-64}}, color={0,0,127})); + connect(coiMul.port_b, bouAirLvg.ports[5]) annotation (Line(points={{30,-160}, + {72,-160},{72,121},{90,121}}, color={0,127,255})); + connect(bouAirEntCoo1.ports[2], coiMul.port_a) annotation (Line(points={{-70,-59}, + {-70,-60},{-14,-60},{-14,-160},{10,-160}}, color={0,127,255})); + connect(weaBus, coiMul.busWea) annotation (Line( + points={{-30,-90},{-30,-150},{16,-150}}, + color={255,204,51}, + thickness=0.5)); + connect(y1.y[1], bus4.y) annotation (Line(points={{-58,-180},{0,-180},{0,-140}}, + color={255,127,0})); + connect(coiMul.bus, bus4) annotation (Line(points={{20,-150},{20,-140},{ + 0,-140}}, + color={255,127,0})); + connect(res.port_b, non.port_a) annotation (Line(points={{-10,180},{-2,180},{-2, + 180},{10,180}}, color={0,127,255})); + connect(non.port_b, bouAirLvg.ports[6]) annotation (Line(points={{30,180},{90, + 180},{90,121.667}}, color={0,127,255})); + connect(bouAirEntCoo.ports[2], res.port_a) annotation (Line(points={{-70,121}, + {-40,121},{-40,180},{-30,180}}, color={0,127,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Coils.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=200), + Diagram(coordinateSystem(extent={{-140,-200},{140,200}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Coils +by exposing them to a fixed pressure difference on +the air side. +Models representing a water-based coil with valve +are also exposed to a fixed pressure difference on the +water side, and a varying valve opening from fully closed +to fully open position. +Other coil models are controlled with a signal varying +from 0 to 1. +
+")); +end Coils; diff --git a/Buildings/Templates/Components/Validation/Dampers.mo b/Buildings/Templates/Components/Validation/Dampers.mo new file mode 100644 index 00000000000..f27632b1d1f --- /dev/null +++ b/Buildings/Templates/Components/Validation/Dampers.mo @@ -0,0 +1,119 @@ +within Buildings.Templates.Components.Validation; +model Dampers "Validation model for damper components" + extends Modelica.Icons.Example; + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + + Fluid.Sources.Boundary_pT bouAirEnt( + redeclare final package Medium = MediumAir, + p=bouAirLvg.p + mod.dat.dp_nominal, + nPorts=4) "Boundary conditions for entering air" + annotation (Placement(transformation(extent={{-90,50},{-70,70}}))); + Fluid.Sources.Boundary_pT bouAirLvg( + redeclare final package Medium =MediumAir, nPorts=4) "Boundary conditions for leaving air" + annotation (Placement(transformation(extent={{110,50},{90,70}}))); + + Buildings.Templates.Components.Dampers.Modulating mod( + y_start=0, + redeclare final package Medium = MediumAir, + dat(m_flow_nominal=1, + dp_nominal=50)) "Modulating damper" + annotation (Placement(transformation(extent={{10,50},{30,70}}))); + Interfaces.Bus bus + "Control bus" + annotation (Placement(transformation(extent={{-20,60},{20,100}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Continuous.Sources.Ramp y(height=1, + duration=10) "Damper control signal" + annotation (Placement(transformation(extent={{-90,90},{-70,110}}))); + + Buildings.Templates.Components.Dampers.PressureIndependent pre( + y_start=0, + redeclare final package Medium = MediumAir, + dat(m_flow_nominal=1, dp_nominal=50)) + "Pressure independent damper" + annotation (Placement(transformation(extent={{10,-10},{30,10}}))); + Interfaces.Bus bus1 + "Control bus" + annotation (Placement(transformation(extent={{-20,0},{20,40}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Buildings.Templates.Components.Dampers.TwoPosition two( + y_start=0, + redeclare final package Medium = MediumAir, + dat(m_flow_nominal=1, dp_nominal=50)) "Two-position damper" + annotation (Placement(transformation(extent={{10,-70},{30,-50}}))); + Interfaces.Bus bus2 + "Control bus" + annotation (Placement(transformation(extent={{-20,-60},{20,-20}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Logical.Sources.TimeTable y1( + table=[0,0; 1,1], + timeScale=10, + period=200) "Damper control signal" + annotation (Placement(transformation(extent={{-90,-30},{-70,-10}}))); + Buildings.Templates.Components.Dampers.None non( + redeclare final package Medium = MediumAir) "No damper" + annotation (Placement(transformation(extent={{10,-110},{30,-90}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium = MediumAir, + final m_flow_nominal=mod.dat.m_flow_nominal, + final dp_nominal=mod.dat.dp_nominal) "Flow resistance" + annotation (Placement(transformation(extent={{-30,-110},{-10,-90}}))); +equation + connect(bouAirEnt.ports[1], mod.port_a) + annotation (Line(points={{-70,58.5},{-70,60},{10,60}}, + color={0,127,255})); + connect(mod.port_b, bouAirLvg.ports[1]) + annotation (Line(points={{30,60},{60,60},{60,58.5},{90,58.5}}, + color={0,127,255})); + connect(y.y, bus.y) annotation (Line(points={{-68,100},{0,100},{0,80}}, + color={0,0,127})); + connect(bus, mod.bus) annotation (Line( + points={{0,80},{20,80},{20,70}}, + color={255,204,51}, + thickness=0.5)); + connect(bouAirEnt.ports[2], pre.port_a) annotation (Line(points={{-70,59.5},{-38, + 59.5},{-38,0},{10,0}}, color={0,127,255})); + connect(pre.port_b, bouAirLvg.ports[2]) annotation (Line(points={{30,0},{60,0}, + {60,59.5},{90,59.5}}, color={0,127,255})); + connect(bus1, pre.bus) annotation (Line( + points={{0,20},{20,20},{20,10}}, + color={255,204,51}, + thickness=0.5)); + connect(y.y, bus1.y) + annotation (Line(points={{-68,100},{0,100},{0,20}}, + color={0,0,127})); + connect(bouAirEnt.ports[3], two.port_a) annotation (Line(points={{-70,60.5},{-38, + 60.5},{-38,-60},{10,-60}}, color={0,127,255})); + connect(two.port_b, bouAirLvg.ports[3]) annotation (Line(points={{30,-60},{60, + -60},{60,60.5},{90,60.5}}, color={0,127,255})); + connect(bus2, two.bus) annotation (Line( + points={{0,-40},{20,-40},{20,-50}}, + color={255,204,51}, + thickness=0.5)); + connect(y1.y[1], bus2.y1) + annotation (Line(points={{-68,-20},{0,-20},{0,-40}}, color={255,0,255})); + connect(non.port_b, bouAirLvg.ports[4]) annotation (Line(points={{30,-100},{60, + -100},{60,61.5},{90,61.5}}, color={0,127,255})); + connect(bouAirEnt.ports[4], res.port_a) annotation (Line(points={{-70,61.5},{-40, + 61.5},{-40,-100},{-30,-100}}, color={0,127,255})); + connect(res.port_b, non.port_a) + annotation (Line(points={{-10,-100},{10,-100}}, color={0,127,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Dampers.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=200), + Diagram(coordinateSystem(extent={{-140,-140},{140,140}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Dampers +by exposing them to a fixed pressure difference +and a control signal varying from 0 to 1. +
+")); +end Dampers; diff --git a/Buildings/Templates/Components/Validation/Fans.mo b/Buildings/Templates/Components/Validation/Fans.mo new file mode 100644 index 00000000000..a6d3934fa04 --- /dev/null +++ b/Buildings/Templates/Components/Validation/Fans.mo @@ -0,0 +1,147 @@ +within Buildings.Templates.Components.Validation; +model Fans "Validation model for fans components" + extends Modelica.Icons.Example; + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.FixedInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + Fluid.Sources.Boundary_pT bou( + redeclare final package Medium = MediumAir, + nPorts=8) "Boundary conditions" + annotation (Placement(transformation(extent={{-80,-10},{-60,10}}))); + Buildings.Templates.Components.Fans.ArrayVariable arr( + redeclare final package Medium=MediumAir, + have_senFlo=true, + final energyDynamics=energyDynamics, + dat(m_flow_nominal=1, dp_nominal=1000), + nFan=4) + "Fan array" + annotation (Placement(transformation(extent={{-10,70},{10,90}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium=MediumAir, + final m_flow_nominal=arr.dat.m_flow_nominal, + final dp_nominal=arr.dat.dp_nominal) + "Ducts and coils equivalent flow resistance" + annotation (Placement(transformation(extent={{40,70},{60,90}}))); + Controls.OBC.CDL.Continuous.Sources.Ramp y(height=1, duration=10) + "Fan control signal" + annotation (Placement(transformation(extent={{-80,110},{-60,130}}))); + Interfaces.Bus bus "Control bus" + annotation (Placement(transformation(extent={{-40,100},{0,140}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Logical.Sources.TimeTable y1( + table=[0,0; 1,1], + timeScale=10, + period=100) "Fan start/stop signal" + annotation (Placement(transformation(extent={{-80,150},{-60,170}}))); + Buildings.Templates.Components.Fans.SingleVariable var( + redeclare final package Medium=MediumAir, + have_senFlo=true, + final energyDynamics=energyDynamics, + dat(m_flow_nominal=1, dp_nominal=1000)) "Variable speed fan" + annotation (Placement(transformation(extent={{-10,-90},{10,-70}}))); + Interfaces.Bus bus1 "Control bus" + annotation (Placement(transformation(extent={{-40,0},{0,40}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Buildings.Templates.Components.Fans.SingleConstant cst( + redeclare final package Medium=MediumAir, + have_senFlo=true, + final energyDynamics=energyDynamics, + dat(m_flow_nominal=1, dp_nominal=1000)) "Constant speed fan" + annotation (Placement(transformation(extent={{-10,-30},{10,-10}}))); + Fluid.FixedResistances.PressureDrop res1( + redeclare final package Medium = MediumAir, + final m_flow_nominal=cst.dat.m_flow_nominal, + final dp_nominal=cst.dat.dp_nominal) + "Ducts and coils equivalent flow resistance" + annotation (Placement(transformation(extent={{40,-30},{60,-10}}))); + Fluid.FixedResistances.PressureDrop res2( + redeclare final package Medium = MediumAir, + final m_flow_nominal=var.dat.m_flow_nominal, + final dp_nominal=var.dat.dp_nominal) + "Ducts and coils equivalent flow resistance" + annotation (Placement(transformation(extent={{40,-90},{60,-70}}))); + Interfaces.Bus bus2 + "Control bus" annotation (Placement(transformation(extent={{-40,-80},{0,-40}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Buildings.Templates.Components.Fans.None non( + redeclare final package Medium = MediumAir) + "No fan" + annotation (Placement(transformation(extent={{-10,-150},{10,-130}}))); + Fluid.FixedResistances.PressureDrop res3( + redeclare final package Medium = MediumAir, + final m_flow_nominal=1, + final dp_nominal=1000) + "Ducts and coils equivalent flow resistance" + annotation (Placement(transformation(extent={{40,-150},{60,-130}}))); +equation + connect(bou.ports[1], arr.port_a) annotation (Line(points={{-60,-1.75},{-60,80}, + {-10,80}}, color={0,127,255})); + connect(res.port_b, bou.ports[2]) annotation (Line(points={{60,80},{80,80},{80, + -1.25},{-60,-1.25}}, color={0,127,255})); + connect(arr.port_b, res.port_a) + annotation (Line(points={{10,80},{40,80}}, color={0,127,255})); + connect(y.y, bus.y) annotation (Line(points={{-58,120},{-20,120}}, + color={0,0,127})); + connect(bus, arr.bus) annotation (Line( + points={{-20,120},{0,120},{0,90}}, + color={255,204,51}, + thickness=0.5)); + connect(y1.y[1], bus.y1) annotation (Line(points={{-58,160},{-20,160},{-20,120}}, + color={255,0,255})); + connect(y1.y[1], bus1.y1) annotation (Line(points={{-58,160},{-20,160},{-20,20}}, + color={255,0,255})); + connect(cst.port_b, res1.port_a) annotation (Line(points={{10,-20},{40,-20}}, + color={0,127,255})); + connect(bou.ports[3], cst.port_a) annotation (Line(points={{-60,-0.75},{-60,-20}, + {-10,-20}}, color={0,127,255})); + connect(res1.port_b, bou.ports[4]) annotation (Line(points={{60,-20},{80,-20}, + {80,-0.25},{-60,-0.25}}, color={0,127,255})); + connect(res2.port_b, bou.ports[5]) annotation (Line(points={{60,-80},{80,-80}, + {80,0.25},{-60,0.25}}, + color={0,127,255})); + connect(bou.ports[6], var.port_a) annotation (Line(points={{-60,0.75},{-60,-80}, + {-10,-80}}, color={0,127,255})); + connect(var.port_b, res2.port_a) + annotation (Line(points={{10,-80},{40,-80}}, color={0,127,255})); + connect(bus2, var.bus) annotation (Line( + points={{-20,-60},{0,-60},{0,-70}}, + color={255,204,51}, + thickness=0.5)); + connect(bus1, cst.bus) annotation (Line( + points={{-20,20},{0,20},{0,-10}}, + color={255,204,51}, + thickness=0.5)); + connect(y.y, bus2.y) annotation (Line(points={{-58,120},{-40,120},{-40,-60},{-20, + -60}}, color={0,0,127})); + connect(bou.ports[7], non.port_a) annotation (Line(points={{-60,1.25},{-60,-140}, + {-10,-140}}, color={0,127,255})); + connect(non.port_b, res3.port_a) annotation (Line(points={{10,-140},{25,-140}, + {25,-140},{40,-140}}, color={0,127,255})); + connect(res3.port_b, bou.ports[8]) annotation (Line(points={{60,-140},{80,-140}, + {80,1.75},{-60,1.75}}, color={0,127,255})); + connect(y1.y[1], bus2.y1) annotation (Line(points={{-58,160},{-20,160},{-20,-60}}, + color={255,0,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Fans.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=200), + Diagram(coordinateSystem(extent={{-140,-180},{140,180}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Fans +by exposing them to a control signal varying from 0 to 1 +and connecting them to an air loop with a fixed flow resistance, which +is sized based on the nominal operating point of the fan model. +
+")); +end Fans; diff --git a/Buildings/Templates/Components/Validation/Routing.mo b/Buildings/Templates/Components/Validation/Routing.mo new file mode 100644 index 00000000000..782e491b3ef --- /dev/null +++ b/Buildings/Templates/Components/Validation/Routing.mo @@ -0,0 +1,165 @@ +within Buildings.Templates.Components.Validation; +model Routing "Validation model for routing components" + extends Modelica.Icons.Example; + + replaceable package Medium=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Medium"; + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.FixedInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + Fluid.Sources.Boundary_pT bouLiqEnt( + redeclare final package Medium = Medium, + p=bouLiqLvg.p + min(res.dp_nominal), + nPorts=3) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-80,70},{-60,90}}))); + Fluid.Sources.Boundary_pT bouLiqLvg(redeclare final package Medium = Medium, + nPorts=3) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{80,70},{60,90}}))); + Fluid.FixedResistances.PressureDrop res[3]( + redeclare final package Medium = Medium, + each m_flow_nominal=1, + each dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{-40,70},{-20,90}}))); + Buildings.Templates.Components.Routing.MultipleToMultiple mulMul( + redeclare final package Medium = Medium, + final energyDynamics=energyDynamics, + nPorts_a=3, + m_flow_nominal=3) "Multiple to multiple without common leg" + annotation (Placement(transformation(extent={{0,70},{20,90}}))); + Fluid.Sources.Boundary_pT bouLiqEnt1( + redeclare final package Medium = Medium, + p=bouLiqLvg.p + min(res1.dp_nominal) + min(res2.dp_nominal), + nPorts=3) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-80,30},{-60,50}}))); + Fluid.Sources.Boundary_pT bouLiqLvg1(redeclare final package Medium = Medium, + nPorts=3) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{80,30},{60,50}}))); + Fluid.FixedResistances.PressureDrop res1 + [3]( + redeclare final package Medium = Medium, + each m_flow_nominal=1, + each dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{-40,30},{-20,50}}))); + Buildings.Templates.Components.Routing.MultipleToMultiple mulMulCom( + redeclare final package Medium = Medium, + final energyDynamics=energyDynamics, + nPorts_a=3, + have_comLeg=true, + m_flow_nominal=3) "Multiple to multiple with common leg" + annotation (Placement(transformation(extent={{0,30},{20,50}}))); + Fluid.FixedResistances.PressureDrop res2[3]( + redeclare final package Medium = Medium, + each m_flow_nominal=1, + each dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{30,30},{50,50}}))); + Fluid.Sources.Boundary_pT bouLiqEnt2( + redeclare final package Medium = Medium, + p=bouLiqLvg.p + min(res3.dp_nominal), + nPorts=3) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-80,-10},{-60,10}}))); + Fluid.Sources.Boundary_pT bouLiqLvg2(redeclare final package Medium = Medium, + nPorts=1) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{80,-10},{60,10}}))); + Fluid.FixedResistances.PressureDrop res3 + [3]( + redeclare final package Medium = Medium, + each m_flow_nominal=1, + each dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{-40,-10},{-20,10}}))); + Buildings.Templates.Components.Routing.MultipleToSingle mulSin( + redeclare final package Medium = Medium, + final energyDynamics=energyDynamics, + nPorts=3, + m_flow_nominal=3) "Multiple to single" + annotation (Placement(transformation(extent={{0,-10},{20,10}}))); + Fluid.Sources.Boundary_pT bouLiqEnt3( + redeclare final package Medium = Medium, + p=bouLiqLvg.p + min(res5.dp_nominal), + nPorts=1) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-80,-50},{-60,-30}}))); + Fluid.Sources.Boundary_pT bouLiqLvg3(redeclare final package Medium = Medium, + nPorts=3) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{80,-50},{60,-30}}))); + Buildings.Templates.Components.Routing.SingleToMultiple sinMul( + redeclare final package Medium = Medium, + final energyDynamics=energyDynamics, + nPorts=3, + m_flow_nominal=3) "Single to multiple" + annotation (Placement(transformation(extent={{0,-50},{20,-30}}))); + Fluid.FixedResistances.PressureDrop res5[3]( + redeclare final package Medium = Medium, + each m_flow_nominal=1, + each dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{30,-50},{50,-30}}))); + Fluid.Sources.Boundary_pT bouLiqEnt4( + redeclare final package Medium = Medium, + p=bouLiqLvg.p + res4.dp_nominal, + nPorts=1) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-80,-90},{-60,-70}}))); + Fluid.Sources.Boundary_pT bouLiqLvg4(redeclare final package Medium = Medium, + nPorts=1) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{80,-90},{60,-70}}))); + Buildings.Templates.Components.Routing.PassThroughFluid pas(redeclare final + package Medium = Medium) "Pass through" + annotation (Placement(transformation(extent={{0,-90},{20,-70}}))); + Fluid.FixedResistances.PressureDrop res4( + redeclare final package Medium = Medium, + m_flow_nominal=1, + dp_nominal=1000) "Flow resistance" + annotation (Placement(transformation(extent={{-40,-90},{-20,-70}}))); +equation + connect(res.port_b, mulMul.ports_a) + annotation (Line(points={{-20,80},{0,80}}, color={0,127,255})); + connect(mulMul.ports_b, bouLiqLvg.ports) + annotation (Line(points={{20,80},{60,80}}, color={0,127,255})); + connect(bouLiqEnt.ports, res.port_a) + annotation (Line(points={{-60,80},{-40,80}}, color={0,127,255})); + connect(res1.port_b, mulMulCom.ports_a) + annotation (Line(points={{-20,40},{0,40}}, color={0,127,255})); + connect(bouLiqEnt1.ports, res1.port_a) + annotation (Line(points={{-60,40},{-40,40}}, color={0,127,255})); + connect(mulMulCom.ports_b, res2.port_a) + annotation (Line(points={{20,40},{30,40}}, color={0,127,255})); + connect(res2.port_b, bouLiqLvg1.ports) annotation (Line(points={{50,40},{56,40}, + {56,40},{60,40}}, color={0,127,255})); + connect(res3.port_b, mulSin.ports_a) + annotation (Line(points={{-20,0},{0,0}}, color={0,127,255})); + connect(bouLiqEnt2.ports,res3. port_a) + annotation (Line(points={{-60,0},{-40,0}}, color={0,127,255})); + connect(mulSin.port_b, bouLiqLvg2.ports[1]) + annotation (Line(points={{20,0},{60,0}}, color={0,127,255})); + connect(bouLiqEnt3.ports[1], sinMul.port_a) annotation (Line(points={{-60,-40}, + {-30,-40},{-30,-40},{0,-40}}, color={0,127,255})); + connect(sinMul.ports_b, res5.port_a) + annotation (Line(points={{20,-40},{30,-40}}, color={0,127,255})); + connect(res5.port_b, bouLiqLvg3.ports) + annotation (Line(points={{50,-40},{60,-40}}, color={0,127,255})); + connect(pas.port_b, bouLiqLvg4.ports[1]) annotation (Line(points={{20,-80},{40, + -80},{40,-80},{60,-80}}, color={0,127,255})); + connect(bouLiqEnt4.ports[1], res4.port_a) + annotation (Line(points={{-60,-80},{-40,-80}}, color={0,127,255})); + connect(res4.port_b, pas.port_a) + annotation (Line(points={{-20,-80},{0,-80}}, color={0,127,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Routing.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), + Diagram(coordinateSystem(extent={{-100,-120},{100,120}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Routing +by exposing them to a fixed pressure difference. +
+")); +end Routing; diff --git a/Buildings/Templates/Components/Validation/Sensors.mo b/Buildings/Templates/Components/Validation/Sensors.mo new file mode 100644 index 00000000000..0aee73ad70d --- /dev/null +++ b/Buildings/Templates/Components/Validation/Sensors.mo @@ -0,0 +1,111 @@ +within Buildings.Templates.Components.Validation; +model Sensors "Validation model for sensor components" + extends Modelica.Icons.Example; + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + + Fluid.Sources.Boundary_pT bouAirEnt( + redeclare final package Medium = MediumAir, + p=bouAirLvg.p + res.dp_nominal, + nPorts=6) "Boundary conditions for entering air" + annotation (Placement(transformation(extent={{-80,30},{-60,50}}))); + Fluid.Sources.Boundary_pT bouAirLvg(redeclare final package Medium = + MediumAir, nPorts=6) "Boundary conditions for leaving air" + annotation (Placement(transformation(extent={{80,30},{60,50}}))); + Buildings.Templates.Components.Sensors.HumidityRatio hum(redeclare final + package Medium = MediumAir, m_flow_nominal=1) "Humidity ratio" + annotation (Placement(transformation(extent={{0,30},{20,50}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium = MediumAir, + final m_flow_nominal=1, + final dp_nominal=100) "Flow resistance" + annotation (Placement(transformation(extent={{-30,30},{-10,50}}))); + Fluid.FixedResistances.PressureDrop res1( + redeclare final package Medium = MediumAir, + final m_flow_nominal=1, + final dp_nominal=100) "Flow resistance" + annotation (Placement(transformation(extent={{-30,-10},{-10,10}}))); + Buildings.Templates.Components.Sensors.SpecificEnthalpy ent(redeclare final + package Medium = MediumAir, m_flow_nominal=1) "Specific enthalpy" + annotation (Placement(transformation(extent={{0,-10},{20,10}}))); + Buildings.Templates.Components.Sensors.DifferentialPressure dp(redeclare + final package Medium = MediumAir) "Differential pressure" + annotation (Placement(transformation(extent={{0,60},{20,80}}))); + Fluid.FixedResistances.PressureDrop res2( + redeclare final package Medium = MediumAir, + final m_flow_nominal=1, + final dp_nominal=100) "Flow resistance" + annotation (Placement(transformation(extent={{-30,-50},{-10,-30}}))); + Buildings.Templates.Components.Sensors.Temperature tem(redeclare final + package Medium = MediumAir, m_flow_nominal=1) "Temperature" + annotation (Placement(transformation(extent={{0,-50},{20,-30}}))); + Buildings.Templates.Components.Sensors.VolumeFlowRate vol(redeclare final + package Medium = MediumAir, m_flow_nominal=1, + typ=Buildings.Templates.Components.Types.SensorVolumeFlowRate.AFMS) "Volume flow rate" + annotation (Placement(transformation(extent={{0,-90},{20,-70}}))); + Fluid.FixedResistances.PressureDrop res3( + redeclare final package Medium = MediumAir, + final m_flow_nominal=1, + final dp_nominal=100) "Flow resistance" + annotation (Placement(transformation(extent={{-30,-90},{-10,-70}}))); + Buildings.Templates.Components.Sensors.DifferentialPressure noDp(redeclare + final package Medium = MediumAir, have_sen=false) + "No differential pressure sensor" + annotation (Placement(transformation(extent={{0,90},{20,110}}))); +equation + connect(bouAirEnt.ports[1], res.port_a) + annotation (Line(points={{-60,38.3333},{-50,38.3333},{-50,40},{-30,40}}, + color={0,127,255})); + connect(res.port_b, hum.port_a) + annotation (Line(points={{-10,40},{0,40}}, color={0,127,255})); + connect(hum.port_b, bouAirLvg.ports[1]) annotation (Line(points={{20,40},{50, + 40},{50,38.3333},{60,38.3333}}, + color={0,127,255})); + connect(res1.port_b, ent.port_a) + annotation (Line(points={{-10,0},{0,0}}, color={0,127,255})); + connect(ent.port_b, bouAirLvg.ports[2]) annotation (Line(points={{20,0},{40,0}, + {40,39},{60,39}}, color={0,127,255})); + connect(bouAirEnt.ports[2], res1.port_a) annotation (Line(points={{-60,39},{-40, + 39},{-40,0},{-30,0}}, color={0,127,255})); + connect(bouAirEnt.ports[3], dp.port_a) annotation (Line(points={{-60,39.6667}, + {-40,39.6667},{-40,70},{0,70}}, + color={0,127,255})); + connect(dp.port_b, bouAirLvg.ports[3]) annotation (Line(points={{20,70},{40, + 70},{40,39.6667},{60,39.6667}}, + color={0,127,255})); + connect(res2.port_b, tem.port_a) + annotation (Line(points={{-10,-40},{0,-40}}, color={0,127,255})); + connect(res3.port_b, vol.port_a) + annotation (Line(points={{-10,-80},{0,-80}}, color={0,127,255})); + connect(tem.port_b, bouAirLvg.ports[4]) annotation (Line(points={{20,-40},{40, + -40},{40,40.3333},{60,40.3333}}, color={0,127,255})); + connect(vol.port_b, bouAirLvg.ports[5]) annotation (Line(points={{20,-80},{40, + -80},{40,41},{60,41}}, color={0,127,255})); + connect(bouAirEnt.ports[4], res2.port_a) annotation (Line(points={{-60, + 40.3333},{-60,38},{-40,38},{-40,-40},{-30,-40}}, + color={0,127,255})); + connect(bouAirEnt.ports[5], res3.port_a) annotation (Line(points={{-60,41},{-40, + 41},{-40,-80},{-30,-80}}, color={0,127,255})); + + connect(bouAirEnt.ports[6], noDp.port_a) annotation (Line(points={{-60, + 41.6667},{-40,41.6667},{-40,100},{0,100}}, + color={0,127,255})); + connect(noDp.port_b, bouAirLvg.ports[6]) annotation (Line(points={{20,100},{ + 40,100},{40,41.6667},{60,41.6667}}, + color={0,127,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Sensors.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), + Diagram(coordinateSystem(extent={{-100,-120},{100,120}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Sensors. +
+")); +end Sensors; diff --git a/Buildings/Templates/Components/Validation/Valves.mo b/Buildings/Templates/Components/Validation/Valves.mo new file mode 100644 index 00000000000..d0704c1e8b0 --- /dev/null +++ b/Buildings/Templates/Components/Validation/Valves.mo @@ -0,0 +1,150 @@ +within Buildings.Templates.Components.Validation; +model Valves "Validation model for valve components" + extends Modelica.Icons.Example; + + replaceable package MediumLiq=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Liquid medium"; + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.FixedInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations")); + + Fluid.Sources.Boundary_pT bouLiqEnt( + redeclare final package Medium = MediumLiq, + p=bouLiqLvg.p + modThr.dat.dpValve_nominal + modThr.dat.dpFixed_nominal, + nPorts=6) "Boundary conditions for entering liquid" + annotation (Placement(transformation(extent={{-90,70},{-70,90}}))); + Fluid.Sources.Boundary_pT bouLiqLvg( + redeclare final package Medium =MediumLiq, nPorts=4) + "Boundary conditions for leaving liquid" + annotation (Placement(transformation(extent={{110,70},{90,90}}))); + + Buildings.Templates.Components.Valves.ThreeWayModulating modThr( + redeclare final package Medium = MediumLiq, + final energyDynamics=energyDynamics, + dat( + m_flow_nominal=1, + dpValve_nominal=5000, + dpFixed_nominal=5000)) + "Three-way modulating valve" + annotation (Placement(transformation(extent={{10,70},{30,90}}))); + Interfaces.Bus bus + "Control bus" + annotation (Placement(transformation(extent={{-20,80},{20,120}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Continuous.Sources.Ramp y(height=1, + duration=10) "Damper control signal" + annotation (Placement(transformation(extent={{-90,110},{-70,130}}))); + + Buildings.Templates.Components.Valves.ThreeWayTwoPosition twoThr( + redeclare final package Medium = MediumLiq, + final energyDynamics=energyDynamics, + dat( + m_flow_nominal=1, + dpValve_nominal=5000, + dpFixed_nominal=5000)) "Three-way two position valve" + annotation (Placement(transformation(extent={{10,-50},{30,-30}}))); + Interfaces.Bus bus1 + "Control bus" + annotation (Placement(transformation(extent={{-20,-40},{20,0}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + + Buildings.Templates.Components.Valves.TwoWayModulating modTwo( + redeclare final package Medium = MediumLiq, + final energyDynamics=energyDynamics, + dat( + m_flow_nominal=1, + dpValve_nominal=5000, + dpFixed_nominal=5000)) "Two-way modulating valve" + annotation (Placement(transformation(extent={{10,10},{30,30}}))); + Interfaces.Bus bus2 + "Control bus" + annotation (Placement(transformation(extent={{-20,20},{20,60}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); + Controls.OBC.CDL.Logical.Sources.TimeTable y1( + table=[0,0; 1,1], + timeScale=10, + period=200) "Damper control signal" + annotation (Placement(transformation(extent={{-90,-10},{-70,10}}))); + Buildings.Templates.Components.Valves.TwoWayTwoPosition twoTwo( + redeclare final package Medium = MediumLiq, + final energyDynamics=energyDynamics, + dat( + m_flow_nominal=1, + dpValve_nominal=5000, + dpFixed_nominal=5000)) "Two-way two-position valve" + annotation (Placement(transformation(extent={{10,-110},{30,-90}}))); + Interfaces.Bus bus3 + "Control bus" + annotation (Placement(transformation(extent={{-20,-100},{20,-60}}), + iconTransformation(extent={{-250,-32},{-210,8}}))); +equation + connect(bouLiqEnt.ports[1], modThr.port_a) + annotation (Line(points={{-70,78.3333},{-30,78.3333},{-30,80},{10,80}}, + color={0,127,255})); + connect(modThr.port_b,bouLiqLvg. ports[1]) + annotation (Line(points={{30,80},{60,80},{60,78.5},{90,78.5}}, + color={0,127,255})); + connect(y.y, bus.y) annotation (Line(points={{-68,120},{0,120},{0,100}}, + color={0,0,127})); + connect(bus, modThr.bus) annotation (Line( + points={{0,100},{20,100},{20,90}}, + color={255,204,51}, + thickness=0.5)); + connect(bouLiqEnt.ports[3], twoThr.port_a) annotation (Line(points={{-70, + 79.6667},{-32,79.6667},{-32,-40},{10,-40}}, + color={0,127,255})); + connect(twoThr.port_b, bouLiqLvg.ports[2]) annotation (Line(points={{30,-40}, + {60,-40},{60,79.5},{90,79.5}}, + color={0,127,255})); + connect(bus1, twoThr.bus) annotation (Line( + points={{0,-20},{20,-20},{20,-30}}, + color={255,204,51}, + thickness=0.5)); + connect(bouLiqEnt.ports[2], modTwo.port_a) annotation (Line(points={{-70,79}, + {-30,79},{-30,20},{10,20}}, color={0,127,255})); + connect(modTwo.port_b, bouLiqLvg.ports[3]) annotation (Line(points={{30,20},{ + 60,20},{60,80.5},{90,80.5}}, + color={0,127,255})); + connect(bus2, modTwo.bus) annotation (Line( + points={{0,40},{20,40},{20,30}}, + color={255,204,51}, + thickness=0.5)); + connect(y.y, bus2.y) + annotation (Line(points={{-68,120},{0,120},{0,40}}, + color={0,0,127})); + connect(y1.y[1], bus1.y1) + annotation (Line(points={{-68,0},{0,0},{0,-20}}, color={255,0,255})); + connect(bus3, twoTwo.bus) annotation (Line( + points={{0,-80},{20,-80},{20,-90}}, + color={255,204,51}, + thickness=0.5)); + connect(y1.y[1],bus3. y1) + annotation (Line(points={{-68,0},{0,0},{0,-80}}, color={255,0,255})); + connect(bouLiqEnt.ports[4], twoTwo.port_a) annotation (Line(points={{-70, + 80.3333},{-40,80.3333},{-40,-100},{10,-100},{10,-100}}, + color={0,127,255})); + connect(twoTwo.port_b, bouLiqLvg.ports[4]) annotation (Line(points={{30,-100}, + {80,-100},{80,81.5},{90,81.5}}, color={0,127,255})); + connect(bouLiqEnt.ports[5], modThr.portByp_a) annotation (Line(points={{-70, + 81},{-36,81},{-36,60},{20,60},{20,70}}, color={0,127,255})); + connect(bouLiqEnt.ports[6], twoThr.portByp_a) annotation (Line(points={{-70, + 81.6667},{-38,81.6667},{-38,-60},{20,-60},{20,-50}}, color={0,127,255})); +annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/Components/Validation/Valves.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=200), + Diagram(coordinateSystem(extent={{-140,-140},{140,140}})), + Documentation(info=" ++This model validates the models within + +Buildings.Templates.Components.Valves +by exposing them to a fixed pressure difference +and a control signal varying from 0 to 1. +
+")); +end Valves; diff --git a/Buildings/Templates/Components/Validation/package.mo b/Buildings/Templates/Components/Validation/package.mo new file mode 100644 index 00000000000..4ffc83e61b6 --- /dev/null +++ b/Buildings/Templates/Components/Validation/package.mo @@ -0,0 +1,12 @@ +within Buildings.Templates.Components; +package Validation "Package with validation models" + extends Modelica.Icons.ExamplesPackage; + + annotation (Documentation(info=" ++This package contains validation models for the classes within + +Buildings.Templates.Components. +
+")); +end Validation; diff --git a/Buildings/Templates/Components/Validation/package.order b/Buildings/Templates/Components/Validation/package.order new file mode 100644 index 00000000000..07f6cebf6fd --- /dev/null +++ b/Buildings/Templates/Components/Validation/package.order @@ -0,0 +1,6 @@ +Coils +Dampers +Fans +Routing +Sensors +Valves diff --git a/Buildings/Templates/Components/Valves/None.mo b/Buildings/Templates/Components/Valves/None.mo new file mode 100644 index 00000000000..1c0915145ec --- /dev/null +++ b/Buildings/Templates/Components/Valves/None.mo @@ -0,0 +1,17 @@ +within Buildings.Templates.Components.Valves; +model None "No valve" + extends Buildings.Templates.Components.Interfaces.PartialValve( + final typ=Buildings.Templates.Components.Types.Valve.None); + +equation + connect(port_a, port_b) + annotation (Line(points={{-100,0},{100,0},{100,0}}, color={0,127,255})); + annotation ( + defaultComponentName="val", + Documentation(info=" ++This is a direct fluid pass-through model to represent +a configuration with no valve. +
+")); +end None; diff --git a/Buildings/Templates/Components/Valves/ThreeWayModulating.mo b/Buildings/Templates/Components/Valves/ThreeWayModulating.mo new file mode 100644 index 00000000000..c5e591ed284 --- /dev/null +++ b/Buildings/Templates/Components/Valves/ThreeWayModulating.mo @@ -0,0 +1,76 @@ +within Buildings.Templates.Components.Valves; +model ThreeWayModulating "Three-way modulating valve" + extends Buildings.Templates.Components.Interfaces.PartialValve( + final typ=Buildings.Templates.Components.Types.Valve.ThreeWayModulating); + + replaceable Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear val + constrainedby Buildings.Fluid.Actuators.BaseClasses.PartialThreeWayValve( + redeclare final package Medium=Medium, + final m_flow_nominal=m_flow_nominal, + final dpValve_nominal=dpValve_nominal, + final dpFixed_nominal={dpFixed_nominal, dpFixedByp_nominal}, + final energyDynamics=energyDynamics, + final tau=tau, + final use_inputFilter=use_inputFilter, + final riseTime=riseTime, + final init=init, + final y_start=y_start, + final portFlowDirection_1=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering, + final portFlowDirection_2=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Leaving, + final portFlowDirection_3=if allowFlowReversal then + Modelica.Fluid.Types.PortFlowDirection.Bidirectional + else Modelica.Fluid.Types.PortFlowDirection.Entering) + "Valve" + annotation ( + __ctrl_flow(enable=false), + choicesAllMatching=true, + Placement( + transformation( + extent={{-10,-10},{10,10}}, + rotation=0))); +equation + connect(port_a, val.port_1) + annotation (Line(points={{-100,0},{-10,0}}, color={0,127,255})); + connect(val.port_2, port_b) + annotation (Line(points={{10,0},{100,0}}, color={0,127,255})); + connect(val.port_3, portByp_a) + annotation (Line(points={{0,-10},{0,-100}}, color={0,127,255})); + connect(bus.y, val.y) annotation (Line( + points={{0,100},{0,12}}, + color={255,204,51}, + thickness=0.5), Text( + string="%first", + index=-1, + extent={{-3,6},{-3,6}}, + horizontalAlignment=TextAlignment.Right)); + connect(val.y_actual, bus.y_actual) annotation (Line(points={{5,7},{40,7},{40, + 96},{0,96},{0,100}}, color={0,0,127}), Text( + string="%second", + index=1, + extent={{6,3},{6,3}}, + horizontalAlignment=TextAlignment.Left)); + annotation ( + defaultComponentName="val", + Documentation(info=" ++This is a model for a three-way modulating valve. +
+y (real).y = 0 corresponds to full bypass.
+y = 1 corresponds to zero bypass.
+y_actual (real) is returned.y_actual = 0 corresponds to full bypass.
+y_actual = 1 corresponds to zero bypass.
++This is a model for a three-way two-position (directional) valve. +
+y1.y1 = false corresponds to full bypass.
+y1 = true corresponds to zero bypass.
+y1_actual and
+closed end switch status y0_actual (Booleans)
+are returned.y1_actual = false corresponds to full bypass.
+y1_actual = true corresponds to zero bypass.
+And the opposite for y0_actual.
++This is a model for a two-way modulating valve. +
+y (real).y = 0 corresponds to fully closed.
+y = 1 corresponds to fully open.
+y_actual (real) is returned.y_actual = 0 corresponds to fully closed.
+y_actual = 1 corresponds to fully open.
++This is a model for a two-way two-position (isolation) valve. +
+y1.y1 = false corresponds to fully closed.
+y1 = true corresponds to fully open.
+y1_actual and
+closed end switch status y0_actual (Booleans)
+are returned.y1_actual = false corresponds to fully closed.
+y1_actual = true corresponds to fully open.
+And the opposite for y0_actual.
++This package contains models for valves. +
+")); +end Valves; diff --git a/Buildings/Templates/Components/Valves/package.order b/Buildings/Templates/Components/Valves/package.order new file mode 100644 index 00000000000..286524eef49 --- /dev/null +++ b/Buildings/Templates/Components/Valves/package.order @@ -0,0 +1,5 @@ +None +ThreeWayModulating +ThreeWayTwoPosition +TwoWayModulating +TwoWayTwoPosition diff --git a/Buildings/Templates/Components/package.mo b/Buildings/Templates/Components/package.mo new file mode 100644 index 00000000000..578bf36a983 --- /dev/null +++ b/Buildings/Templates/Components/package.mo @@ -0,0 +1,12 @@ +within Buildings.Templates; +package Components "Package with component models" + extends Modelica.Icons.VariantsPackage; + + annotation (Documentation(info=" ++This package contains component models that are used in + +Buildings.Templates. +
+")); +end Components; diff --git a/Buildings/Templates/Components/package.order b/Buildings/Templates/Components/package.order new file mode 100644 index 00000000000..fc2da254c48 --- /dev/null +++ b/Buildings/Templates/Components/package.order @@ -0,0 +1,10 @@ +Coils +Dampers +Fans +Routing +Sensors +Valves +Data +Types +Validation +Interfaces diff --git a/Buildings/Templates/Data/AllSystems.mo b/Buildings/Templates/Data/AllSystems.mo new file mode 100644 index 00000000000..4d42327a38b --- /dev/null +++ b/Buildings/Templates/Data/AllSystems.mo @@ -0,0 +1,71 @@ +within Buildings.Templates.Data; +class AllSystems "Top-level (whole building) system parameters" + +// parameter Buildings.Templates.Types.Buildings typBui +// "Building type"; +// +// parameter String namPro +// "Project name"; +// +// parameter Modelica.Units.SI.Area areFlo +// "Project floor area"; + + parameter Buildings.Templates.Types.Units sysUni + "Unit system"; + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard stdEne + "Energy standard" + annotation(Evaluate=true); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen + "Ventilation standard" + annotation(Evaluate=true); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.ASHRAEClimateZone ashCliZon( + start=Buildings.Controls.OBC.ASHRAE.G36.Types.ASHRAEClimateZone.Zone_1A) + "ASHRAE climate zone" + annotation (Dialog( + enable=stdEne==Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard.ASHRAE90_1)); + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.Title24ClimateZone tit24CliZon( + start=Buildings.Controls.OBC.ASHRAE.G36.Types.Title24ClimateZone.Zone_1) + "California Title 24 climate zone" + annotation (Dialog( + enable=stdEne==Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard.California_Title_24)); + +// parameter String note +// "Notes"; + +annotation ( + defaultComponentPrefixes = "inner parameter", + defaultComponentName = "datAll", + Documentation(info=" ++This class provides the set of sizing and operating parameters for the whole HVAC system. +
+"), + Icon(graphics={ + Text( + textColor={0,0,255}, + extent={{-150,60},{150,100}}, + textString="%name"), + Rectangle( + origin={0,-25}, + lineColor={64,64,64}, + fillColor={85,255,255}, + fillPattern=FillPattern.Solid, + extent={{-100.0,-75.0},{100.0,75.0}}, + radius=25.0), + Line( + points={{-100,0},{100,0}}, + color={64,64,64}), + Line( + origin={0,-50}, + points={{-100.0,0.0},{100.0,0.0}}, + color={64,64,64}), + Line( + origin={0,-25}, + points={{0.0,75.0},{0.0,-75.0}}, + color={64,64,64})})); + +end AllSystems; diff --git a/Buildings/Templates/Data/package.mo b/Buildings/Templates/Data/package.mo new file mode 100644 index 00000000000..c54d152b531 --- /dev/null +++ b/Buildings/Templates/Data/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates; +package Data "Package with classes for storing system parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + + annotation (Documentation(info=" ++This package provides classes for storing system parameters +at the top-level of a simulation model. +
+")); +end Data; diff --git a/Buildings/Templates/Data/package.order b/Buildings/Templates/Data/package.order new file mode 100644 index 00000000000..3831742ec60 --- /dev/null +++ b/Buildings/Templates/Data/package.order @@ -0,0 +1 @@ +AllSystems diff --git a/Buildings/Templates/Types.mo b/Buildings/Templates/Types.mo new file mode 100644 index 00000000000..995622aed3a --- /dev/null +++ b/Buildings/Templates/Types.mo @@ -0,0 +1,33 @@ +within Buildings.Templates; +package Types "Package with type definitions" + extends Modelica.Icons.TypesPackage; + + type Buildings = enumeration( + Education "Buildings used for academic or technical classroom instruction", + FoodSales "Buildings used for retail or wholesale of food", + FoodServices "Buildings used for preparation and sale of food and beverages for consumption", + HealthCare "Buildings used as diagnostic and treatment facilities for inpatient care", + Lodging "Buildings used to offer multiple accommodations for short-term or long-term residents", + MercantileRetail "Buildings used for the sale and display of goods other than food", + MercantileMall "Shopping malls comprised of multiple connected establishments", + Office "Buildings used for general office space, professional office, or administrative offices", + PublicAssembly "Buildings in which people gather for social or recreational activities", + PublicOrderSafety "Buildings used for the preservation of law and order or public safety", + ReligiousWorkshop "Buildings in which people gather for religious activities", + Service "Buildings in which some types of services is provided", + WarehouseStorage "Buildings used to store goods, manufactured products, merchandise, raw materials, or personal belongings", + Other "All other miscellaneous buildings that do not fit into any other category", + Vacant "Buildings in which more floor space was vacant than was used for any single commercial activity") + "Enumeration to specify the building type"; + type Units = enumeration( + SI + "SI - International units", + IP + "IP - Imperial units") + "Enumeration to specify the system of units"; + annotation (Documentation(info=" ++This package contains type definitions. +
+")); +end Types; diff --git a/Buildings/Templates/UsersGuide.mo b/Buildings/Templates/UsersGuide.mo new file mode 100644 index 00000000000..e556264e84b --- /dev/null +++ b/Buildings/Templates/UsersGuide.mo @@ -0,0 +1,202 @@ +within Buildings.Templates; +package UsersGuide "Templates user guide" + extends Modelica.Icons.Information; + class Conventions + "Conventions" + extends Modelica.Icons.Information; + annotation ( + preferredView="info", + Documentation( + info=" +
+Inside a template class, the connect clauses involving control points
+typically do not have
+any graphical annotation and are therefore not rendered as
+connection lines in the diagram view.
+Those connect clauses are grouped together in a dedicated section of
+the equation section of each class, namely
+/* Control point connection - (start | stop) */.
+
+We adopt the definition hereafter from ASHRAE (2021). +
++A set of components is a system if they share a load in +common (i.e., collectively act as a source to downstream +equipment, such as a set of chillers in a lead/lag relation- +ship serving air handlers). +
+
+The following abbreviations are used in that package.
+
| Abbreviation | Description |
|---|---|
| AI | Analog input (integer or real) |
| AFMS | Airflow measuring station |
| AHU | Air handling unit |
| AO | Analog output (integer or real) |
| CHW | Chilled water |
| CW | Condenser water |
| DHW | Domestic hot water |
| DI | Digital input (Boolean) |
| DO | Digital output (Boolean) |
| DOAS | Dedicated outdoor air system |
| DP | Differential pressure |
| HHW | Heating hot water |
| OA | Outdoor air |
| VAV | Variable air volume |
| VFD | Variable frequency drive |
+This user guide describes how to use the templates. +
++The templates are defined at the system level, such as an air handler +or a terminal unit (refer to + +Buildings.Templates.UsersGuide.Conventions +for the definition of a system). +A template is a self-contained model that can be reconfigured +by redeclaring some of its components or modifying some +structural parameters. +Such configuration does not require any further modification +of the template. +In particular, all connect clauses between replaceable components +are resolved internally without user intervention. +The same applies to sensors that are required for a specific control +option and instantiated only when that option is selected. +
++Currently, there is no template that represents a complete HVAC system +from the plant to the zone equipment. +In order to create a simulation model for a complete HVAC system, +one must +
++When assembling a model for a complete HVAC system, +the user must ensure that the control +sequence selected for one subsystem is compatible +with that selected for another subsystem. +For example, the AHU controller may require reset requests +that originate from the zone equipment controller. +If the controller selected for the zone equipment does not +generate such requests, the simulation model will be singular. +Selecting controllers from the same reference—e.g., +ASHRAE (2021)—is the safest way +to ensure consistency throughout the HVAC system model. +
+
+Each template contains an instance dat of a record class that
+contains all design and operating parameters for parameterizing
+the subcomponents of the template.
+For example, the multiple-zone VAV template
+
+Buildings.Templates.AirHandlersFans.VAVMultiZone
+contains an instance of the record class
+
+Buildings.Templates.AirHandlersFans.Data.VAVMultiZone
+which contains the parameters for configuring the heating coil component,
+as an instance of the record class
+
+Buildings.Templates.Components.Data.Coil.
+All design and operating parameters should be assigned through this record instance
+and are propagated down to each subcomponent.
+
+In addition to these parameters, the record class also contains the configuration +parameters that define the system layout and control options. +These configuration parameters are bound to the values that are assigned via +the template's parameter dialog. +In this way, only the set of parameters needed for the particular system layout +for which the template is configured is displayed in the parameter dialog. +Note that these configuration parameters are disabled in the record class +to avoid any modification by the user and preserve the bindings with the +template parameters. +
++When creating a model for a complete HVAC system with multiple instances of +different templates, the class + +Buildings.Templates.Data.AllSystems +can be used at the top level of the model to assign all design and operating parameters. +This class allows the use of Modelica outer components to retrieve the configuration +parameter values for each template instance based on the instance name. +Thus, it is the avatar in the modeling environment of an HVAC project datasheet. +The validation models within + +Buildings.Templates.AirHandlersFans.Validation +illustrate the use of this class. +
++This is an implementation of the control sequence specified in +ASHRAE (2021) +for cooling-only VAV terminal units. +It contains the following components. +
++This is an implementation of the control sequence specified in +ASHRAE (2021) +for VAV terminal units with reheat. +It contains the following components. +
++This is an open loop controller providing control inputs +for the templates within + +Buildings.Templates.ZoneEquipment. +It is mainly used for testing purposes. +
+")); +end OpenLoop; diff --git a/Buildings/Templates/ZoneEquipment/Components/Controls/package.mo b/Buildings/Templates/ZoneEquipment/Components/Controls/package.mo new file mode 100644 index 00000000000..9c700c3b5bd --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Controls/package.mo @@ -0,0 +1,14 @@ +within Buildings.Templates.ZoneEquipment.Components; +package Controls + extends Modelica.Icons.VariantsPackage; + + + +annotation (Documentation(info=" ++All control blocks that form the control sequence of a system +are instantiated into one single class, a so-called control section. +This package contains such control sections. +
+")); +end Controls; diff --git a/Buildings/Templates/ZoneEquipment/Components/Controls/package.order b/Buildings/Templates/ZoneEquipment/Components/Controls/package.order new file mode 100644 index 00000000000..dffcc2fc361 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Controls/package.order @@ -0,0 +1,3 @@ +G36VAVBoxCoolingOnly +G36VAVBoxReheat +OpenLoop diff --git a/Buildings/Templates/ZoneEquipment/Components/Data/PartialController.mo b/Buildings/Templates/ZoneEquipment/Components/Data/PartialController.mo new file mode 100644 index 00000000000..a57988fd610 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Data/PartialController.mo @@ -0,0 +1,16 @@ +within Buildings.Templates.ZoneEquipment.Components.Data; +record PartialController "Record for controller interface class" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.ZoneEquipment.Types.Controller typ + "Type of controller" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for the class + +Buildings.Templates.ZoneEquipment.Components.Controls.Interfaces.PartialController. +
+")); +end PartialController; diff --git a/Buildings/Templates/ZoneEquipment/Components/Data/VAVBoxController.mo b/Buildings/Templates/ZoneEquipment/Components/Data/VAVBoxController.mo new file mode 100644 index 00000000000..64095d869e1 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Data/VAVBoxController.mo @@ -0,0 +1,101 @@ +within Buildings.Templates.ZoneEquipment.Components.Data; +record VAVBoxController "Record for VAV terminal unit controller" + extends Buildings.Templates.ZoneEquipment.Components.Data.PartialController; + + parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen + "Ventilation standard" + annotation (Dialog(group="Energy and ventilation standards", enable=false)); + + parameter Modelica.Units.SI.VolumeFlowRate VOutMinOcc_flow( + final min=0, + start=1) + "Zone minimum outdoor airflow for occupants" + annotation (Dialog(group="Ventilation", enable= + (typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + parameter Modelica.Units.SI.VolumeFlowRate VOutMinAre_flow( + final min=0, + start=1) + "Zone minimum outdoor airflow for building area" + annotation (Dialog(group="Ventilation", enable= + (typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + parameter Real VOutAre_flow( + final unit = "m3/s", + final min=0) + "Area component of the breathing zone outdoor airflow" + annotation(Dialog(group="Ventilation", + enable=(typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Real VOutOcc_flow( + final unit = "m3/s", + final min=0) + "Population component of the breathing zone outdoor airflow" + annotation(Dialog(group="Ventilation", + enable=(typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Real effAirDisHea( + final unit="1", + final min=0, + final max=1)=0.8 + "Zone air distribution effectiveness during heating" + annotation(Dialog(group="Ventilation", + enable=(typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Real effAirDisCoo( + final unit="1", + final min=0, + final max=1)=1.0 + "Zone air distribution effectiveness during cooling" + annotation(Dialog(group="Ventilation", + enable=(typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly) and + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + parameter Modelica.Units.SI.TemperatureDifference dTAirDisHea_max( + final min=0, + displayUnit="K")=11 + "Zone maximum discharge air temperature above heating setpoint" + annotation (Dialog(group="Temperature", + enable=typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat)); + parameter Modelica.Units.SI.VolumeFlowRate VAirCooSet_flow_max( + final min=0, + start=1) + "Zone maximum cooling airflow setpoint" + annotation (Dialog(group="Airflow")); + + /* RFE #1913: This should be an optional entry. If no value is scheduled, + Vmin should be calculated automatically and dynamically to meet ventilation requirements. + */ + parameter Modelica.Units.SI.VolumeFlowRate VAirSet_flow_min( + final min=0, + start=0.1 * VAirCooSet_flow_max) + "Zone minimum airflow setpoint" + annotation (Dialog(group="Airflow")); + + parameter Modelica.Units.SI.VolumeFlowRate VAirHeaSet_flow_max( + final min=0, + start=0.3 * VAirCooSet_flow_max) + "Zone maximum heating airflow setpoint" + annotation (Dialog(group="Airflow", + enable=(typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly or + typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat))); + + parameter Modelica.Units.SI.VolumeFlowRate VAirHeaSet_flow_min( + final min=0)=0 + "Zone minimum heating airflow setpoint" + annotation (Dialog(group="Airflow", + enable=typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat)); + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for +VAV box controllers within + +Buildings.Templates.ZoneEquipment.Components.Controls. +
+")); +end VAVBoxController; diff --git a/Buildings/Templates/ZoneEquipment/Components/Data/package.mo b/Buildings/Templates/ZoneEquipment/Components/Data/package.mo new file mode 100644 index 00000000000..b7fe5946e0e --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Data/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.ZoneEquipment.Components; +package Data + extends Modelica.Icons.MaterialPropertiesPackage; + + +annotation (Documentation(info=" ++This package provides records for design and operating parameters. +
+")); +end Data; diff --git a/Buildings/Templates/ZoneEquipment/Components/Data/package.order b/Buildings/Templates/ZoneEquipment/Components/Data/package.order new file mode 100644 index 00000000000..867bb54d1f9 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Data/package.order @@ -0,0 +1,2 @@ +PartialController +VAVBoxController diff --git a/Buildings/Templates/ZoneEquipment/Components/Interfaces/ControllerG36VAVBox.mo b/Buildings/Templates/ZoneEquipment/Components/Interfaces/ControllerG36VAVBox.mo new file mode 100644 index 00000000000..cea01689116 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Interfaces/ControllerG36VAVBox.mo @@ -0,0 +1,290 @@ +within Buildings.Templates.ZoneEquipment.Components.Interfaces; +block ControllerG36VAVBox "Guideline 36 controller for VAV terminal unit" + extends + Buildings.Templates.ZoneEquipment.Components.Interfaces.PartialControllerVAVBox; + + parameter Boolean have_occSen=false + "Set to true if the zone has occupancy sensor" + annotation (Evaluate=true, Dialog(group="Configuration")); + + parameter Boolean have_winSen=false + "Set to true if the zone has window status sensor" + annotation (Evaluate=true, Dialog(group="Configuration")); + + final parameter Boolean have_hotWatCoi= + coiHea.typ==Buildings.Templates.Components.Types.Coil.WaterBasedHeating + "Set to true if the system has hot water coil" + annotation (Evaluate=true, Dialog(group="Configuration")); + + final parameter Modelica.Units.SI.VolumeFlowRate VAirCooSet_flow_max= + dat.VAirCooSet_flow_max + "Zone maximum cooling airflow setpoint"; + + final parameter Modelica.Units.SI.VolumeFlowRate VAirSet_flow_min= + dat.VAirSet_flow_min + "Zone minimum airflow setpoint"; + + final parameter Modelica.Units.SI.VolumeFlowRate VAirHeaSet_flow_max= + dat.VAirHeaSet_flow_max + "Zone maximum heating airflow setpoint"; + + final parameter Modelica.Units.SI.VolumeFlowRate VAirHeaSet_flow_min= + dat.VAirHeaSet_flow_min + "Zone minimum heating airflow setpoint"; + + final parameter Modelica.Units.SI.TemperatureDifference dTAirDisHea_max( + displayUnit="K")= + dat.dTAirDisHea_max + "Zone maximum discharge air temperature above heating setpoint"; + + final parameter Modelica.Units.SI.VolumeFlowRate VOutMinOcc_flow( + final min=0, + start=1)=dat.VOutMinOcc_flow + "Zone minimum outdoor airflow for occupants" + annotation (Dialog(enable= + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + final parameter Modelica.Units.SI.VolumeFlowRate VOutMinAre_flow( + final min=0, + start=1)=dat.VOutMinAre_flow + "Zone minimum outdoor airflow for building area" + annotation (Dialog(enable= + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.California_Title_24)); + + final parameter Real VOutAre_flow( + final unit = "m3/s")= + dat.VOutAre_flow + "Outdoor air flow rate per unit area" + annotation (Dialog(enable= + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + + final parameter Real VOutOcc_flow( + final unit = "m3/s")= + dat.VOutOcc_flow + "Outdoor air flow rate per occupant" + annotation (Dialog(enable= + stdVen==Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1)); + + final parameter Real effAirDisHea= + dat.effAirDisHea + "Zone air distribution effectiveness during heating"; + + final parameter Real effAirDisCoo= + dat.effAirDisCoo + "Zone air distribution effectiveness during cooling"; + + Buildings.Controls.OBC.ASHRAE.G36.TerminalUnits.Reheat.Controller ctlReh( + final venStd=stdVen, + final have_winSen=have_winSen, + final have_occSen=have_occSen, + final have_CO2Sen=have_CO2Sen, + final have_hotWatCoi=have_hotWatCoi, + final VOccMin_flow=VOutMinOcc_flow, + final VAreMin_flow=VOutMinAre_flow, + final VAreBreZon_flow=VOutAre_flow, + final VPopBreZon_flow=VOutOcc_flow, + final VMin_flow=VAirSet_flow_min, + final VCooMax_flow=VAirCooSet_flow_max, + final VHeaMin_flow=VAirHeaSet_flow_min, + final VHeaMax_flow=VAirHeaSet_flow_max, + final dTDisZonSetMax=dTAirDisHea_max, + final zonDisEff_cool=effAirDisCoo, + final zonDisEff_heat=effAirDisHea) if typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat + "Terminal unit with reheat controller" + annotation (Placement(transformation(extent={{0,-20},{20,20}}))); + + Buildings.Controls.OBC.ASHRAE.G36.TerminalUnits.CoolingOnly.Controller ctlCoo( + final venStd=stdVen, + final have_winSen=have_winSen, + final have_occSen=have_occSen, + final have_CO2Sen=have_CO2Sen, + final VOccMin_flow=VOutMinOcc_flow, + final VAreMin_flow=VOutMinAre_flow, + final VAreBreZon_flow=VOutAre_flow, + final VPopBreZon_flow=VOutOcc_flow, + final VMin_flow=VAirSet_flow_min, + final VCooMax_flow=VAirCooSet_flow_max, + final zonDisEff_cool=effAirDisCoo, + final zonDisEff_heat=effAirDisHea) if typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly + "Terminal unit cooling only controller" + annotation (Placement(transformation(extent={{0,40},{20,80}}))); + + Buildings.Controls.OBC.ASHRAE.G36.ThermalZones.Setpoints TZonSet( + final have_occSen=have_occSen, + final have_winSen=have_winSen) + "Compute zone temperature setpoints" + annotation (Placement(transformation(extent={{-60,-20},{-40,20}}))); + + Buildings.Controls.OBC.ASHRAE.G36.ZoneGroups.ZoneStatus zonSta( + final have_winSen=have_winSen) + "Evaluate zone temperature status" + annotation (Placement(transformation(extent={{0,-120},{20,-92}}))); + + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant cooDowWarUpTim(k=3600) + "RFE: Optimal start (using global OA temperature not associated with any AHU) not implemented" + annotation (Placement(transformation(extent={{-60,-110},{-40,-90}}))); + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant setAdj(k=0) + "RFE: Setpoint adjustment by the occupant is not implemented in the template" + annotation (Placement(transformation(extent={{-160,170},{-140,190}}))); + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant cooSetAdj(k=0) + "RFE: Setpoint adjustment by the occupant is not implemented in the template" + annotation (Placement(transformation(extent={{-160,130},{-140,150}}))); + Buildings.Controls.OBC.CDL.Continuous.Sources.Constant heaSetAdj(k=0) + "RFE: Setpoint adjustment by the occupant is not implemented in the template" + annotation (Placement(transformation(extent={{-160,90},{-140,110}}))); + Buildings.Controls.OBC.CDL.Integers.Sources.Constant uCooDemLimLev(k=0) + "RFE: Setpoint adjustment by demand limit is not implemented in the template" + annotation (Placement(transformation(extent={{-120,170},{-100,190}}))); + Buildings.Controls.OBC.CDL.Integers.Sources.Constant uHeaDemLimLev(k=0) + "RFE: Setpoint adjustment by demand limit is not implemented in the template" + annotation (Placement(transformation(extent={{-120,130},{-100,150}}))); + +equation + /* Control point connection - start */ + + // Inputs from bus + connect(bus.TZon, ctlReh.TZon); + connect(bus.y1Win, ctlReh.u1Win); + connect(bus.y1Occ, ctlReh.u1Occ); + connect(bus.ppmCO2, ctlReh.ppmCO2); + connect(bus.ppmCO2Set, ctlReh.ppmCO2Set); + connect(bus.yOpeMod, ctlReh.uOpeMod); + connect(bus.TAirDis, ctlReh.TDis); + connect(bus.VAirDis_flow, ctlReh.VDis_flow); + connect(bus.TAirSup, ctlReh.TSup); + connect(bus.TAirSupSet, ctlReh.TSupSet); + connect(bus.y1FanSup_actual, ctlReh.u1Fan); + connect(bus.y1PlaHeaWat, ctlReh.u1HotPla); + connect(bus.yOveFloSet, ctlReh.oveFloSet); + connect(bus.yOveDamPos, ctlReh.oveDamPos); + connect(bus.y1OveHeaOff, ctlReh.uHeaOff); + + connect(bus.TZon, ctlCoo.TZon); + connect(bus.y1Win, ctlCoo.u1Win); + connect(bus.y1Occ, ctlCoo.u1Occ); + connect(bus.ppmCO2, ctlCoo.ppmCO2); + connect(bus.ppmCO2Set, ctlCoo.ppmCO2Set); + connect(bus.yOpeMod, ctlCoo.uOpeMod); + connect(bus.TAirDis, ctlCoo.TDis); + connect(bus.VAirDis_flow, ctlCoo.VDis_flow); + connect(bus.TAirSup, ctlCoo.TSup); + connect(bus.y1FanSup_actual, ctlCoo.u1Fan); + connect(bus.yOveFloSet, ctlCoo.oveFloSet); + connect(bus.yOveDamPos, ctlCoo.oveDamPos); + + connect(bus.y1Occ, TZonSet.u1Occ); + connect(bus.y1Win, TZonSet.u1Win); + + connect(bus.y1Win, zonSta.u1Win); + connect(bus.TZon, zonSta.TZon); + connect(bus.TZonCooOccSet, zonSta.TOccCooSet); + connect(bus.TZonCooUnoSet, zonSta.TUnoCooSet); + connect(bus.TZonHeaOccSet, zonSta.TOccHeaSet); + connect(bus.TZonHeaUnoSet, zonSta.TUnoHeaSet); + + connect(bus.yOpeMod, TZonSet.uOpeMod); + connect(bus.dTSetAdj, TZonSet.setAdj); + connect(bus.dTHeaSetAdj, TZonSet.heaSetAdj); + connect(bus.uCooDemLimLev, TZonSet.uCooDemLimLev); + connect(bus.uHeaDemLimLev, TZonSet.uHeaDemLimLev); + connect(bus.TZonCooOccSet, TZonSet.TOccCooSet); + connect(bus.TZonCooUnoSet, TZonSet.TUnoCooSet); + connect(bus.TZonHeaOccSet, TZonSet.TOccHeaSet); + connect(bus.TZonHeaUnoSet, TZonSet.TUnoHeaSet); + + // Outputs to bus + connect(ctlReh.yDam, bus.damVAV.y); + connect(ctlReh.yVal, bus.coiHea.y); + connect(ctlReh.VAdjPopBreZon_flow, bus.VAdjPopBreZon_flow); + connect(ctlReh.VAdjAreBreZon_flow, bus.VAdjAreBreZon_flow); + connect(ctlReh.VMinOA_flow, bus.VMinOA_flow); + connect(ctlReh.VZonAbsMin_flow, bus.VZonAbsMin_flow); + connect(ctlReh.VZonDesMin_flow, bus.VZonDesMin_flow); + connect(ctlReh.yCO2, bus.yCO2); + + connect(ctlReh.yZonTemResReq, bus.yReqZonTemRes); + connect(ctlReh.yZonPreResReq, bus.yReqZonPreRes); + + connect(ctlCoo.yDam, bus.damVAV.y); + connect(ctlCoo.VAdjPopBreZon_flow, bus.VAdjPopBreZon_flow); + connect(ctlCoo.VAdjAreBreZon_flow, bus.VAdjAreBreZon_flow); + connect(ctlCoo.VMinOA_flow, bus.VMinOA_flow); + connect(ctlCoo.VZonAbsMin_flow, bus.VZonAbsMin_flow); + connect(ctlCoo.VZonDesMin_flow, bus.VZonDesMin_flow); + connect(ctlCoo.yCO2, bus.yCO2); + + connect(ctlCoo.yZonTemResReq, bus.yZonTemResReq); + connect(ctlCoo.yZonPreResReq, bus.yZonPreResReq); + + connect(zonSta.yCooTim, bus.yCooTim); + connect(zonSta.yWarTim, bus.yWarTim); + connect(zonSta.yOccHeaHig, bus.yOccHeaHig); + connect(zonSta.yHigOccCoo, bus.yHigOccCoo); + connect(zonSta.yUnoHeaHig, bus.yUnoHeaHig); + connect(zonSta.yEndSetBac, bus.yEndSetBac); + connect(zonSta.yHigUnoCoo, bus.yHigUnoCoo); + connect(zonSta.yEndSetUp, bus.yEndSetUp); + + /* Control point connection - end */ + + connect(TZonSet.TCooSet, ctlReh.TCooSet) annotation (Line(points={{-38,8},{-22, + 8},{-22,17},{-2,17}}, color={0,0,127})); + connect(TZonSet.THeaSet, ctlReh.THeaSet) annotation (Line(points={{-38,0},{-20, + 0},{-20,15},{-2,15}}, color={0,0,127})); + connect(uCooDemLimLev.y, TZonSet.uCooDemLimLev) annotation (Line(points={{-98, + 180},{-70,180},{-70,-8},{-62,-8}}, color={255,127,0})); + connect(uHeaDemLimLev.y, TZonSet.uHeaDemLimLev) annotation (Line(points={{-98, + 140},{-74,140},{-74,-11},{-62,-11}}, color={255,127,0})); + connect(cooSetAdj.y, TZonSet.cooSetAdj) annotation (Line(points={{-138,140},{-134, + 140},{-134,-2},{-62,-2}}, color={0,0,127})); + connect(heaSetAdj.y, TZonSet.heaSetAdj) annotation (Line(points={{-138,100},{-136, + 100},{-136,-4},{-62,-4}}, color={0,0,127})); + connect(setAdj.y, TZonSet.setAdj) annotation (Line(points={{-138,180},{-132,180}, + {-132,0},{-62,0}}, color={0,0,127})); + connect(TZonSet.TCooSet, ctlCoo.TCooSet) annotation (Line(points={{-38,8},{-22, + 8},{-22,76},{-2,76}}, color={0,0,127})); + connect(TZonSet.THeaSet, ctlCoo.THeaSet) annotation (Line(points={{-38,0},{-20, + 0},{-20,74},{-2,74}}, color={0,0,127})); + connect(cooDowWarUpTim.y, zonSta.cooDowTim) annotation (Line(points={{-38,-100}, + {-20,-100},{-20,-95},{-2,-95}}, color={0,0,127})); + connect(cooDowWarUpTim.y, zonSta.warUpTim) annotation (Line(points={{-38,-100}, + {-20,-100},{-20,-98},{-2,-98}}, color={0,0,127})); + annotation ( + defaultComponentName="ctl", + Icon(coordinateSystem(preserveAspectRatio=false)), Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is an implementation of the control sequence specified in +ASHRAE (2021) +for VAV terminal units with reheat. +It contains the following components. +
++This partial class provides a standard interface for terminal unit controllers. +
+")); +end PartialController; diff --git a/Buildings/Templates/ZoneEquipment/Components/Interfaces/PartialControllerVAVBox.mo b/Buildings/Templates/ZoneEquipment/Components/Interfaces/PartialControllerVAVBox.mo new file mode 100644 index 00000000000..6e6a7319868 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Interfaces/PartialControllerVAVBox.mo @@ -0,0 +1,29 @@ +within Buildings.Templates.ZoneEquipment.Components.Interfaces; +partial block PartialControllerVAVBox + "Interface class for VAV terminal unit controller" + extends + Buildings.Templates.ZoneEquipment.Components.Interfaces.PartialController( + redeclare + Buildings.Templates.ZoneEquipment.Components.Data.VAVBoxController dat( + stdVen=stdVen)); + + parameter Boolean have_CO2Sen=false + "Set to true if the zone has CO2 sensor" + annotation (Evaluate=true, Dialog(group="Configuration")); + + final parameter Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard stdVen= + datAll.stdVen + "Ventilation standard"; + + outer replaceable Buildings.Templates.Components.Dampers.Modulating damVAV + "VAV damper"; + + outer replaceable Buildings.Templates.Components.Coils.None coiHea + "Heating coil"; + + annotation (Documentation(info=" ++This partial class provides a standard interface for VAV terminal unit controllers. +
+")); +end PartialControllerVAVBox; diff --git a/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.mo b/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.mo new file mode 100644 index 00000000000..8ba343cf95a --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.ZoneEquipment.Components; +package Interfaces "Interface classes" + extends Modelica.Icons.InterfacesPackage; + +annotation (Documentation(info=" ++This package contains interface classes. +
+")); +end Interfaces; diff --git a/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.order b/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.order new file mode 100644 index 00000000000..21147f5a483 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/Interfaces/package.order @@ -0,0 +1,3 @@ +ControllerG36VAVBox +PartialController +PartialControllerVAVBox diff --git a/Buildings/Templates/ZoneEquipment/Components/package.mo b/Buildings/Templates/ZoneEquipment/Components/package.mo new file mode 100644 index 00000000000..e2d4d885c44 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/package.mo @@ -0,0 +1,12 @@ +within Buildings.Templates.ZoneEquipment; +package Components "Package with component models" + extends Modelica.Icons.VariantsPackage; + + annotation (Documentation(info=" ++This package contains component models that are used in + +Buildings.Templates.ZoneEquipment. +
+")); +end Components; diff --git a/Buildings/Templates/ZoneEquipment/Components/package.order b/Buildings/Templates/ZoneEquipment/Components/package.order new file mode 100644 index 00000000000..0f343567d12 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Components/package.order @@ -0,0 +1,3 @@ +Controls +Data +Interfaces diff --git a/Buildings/Templates/ZoneEquipment/Data/PartialAirTerminal.mo b/Buildings/Templates/ZoneEquipment/Data/PartialAirTerminal.mo new file mode 100644 index 00000000000..1af4f02e133 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Data/PartialAirTerminal.mo @@ -0,0 +1,53 @@ +within Buildings.Templates.ZoneEquipment.Data; +record PartialAirTerminal "Record for air terminal unit interface class" + extends Modelica.Icons.Record; + + parameter Buildings.Templates.ZoneEquipment.Types.Configuration typ + "Type of system" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Boolean have_souChiWat + "Set to true if system uses CHW" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Boolean have_souHeaWat + "Set to true if system uses HHW" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + parameter Buildings.Templates.ZoneEquipment.Types.Controller typCtl + "Type of controller" + annotation (Evaluate=true, Dialog(group="Configuration", enable=false)); + + parameter String id="" + "System tag" + annotation (Dialog(group="Advanced")); + parameter String id_souAir="" + "Air supply system tag" + annotation (Dialog(group="Advanced")); + parameter String id_souChiWat="" + "CHW supply system tag" + annotation (Dialog(group="Advanced", enable=have_souChiWat)); + parameter String id_souHeaWat="" + "HHW supply system tag" + annotation (Dialog(group="Advanced", enable=have_souHeaWat)); + + parameter Modelica.Units.SI.MassFlowRate mAir_flow_nominal( + final min=0, + start=1) + "Discharge air mass flow rate" + annotation (Dialog(group="Nominal condition")); + + replaceable parameter Buildings.Templates.ZoneEquipment.Components.Data.PartialController + ctl(final typ=typCtl) + "Controller" + annotation (Dialog(group="Controls")); + + annotation (Documentation(info=" ++This record provides the set of sizing and operating parameters for the class + +Buildings.Templates.ZoneEquipment.Interfaces.PartialAirTerminal. +
+
+The tab Advanced contains some optional parameters that can be used
+for workflow automation, but are not used for simulation.
+
+This record provides the set of sizing and operating parameters for the classes + +Buildings.Templates.ZoneEquipment.VAVBoxCoolingOnly +and + +Buildings.Templates.ZoneEquipment.VAVBoxReheat. +
+")); +end VAVBox; diff --git a/Buildings/Templates/ZoneEquipment/Data/package.mo b/Buildings/Templates/ZoneEquipment/Data/package.mo new file mode 100644 index 00000000000..eefbc1f3581 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Data/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.ZoneEquipment; +package Data "Records for design and operating parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + + +annotation (Documentation(info=" ++This package provides records for design and operating parameters. +
+")); +end Data; diff --git a/Buildings/Templates/ZoneEquipment/Data/package.order b/Buildings/Templates/ZoneEquipment/Data/package.order new file mode 100644 index 00000000000..32666beced3 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Data/package.order @@ -0,0 +1,2 @@ +PartialAirTerminal +VAVBox diff --git a/Buildings/Templates/ZoneEquipment/Interfaces/Bus.mo b/Buildings/Templates/ZoneEquipment/Interfaces/Bus.mo new file mode 100644 index 00000000000..c79569ce68a --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Interfaces/Bus.mo @@ -0,0 +1,20 @@ +within Buildings.Templates.ZoneEquipment.Interfaces; +expandable connector Bus "Control bus for zone equipment" + extends Modelica.Icons.SignalBus; + + Buildings.Templates.Components.Interfaces.Bus damVAV + "VAV damper points" + annotation (HideResult=false); + + Buildings.Templates.Components.Interfaces.Bus coiHea + "Heating coil points" + annotation (HideResult=false); + + annotation ( + defaultComponentName="bus", Documentation(info=" ++This expandable connector provides a standard interface for +all control signals required by a terminal unit controller. +
+")); +end Bus; diff --git a/Buildings/Templates/ZoneEquipment/Interfaces/PartialAirTerminal.mo b/Buildings/Templates/ZoneEquipment/Interfaces/PartialAirTerminal.mo new file mode 100644 index 00000000000..5b5bcc8aba6 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Interfaces/PartialAirTerminal.mo @@ -0,0 +1,168 @@ +within Buildings.Templates.ZoneEquipment.Interfaces; +partial model PartialAirTerminal + "Interface class for air terminal unit" + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium" + annotation(__ctrl_flow(enable=false)); + replaceable package MediumHeaWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "HHW medium" + annotation(Dialog(enable=have_souHeaWat), __ctrl_flow(enable=false)); + + parameter Buildings.Templates.ZoneEquipment.Types.Configuration typ + "Type of system" + annotation (Evaluate=true, Dialog(group="Configuration")); + + final parameter String id=dat.id + "System tag" + annotation (Dialog(group="Configuration")); + + parameter Boolean have_souChiWat + "Set to true if system uses CHW" + annotation (Evaluate=true, Dialog(group="Configuration")); + parameter Boolean have_souHeaWat + "Set to true if system uses HHW" + annotation (Evaluate=true, Dialog(group="Configuration")); + + replaceable parameter Buildings.Templates.ZoneEquipment.Data.PartialAirTerminal dat( + final typ=typ, + final have_souChiWat=have_souChiWat, + final have_souHeaWat=have_souHeaWat) + "Design and operating parameters" + annotation (Placement(transformation(extent={{270,250},{290,270}}))); + + // Design parameters + final parameter Modelica.Units.SI.MassFlowRate mAir_flow_nominal= + dat.mAir_flow_nominal + "Discharge air mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.MassFlowRate mAirPri_flow_nominal + "Primary air mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.MassFlowRate mChiWat_flow_nominal + "Total CHW mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.MassFlowRate mHeaWat_flow_nominal + "Total HHW mass flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.HeatFlowRate QChiWat_flow_nominal + "Total CHW heat flow rate" + annotation (Dialog(group="Nominal condition")); + parameter Modelica.Units.SI.HeatFlowRate QHeaWat_flow_nominal + "Total HHW heat flow rate" + annotation (Dialog(group="Nominal condition")); + + parameter Modelica.Fluid.Types.Dynamics energyDynamics= + Modelica.Fluid.Types.Dynamics.DynamicFreeInitial + "Type of energy balance: dynamic (3 initialization options) or steady state" + annotation(Evaluate=true, Dialog(tab = "Dynamics", group="Conservation equations"), + __ctrl_flow(enable=false)); + final parameter Boolean allowFlowReversalAir=true + "= true to allow flow reversal, false restricts to design direction - Air side" + annotation (Dialog(tab="Assumptions"), Evaluate=true, + __ctrl_flow(enable=false)); + parameter Boolean allowFlowReversalLiq=true + "= true to allow flow reversal, false restricts to design direction - CHW and HW side" + annotation (Dialog(tab="Assumptions", enable=have_souChiWat or have_souHeaWat), + Evaluate=true, + __ctrl_flow(enable=false)); + parameter Boolean show_T = false + "= true, if actual temperature at ports of subcomponents is computed" + annotation(Dialog(tab="Advanced",group="Diagnostics"), + __ctrl_flow(enable=false)); + + Modelica.Fluid.Interfaces.FluidPort_a port_Sup( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversalAir then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ <> Buildings.Templates.ZoneEquipment.Types.Configuration.DualDuct + "Supply air from AHU" + annotation ( + Placement(transformation(extent={{-310,-210},{-290,-190}}), + iconTransformation(extent={{-210,-10},{-190,10}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_SupCol( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversalAir then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ == Buildings.Templates.ZoneEquipment.Types.Configuration.DualDuct + "Dual duct cold deck air supply from AHU" + annotation (Placement(transformation( + extent={{-310,-250},{-290,-230}}), iconTransformation(extent={{-210,-110}, + {-190,-90}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_SupHot( + redeclare final package Medium = MediumAir, + m_flow(min=if allowFlowReversalAir then -Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ == Buildings.Templates.ZoneEquipment.Types.Configuration.DualDuct + "Dual duct hot deck air supply from AHU" + annotation (Placement( + transformation(extent={{-310,-170},{-290,-150}}), iconTransformation( + extent={{-210,90},{-190,110}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_Dis( + redeclare final package Medium =MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + "Discharge air" + annotation (Placement(transformation(extent={{290,-210},{310,-190}}), + iconTransformation(extent={{190,-10},{210,10}}))); + Modelica.Fluid.Interfaces.FluidPort_a port_Ret( + redeclare final package Medium =MediumAir, + m_flow(max=if allowFlowReversalAir then +Modelica.Constants.inf else 0), + h_outflow(start=MediumAir.h_default, nominal=MediumAir.h_default)) + if typ == Buildings.Templates.ZoneEquipment.Types.Configuration.FanPowered + or typ == Buildings.Templates.ZoneEquipment.Types.Configuration.Induction + "Return air" + annotation (Placement( + transformation(extent={{290,-90},{310,-70}}), iconTransformation( + extent={{190,90},{210,110}}))); + + Modelica.Fluid.Interfaces.FluidPort_a port_aHeaWat( + redeclare final package Medium = MediumHeaWat, + m_flow(min=if allowFlowReversalLiq then -Modelica.Constants.inf else 0), + h_outflow(start=MediumHeaWat.h_default, nominal=MediumHeaWat.h_default)) + if have_souHeaWat + "HHW supply port" annotation ( + Placement(transformation(extent={{10,-290},{30,-270}}), + iconTransformation(extent={{40,-210},{60,-190}}))); + Modelica.Fluid.Interfaces.FluidPort_b port_bHeaWat( + redeclare final package Medium = MediumHeaWat, + m_flow(max=if allowFlowReversalLiq then +Modelica.Constants.inf else 0), + h_outflow(start=MediumHeaWat.h_default, nominal=MediumHeaWat.h_default)) + if have_souHeaWat + "HHW return port" annotation ( + Placement(transformation(extent={{-30,-290},{-10,-270}}), + iconTransformation(extent={{-60,-210},{-40,-190}}))); + + Buildings.Templates.ZoneEquipment.Interfaces.Bus bus + "Terminal unit control bus" + annotation (Placement( + transformation( + extent={{-20,-20},{20,20}}, + rotation=90, + origin={-300,0}), iconTransformation( + extent={{-20,-19},{20,19}}, + rotation=90, + origin={-199,160}))); + + annotation ( + Icon(coordinateSystem(preserveAspectRatio=false, + extent={{-200,-200},{200,200}}), graphics={ + Text( + extent={{-155,-218},{145,-258}}, + textColor={0,0,255}, + textString="%name"), Rectangle( + extent={{-200,200},{200,-200}}, + lineColor={0,0,255}, + fillColor={255,255,255}, + fillPattern=FillPattern.Solid)}), + Diagram( + coordinateSystem(preserveAspectRatio=false, extent={{-300,-280},{300, + 280}})), + Documentation(info=" ++This partial class provides a standard interface for air terminal unit templates. +
+")); +end PartialAirTerminal; diff --git a/Buildings/Templates/ZoneEquipment/Interfaces/VAVBox.mo b/Buildings/Templates/ZoneEquipment/Interfaces/VAVBox.mo new file mode 100644 index 00000000000..4ede1463082 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Interfaces/VAVBox.mo @@ -0,0 +1,178 @@ +within Buildings.Templates.ZoneEquipment.Interfaces; +model VAVBox "Interface class for VAV terminal unit" + extends Buildings.Templates.ZoneEquipment.Interfaces.PartialAirTerminal( + redeclare Buildings.Templates.ZoneEquipment.Data.VAVBox dat( + typCoiHea=coiHea.typ, + typValCoiHea=coiHea.typVal, + typDamVAV=damVAV.typ, + typCtl=ctl.typ, + stdVen=ctl.stdVen), + final have_souChiWat=false, + final have_souHeaWat=coiHea.have_sou, + final mAirPri_flow_nominal=mAir_flow_nominal, + final mChiWat_flow_nominal=0, + final mHeaWat_flow_nominal=if coiHea.have_sou then dat.coiHea.mWat_flow_nominal else 0, + final QChiWat_flow_nominal=0, + final QHeaWat_flow_nominal=if coiHea.have_sou then dat.coiHea.Q_flow_nominal else 0); + + inner replaceable Buildings.Templates.Components.Coils.WaterBasedHeating coiHea( + redeclare final package MediumHeaWat = MediumHeaWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + constrainedby Buildings.Templates.Components.Interfaces.PartialCoil( + redeclare final package MediumAir = MediumAir, + final dat=datCoiHea, + final energyDynamics=energyDynamics, + final allowFlowReversalAir=allowFlowReversalAir, + final allowFlowReversalLiq=allowFlowReversalLiq, + final show_T=show_T) + "Heating coil" + annotation ( + choices( + choice(redeclare replaceable Buildings.Templates.Components.Coils.WaterBasedHeating coiHea( + redeclare final package MediumHeaWat = MediumHeaWat, + redeclare final Buildings.Templates.Components.Valves.TwoWayModulating val) + "Hot water coil with two-way valve"), + choice(redeclare replaceable Buildings.Templates.Components.Coils.ElectricHeating coiHea + "Modulating electric heating coil")), + Dialog(group="Heating coil"), + Placement(transformation(extent={{-10,-210},{10,-190}}))); + + inner replaceable Buildings.Templates.Components.Dampers.Modulating damVAV + constrainedby Buildings.Templates.Components.Interfaces.PartialDamper( + redeclare final package Medium = MediumAir, + use_inputFilter=energyDynamics<>Modelica.Fluid.Types.Dynamics.SteadyState, + final allowFlowReversal=allowFlowReversalAir, + final show_T=show_T, + final dat=datDamVAV) + "VAV damper" + annotation (Dialog(group="VAV damper"), + Placement( + transformation( + extent={{-10,-10},{10,10}}, + rotation=0, + origin={-120,-200}))); + + inner replaceable Buildings.Templates.ZoneEquipment.Components.Controls.OpenLoop ctl + constrainedby + Buildings.Templates.ZoneEquipment.Components.Interfaces.PartialControllerVAVBox( + final dat=dat.ctl) + "Control selections" + annotation ( + Dialog(group="Controller"), + Placement(transformation(extent={{-10,-10},{10,10}}))); + + Buildings.Templates.Components.Sensors.Temperature TAirDis( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversalAir, + final have_sen=ctl.typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + ctl.typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly, + final m_flow_nominal=mAir_flow_nominal, + final typ=Buildings.Templates.Components.Types.SensorTemperature.Standard) + "Discharge air temperature sensor" + annotation (Placement(transformation(extent={{90,-210},{110,-190}}))); + Buildings.Templates.Components.Sensors.VolumeFlowRate VAirDis_flow( + redeclare final package Medium = MediumAir, + final allowFlowReversal=allowFlowReversalAir, + final have_sen=ctl.typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat or + ctl.typ==Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly, + final m_flow_nominal=mAir_flow_nominal, + final typ=Buildings.Templates.Components.Types.SensorVolumeFlowRate.FlowCross) + "Airflow sensor" + annotation (Placement(transformation(extent={{-200,-210},{-180,-190}}))); +protected + parameter Buildings.Templates.Components.Data.Damper datDamVAV( + final typ=damVAV.typ, + final m_flow_nominal=dat.damVAV.m_flow_nominal, + final dp_nominal=dat.damVAV.dp_nominal, + final dpFixed_nominal=if damVAV.typ == Buildings.Templates.Components.Types.Damper.None + then 0 else dat.coiHea.dpAir_nominal) + "Local record for VAV damper with lumped flow resistance"; + parameter Buildings.Templates.Components.Data.Coil datCoiHea( + final typ=coiHea.typ, + final typVal=coiHea.typVal, + final have_sou=coiHea.have_sou, + final mAir_flow_nominal=dat.coiHea.mAir_flow_nominal, + final mWat_flow_nominal=dat.coiHea.mWat_flow_nominal, + final dpWat_nominal=dat.coiHea.dpWat_nominal, + final dpValve_nominal=dat.coiHea.dpValve_nominal, + final cap_nominal=dat.coiHea.cap_nominal, + final TWatEnt_nominal=dat.coiHea.TWatEnt_nominal, + final TAirEnt_nominal=dat.coiHea.TAirEnt_nominal, + final dpAir_nominal=if damVAV.typ == Buildings.Templates.Components.Types.Damper.None + then dat.coiHea.dpAir_nominal else 0) + "Local record for coil with lumped flow resistance"; +equation + /* Control point connection - start */ + connect(damVAV.bus, bus.damVAV); + connect(coiHea.bus, bus.coiHea); + connect(TAirDis.y, bus.TAirDis); + connect(VAirDis_flow.y, bus.VAirDis_flow); + /* Control point connection - end */ + connect(port_aHeaWat, coiHea.port_aSou) annotation (Line(points={{20,-280},{ + 20,-260},{5,-260},{5,-210}}, color={0,127,255})); + connect(coiHea.port_bSou, port_bHeaWat) annotation (Line(points={{-5,-210},{-5, + -260},{-20,-260},{-20,-280}}, color={0,127,255})); + connect(damVAV.port_b,coiHea. port_a) + annotation (Line(points={{-110,-200},{-10,-200}}, color={0,127,255})); + connect(bus,ctl. bus) annotation (Line( + points={{-300,0},{-10,0}}, + color={255,204,51}, + thickness=0.5)); + connect(coiHea.port_b, TAirDis.port_a) + annotation (Line(points={{10,-200},{90,-200}}, color={0,127,255})); + connect(TAirDis.port_b, port_Dis) + annotation (Line(points={{110,-200},{300,-200}}, color={0,127,255})); + + connect(port_Sup, VAirDis_flow.port_a) + annotation (Line(points={{-300,-200},{-200,-200}}, color={0,127,255})); + connect(VAirDis_flow.port_b, damVAV.port_a) + annotation (Line(points={{-180,-200},{-130,-200}}, color={0,127,255})); + annotation (Diagram(graphics={ + Line(points={{300,-190},{-300,-190}}, color={0,0,0}), + Line(points={{300,-210},{-300,-210}}, color={0,0,0})}), + defaultComponentName="VAVBox", + Documentation(info=" ++This partial class provides a standard interface for VAV terminal unit templates. +
+"), + Icon(graphics={ + Rectangle( + extent={{-200,20},{200,-20}}, + pattern=LinePattern.None, + fillPattern=FillPattern.Solid, + fillColor={0,127,127}, + lineColor={0,127,127}), + Ellipse( + extent={{-134,4},{-126,-4}}, + lineColor={0,0,0}, + fillPattern=FillPattern.Solid, + fillColor={0,0,0}), + Line( + points={{-120,20},{-140,-20}}, + color={0,0,0}, + thickness=0.5), + Line( + points={{50,-200},{50,-194},{14,-194},{14,-20}}, + color={238,46,47}, + thickness=5, + visible=have_souHeaWat), + Line( + points={{-50,-200},{-50,-194},{-12,-194},{-12,-20}}, + color={238,46,47}, + thickness=5, + visible=have_souHeaWat, + pattern=LinePattern.Dash), + Rectangle( + extent={{-14,20},{16,-20}}, + lineColor={0,0,0}, + fillColor={95,95,95}, + fillPattern=FillPattern.Solid, + lineThickness=0.5, + visible=coiHea.typ <> Buildings.Templates.Components.Types.Coil.None), + Line( + points={{16,20},{-14,-20}}, + color={0,0,0}, + thickness=0.5, + visible=coiHea.typ <> Buildings.Templates.Components.Types.Coil.None)})); +end VAVBox; diff --git a/Buildings/Templates/ZoneEquipment/Interfaces/package.mo b/Buildings/Templates/ZoneEquipment/Interfaces/package.mo new file mode 100644 index 00000000000..83df1077371 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Interfaces/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.ZoneEquipment; +package Interfaces "Interface classes" + extends Modelica.Icons.InterfacesPackage; + +annotation (Documentation(info=" ++This package contains interface classes. +
+")); +end Interfaces; diff --git a/Buildings/Templates/ZoneEquipment/Interfaces/package.order b/Buildings/Templates/ZoneEquipment/Interfaces/package.order new file mode 100644 index 00000000000..66d204a68a4 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Interfaces/package.order @@ -0,0 +1,3 @@ +Bus +PartialAirTerminal +VAVBox diff --git a/Buildings/Templates/ZoneEquipment/Types.mo b/Buildings/Templates/ZoneEquipment/Types.mo new file mode 100644 index 00000000000..846b24d41ac --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Types.mo @@ -0,0 +1,29 @@ +within Buildings.Templates.ZoneEquipment; +package Types "Package with type definitions" + extends Modelica.Icons.TypesPackage; + type Configuration = enumeration( + DualDuct + "Dual duct system", + FanPowered + "Fan-powered system", + Induction + "Induction system", + VAVBoxCoolingOnly + "VAV terminal unit cooling only", + VAVBoxReheat + "VAV terminal unit with reheat") + "Enumeration to configure the terminal unit"; + type Controller = enumeration( + G36VAVBoxCoolingOnly + "Guideline 36 controller for VAV terminal unit cooling only", + G36VAVBoxReheat + "Guideline 36 controller for VAV terminal unit with reheat", + OpenLoop + "Open loop controller") + "Enumeration to configure the terminal unit controller"; + annotation (Documentation(info=" ++This package contains type definitions. +
+")); +end Types; diff --git a/Buildings/Templates/ZoneEquipment/VAVBoxCoolingOnly.mo b/Buildings/Templates/ZoneEquipment/VAVBoxCoolingOnly.mo new file mode 100644 index 00000000000..25d5cf7fba5 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/VAVBoxCoolingOnly.mo @@ -0,0 +1,46 @@ +within Buildings.Templates.ZoneEquipment; +model VAVBoxCoolingOnly "VAV terminal unit cooling only" + extends Buildings.Templates.ZoneEquipment.Interfaces.VAVBox( + final typ=Buildings.Templates.ZoneEquipment.Types.Configuration.VAVBoxCoolingOnly, + redeclare final Buildings.Templates.Components.Coils.None coiHea, + redeclare replaceable Buildings.Templates.ZoneEquipment.Components.Controls.G36VAVBoxCoolingOnly + ctl "Guideline 36 controller for VAV terminal unit cooling only"); + + annotation ( + defaultComponentName="VAVBox", + Documentation(info=" ++This template represents a cooling-only VAV terminal unit +(or shut off box). +
+
+The possible configuration options are enumerated in the table below.
+The user may refer to ASHRAE (2021) for further details.
+The first option displayed in bold characters corresponds to the default configuration.
+
| Configuration parameter | Options | Notes |
|---|---|---|
| VAV damper | +
+Modulating damper + |
++ |
| Controller | ++ASHRAE Guideline 36 controller + | ++An open loop controller is also available for validation purposes only. + | +
+This template represents a VAV terminal unit with reheat. +
+
+The possible configuration options are enumerated in the table below.
+The user may refer to ASHRAE (2021) for further details.
+The first option displayed in bold characters corresponds to the default configuration.
+
| Configuration parameter | Options | Notes |
|---|---|---|
| VAV damper | ++Modulating damper + | ++ |
| Reheat coil | +
+Hot water coil with two-way valve +Modulating electric heating coil + |
++ |
| Controller | ++ASHRAE Guideline 36 controller + | ++An open loop controller is also available for validation purposes only. + | +
+This class generates signals typically provided by the AHU controller. +It is aimed for validation purposes only. +
+")); +end VAVMZControlPoints; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.mo new file mode 100644 index 00000000000..7a4c2181fc9 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.mo @@ -0,0 +1,9 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject; +package AirHandlersFans "Air handlers and fans" + +annotation (Documentation(info=" ++This package contains models used for validation purposes. +
+")); +end AirHandlersFans; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.order b/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.order new file mode 100644 index 00000000000..37a691c0513 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/AirHandlersFans/package.order @@ -0,0 +1 @@ +VAVMZControlPoints diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/BASControlPoints.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/BASControlPoints.mo new file mode 100644 index 00000000000..0f22f35818e --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/BASControlPoints.mo @@ -0,0 +1,71 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject; +block BASControlPoints "Emulation of control points from the BAS" + extends Modelica.Blocks.Icons.Block; + + parameter Integer nZon = 2 + "Number of served zones"; + + Interfaces.Bus busTer[nZon] + "Terminal unit control bus" annotation (Placement(transformation( + extent={{-20,20},{20,-20}}, + rotation=90, + origin={200,0}), iconTransformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={100,0}))); + Controls.OBC.CDL.Logical.Sources.Constant y1OccSch[nZon]( + each k=true) + "Scheduled occupancy" + annotation (Placement(transformation(extent={{-10,50},{10,70}}))); + Controls.OBC.CDL.Integers.Sources.Constant yOveFloSet[nZon](each k=0) + "Override flow setpoint, 1: set to zero; 2: set to cooling maximum; 3: set to minimum; 4: set to heating maximum" + annotation (Placement(transformation(extent={{-10,10},{10,30}}))); + Controls.OBC.CDL.Logical.Sources.Constant y1OveHeaOff[nZon]( + each k=false) + "Override heating coil valve position, true: close valve" + annotation (Placement(transformation(extent={{-10,-70},{10,-50}}))); + Controls.OBC.CDL.Integers.Sources.Constant yOveDamPos[nZon](each k=0) + "Override damper position, 1: set to close; 2: set to open" + annotation (Placement(transformation(extent={{-10,-30},{10,-10}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TZonHeaOccSet[nZon]( + each k=293.15) + "Occupied heating setpoint" + annotation (Placement(transformation(extent={{-100,50},{-80,70}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TZonCooOccSet[nZon]( + each k=297.15) + "Occupied cooling setpoint" + annotation (Placement(transformation(extent={{-100,10},{-80,30}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TZonHeaUnoSet[nZon]( + each k=285.15) + "Unoccupied heating setpoint" + annotation (Placement(transformation(extent={{-100,-30},{-80,-10}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TZonCooUnoSet[nZon]( + each k=303.15) + "Unoccupied cooling setpoint" + annotation (Placement(transformation(extent={{-100,-70},{-80,-50}}))); + Controls.OBC.CDL.Continuous.Sources.Constant ppmCO2Set[nZon]( + each k=1000) + "Zone CO2 concentration setpoint" + annotation (Placement(transformation(extent={{-100,-110},{-80,-90}}))); +equation + connect(y1OccSch.y, busTer.y1OccSch); + connect(yOveFloSet.y, busTer.yOveFloSet); + connect(yOveDamPos.y, busTer.yOveDamPos); + connect(y1OveHeaOff.y, busTer.y1OveHeaOff); + + connect(TZonHeaOccSet.y, busTer.TZonHeaOccSet); + connect(TZonCooOccSet.y, busTer.TZonCooOccSet); + connect(TZonHeaUnoSet.y, busTer.TZonHeaUnoSet); + connect(TZonCooUnoSet.y, busTer.TZonCooUnoSet); + connect(ppmCO2Set.y, busTer.ppmCO2Set); + annotation ( + defaultComponentName="sigBAS", + Diagram(coordinateSystem(preserveAspectRatio= + false, extent={{-200,-180},{200,180}})), + Documentation(info=" ++This class generates signals typically provided by the BAS. +It is aimed for validation purposes only. +
+")); +end BASControlPoints; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/AllSystems.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/AllSystems.mo new file mode 100644 index 00000000000..de87888e4a9 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/AllSystems.mo @@ -0,0 +1,68 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject.Data; +class AllSystems "Top-level (whole building) system parameters" + extends Buildings.Templates.Data.AllSystems(stdVen=Buildings.Controls.OBC.ASHRAE.G36.Types.VentilationStandard.ASHRAE62_1, + stdEne=Buildings.Controls.OBC.ASHRAE.G36.Types.EnergyStandard.ASHRAE90_1); + + /* + The construct below where a replaceable model is used inside the `outer` + component declaration is for validation purposes only, where various configuration + classes are tested with the same instance name `VAV_1`. + It is needed here because + - the `inner` instance must be a subtype of the `outer` component, and + - the `outer` component references only the subcomponents from its own type + (as opposed to all the subcomponents from the `inner` type), and + - modification of an outer declaration is prohibited. + The standard export workflow should use an explicit reference to the configuration + class for each MZVAV model instance. + */ + replaceable model VAVBox = + Buildings.Templates.ZoneEquipment.Interfaces.PartialAirTerminal + "Model of VAV box"; + + outer VAVBox VAVBox_1 + "Instance of VAV box model"; + + parameter Buildings.Templates.ZoneEquipment.Data.VAVBox dat_VAVBox_1( + final typ=VAVBox_1.typ, + final have_souChiWat=VAVBox_1.have_souChiWat, + final have_souHeaWat=VAVBox_1.have_souHeaWat, + final typCtl=VAVBox_1.ctl.typ, + final typDamVAV=VAVBox_1.damVAV.typ, + final typCoiHea=VAVBox_1.coiHea.typ, + final typValCoiHea=VAVBox_1.coiHea.typVal, + final stdVen=VAVBox_1.ctl.stdVen, + id="VAVBox_1", + id_souAir="VAV_1", + damVAV(dp_nominal=50), + coiHea( + cap_nominal=1e3, + dpAir_nominal=70, + dpWat_nominal=0.1e4, + dpValve_nominal=0.05e4, + mWat_flow_nominal=1e3/4186/10, + TAirEnt_nominal=285.15, + TWatEnt_nominal=323.15), + ctl( + final stdVen=VAVBox_1.ctl.stdVen, + VAirCooSet_flow_max=0.1, + VAirHeaSet_flow_max=0.03, + VOutMinOcc_flow=2.5e-3, + VOutMinAre_flow=3e-3, + VOutOcc_flow=2.5e-3, + VOutAre_flow=3e-3, + VAirSet_flow_min=0.01)) + "Parameters for system VAVBox_1" + annotation ( + Dialog(group="Zone equipment")); + + annotation ( + defaultComponentPrefixes = "inner parameter", + defaultComponentName = "datAll", + Documentation(info=" ++This record provides the set of sizing and operating parameters for +the whole HVAC system. +It is aimed for validation purposes only. +
+")); +end AllSystems; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.mo new file mode 100644 index 00000000000..7bd66c6b4e4 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.mo @@ -0,0 +1,11 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject; +package Data "Package with classes for storing system parameters" + extends Modelica.Icons.MaterialPropertiesPackage; + +annotation (Documentation(info=" ++This package provides records for design and operating parameters +that are used for validation purposes. +
+")); +end Data; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.order b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.order new file mode 100644 index 00000000000..3831742ec60 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/Data/package.order @@ -0,0 +1 @@ +AllSystems diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/PlantControlPoints.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/PlantControlPoints.mo new file mode 100644 index 00000000000..43eed095514 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/PlantControlPoints.mo @@ -0,0 +1,39 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject; +block PlantControlPoints + "Emulation of control points from plant" + extends Modelica.Blocks.Icons.Block; + + parameter Integer nZon = 2 + "Number of served zones"; + + Buildings.Controls.OBC.CDL.Logical.Sources.Constant y1PlaHeaWat[nZon]( + each k=true) "Heating hot water plant status" + annotation (Placement(transformation(extent={{0,-10},{20,10}}))); + Interfaces.Bus busTer[nZon] + "Terminal unit control bus" annotation (Placement(transformation( + extent={{-20,20},{20,-20}}, + rotation=90, + origin={200,0}), iconTransformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={100,0}))); +equation + + connect(y1PlaHeaWat.y, busTer.y1PlaHeaWat) annotation (Line(points={{22,0},{ + 200,0}}, color={255,0,255}), Text( + string="%second", + index=1, + extent={{6,3},{6,3}}, + horizontalAlignment=TextAlignment.Left)); + annotation ( + defaultComponentName="sigPla", + Diagram(coordinateSystem(preserveAspectRatio= + false, extent={{-200,-180},{200,180}})), + Documentation(info=" ++This class generates signals typically provided by the HHW and CHW plant +controller. +It is aimed for validation purposes only. +
+")); +end PlantControlPoints; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneControlPoints.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneControlPoints.mo new file mode 100644 index 00000000000..b5b68009b9e --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneControlPoints.mo @@ -0,0 +1,50 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject; +block ZoneControlPoints "Emulation of control points from zone sensors and thermostats" + extends Modelica.Blocks.Icons.Block; + + Interfaces.Bus bus + "Terminal unit control bus" + annotation (Placement( + transformation( + extent={{-20,20},{20,-20}}, + rotation=90, + origin={200,0}), iconTransformation( + extent={{-10,10},{10,-10}}, + rotation=90, + origin={100,0}))); + + Buildings.Controls.OBC.CDL.Logical.Sources.Constant y1Occ(k=true) + "Occupancy sensor status" + annotation (Placement(transformation(extent={{-60,-10},{-40,10}}))); + Controls.OBC.CDL.Logical.Sources.Constant y1Win(k=true) + "Window switch status" + annotation (Placement(transformation(extent={{-60,-50},{-40,-30}}))); + Controls.OBC.CDL.Continuous.Sources.Constant TZon(k=303.15) + "Zone temperature" + annotation (Placement(transformation(extent={{-120,-10},{-100,10}}))); + Controls.OBC.CDL.Logical.Sources.Constant y1OveOccZon( + k=false) + "Zone occupancy override" + annotation (Placement(transformation(extent={{0,-10},{20,10}}))); + Controls.OBC.CDL.Continuous.Sources.Constant ppmCO2(k=1000) + "Zone CO2 concentration" + annotation (Placement(transformation(extent={{-120,-50},{-100,-30}}))); + +equation + connect(y1Occ.y, bus.y1Occ); + connect(y1Win.y, bus.y1Win); + connect(TZon.y, bus.TZon); + connect(ppmCO2.y, bus.ppmCO2); + connect(y1OveOccZon.y, bus.y1OveOccZon); + + annotation ( + defaultComponentName="sigZon", + Diagram(coordinateSystem(preserveAspectRatio= + false, extent={{-200,-180},{200,180}})), + Documentation(info=" ++This class generates signals typically provided by the zone equipment. +It is aimed for validation purposes only. +
+")); +end ZoneControlPoints; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnly.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnly.mo new file mode 100644 index 00000000000..a32296acd66 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnly.mo @@ -0,0 +1,17 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment; +model VAVBoxCoolingOnly "Configuration of VAV terminal unit cooling only" + extends Buildings.Templates.ZoneEquipment.VAVBoxCoolingOnly( + redeclare replaceable Buildings.Templates.ZoneEquipment.Components.Controls.OpenLoop ctl + "Open loop control"); + annotation ( + defaultComponentName="ter", + Icon(coordinateSystem(preserveAspectRatio=false)), Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" ++This is a configuration model with the same default options as + +Buildings.Templates.ZoneEquipment.VAVBoxCoolingOnly. +
+")); +end VAVBoxCoolingOnly; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnlyControlG36.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnlyControlG36.mo new file mode 100644 index 00000000000..0ae28c5d8a8 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/VAVBoxCoolingOnlyControlG36.mo @@ -0,0 +1,22 @@ +within Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment; +model VAVBoxCoolingOnlyControlG36 + "Configuration of VAV terminal unit cooling only" + extends Buildings.Templates.ZoneEquipment.VAVBoxCoolingOnly; + + annotation ( + defaultComponentName="ter", + Icon(coordinateSystem(preserveAspectRatio=false)), Diagram( + coordinateSystem(preserveAspectRatio=false)), + Documentation(info=" +
+This is a configuration model with the same default options as
+
+Buildings.Templates.ZoneEquipment.VAVBoxReheat
+except for the following options.
+
| Component | Configuration |
|---|---|
| Controller | Guideline 36 controller |
+This is a configuration model with the same default options as
+
+Buildings.Templates.ZoneEquipment.VAVBoxReheat
+except for the following options.
+
| Component | Configuration |
|---|---|
| Controller | Guideline 36 controller |
+This package contains models used for validation purposes. +
+")); +end ZoneEquipment; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/package.order b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/package.order new file mode 100644 index 00000000000..ec909c75cf9 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/ZoneEquipment/package.order @@ -0,0 +1,3 @@ +VAVBoxCoolingOnly +VAVBoxCoolingOnlyControlG36 +VAVBoxReheatControlG36 diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.mo b/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.mo new file mode 100644 index 00000000000..06b5503be30 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates.ZoneEquipment.Validation; +package UserProject "Package with configured models" + extends Modelica.Icons.VariantsPackage; + +annotation (Documentation(info=" ++This package contains models used for validation purposes. +
+")); +end UserProject; diff --git a/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.order b/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.order new file mode 100644 index 00000000000..93ffb0bb8e3 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/UserProject/package.order @@ -0,0 +1,6 @@ +BASControlPoints +PlantControlPoints +ZoneControlPoints +AirHandlersFans +ZoneEquipment +Data diff --git a/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnly.mo b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnly.mo new file mode 100644 index 00000000000..bb0f08cf278 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnly.mo @@ -0,0 +1,117 @@ +within Buildings.Templates.ZoneEquipment.Validation; +model VAVBoxCoolingOnly "Validation model for VAV terminal unit cooling only" + extends Modelica.Icons.Example; + + replaceable package MediumAir=Buildings.Media.Air + constrainedby Modelica.Media.Interfaces.PartialMedium + "Air medium"; + replaceable package MediumHeaWat=Buildings.Media.Water + constrainedby Modelica.Media.Interfaces.PartialMedium + "Heating medium (such as HHW)"; + + inner parameter UserProject.Data.AllSystems datAll( + sysUni=Buildings.Templates.Types.Units.SI, + ashCliZon=Buildings.Controls.OBC.ASHRAE.G36.Types.ASHRAEClimateZone.Zone_3B, + redeclare replaceable model VAVBox = + UserProject.ZoneEquipment.VAVBoxCoolingOnly) + "System parameters" + annotation (Placement(transformation(extent={{90,92},{110,112}}))); + + Fluid.Sources.Boundary_pT bouPri( + redeclare final package Medium = MediumAir, + p=MediumAir.p_default + 200, + nPorts=1) "Boundary conditions for primary air distribution system" + annotation (Placement(transformation(extent={{-80,-50},{-60,-30}}))); + Fluid.FixedResistances.PressureDrop res( + redeclare final package Medium = MediumAir, + m_flow_nominal=1, + dp_nominal=100) + annotation (Placement(transformation(extent={{-50,-50},{-30,-30}}))); + Fluid.FixedResistances.PressureDrop res1( + redeclare final package Medium = MediumAir, + m_flow_nominal=1, + dp_nominal=100) + annotation (Placement(transformation(extent={{30,-50},{50,-30}}))); + Fluid.Sources.Boundary_pT bouBui( + redeclare final package Medium = MediumAir, + nPorts=1) "Boundary conditions for indoor environment" + annotation (Placement(transformation(extent={{80,-50},{60,-30}}))); + + inner replaceable UserProject.ZoneEquipment.VAVBoxCoolingOnly VAVBox_1( + final dat=datAll.dat_VAVBox_1, + redeclare final package MediumAir = MediumAir, + redeclare final package MediumHeaWat = MediumHeaWat) + "Terminal unit" + annotation (Placement(transformation(extent={{-20,-60},{20,-20}}))); + + Fluid.Sources.Boundary_pT bouHeaWat( + redeclare final package Medium = MediumHeaWat, + nPorts=2) if VAVBox_1.have_souHeaWat + "Boundary conditions for HHW distribution system" + annotation (Placement(transformation(extent={{-80,-90},{-60,-70}}))); + UserProject.AirHandlersFans.VAVMZControlPoints sigAirHan if VAVBox_1.ctl.typ == + Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly or + VAVBox_1.ctl.typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat + "Control signals from AHU" + annotation (Placement(transformation(extent={{-80,20},{-60,40}}))); + UserProject.ZoneControlPoints sigZon + if VAVBox_1.ctl.typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly + or VAVBox_1.ctl.typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat + "Control signals from zone-level equipment" + annotation (Placement(transformation(extent={{-80,-10},{-60,10}}))); + UserProject.PlantControlPoints sigPla if VAVBox_1.ctl.typ == + Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxCoolingOnly or + VAVBox_1.ctl.typ == Buildings.Templates.ZoneEquipment.Types.Controller.G36VAVBoxReheat + "Control signals from AHU" + annotation (Placement(transformation(extent={{-80,50},{-60,70}}))); + UserProject.BASControlPoints sigBAS + "BAS control points" + annotation (Placement(transformation(extent={{-80,80},{-60,100}}))); +equation + connect(bouPri.ports[1], res.port_a) + annotation (Line(points={{-60,-40},{-50,-40}}, + color={0,127,255})); + connect(bouBui.ports[1], res1.port_b) + annotation (Line(points={{60,-40},{50,-40}}, + color={0,127,255})); + connect(res.port_b, VAVBox_1.port_Sup) + annotation (Line(points={{-30,-40},{-20,-40}}, color={0,127,255})); + connect(VAVBox_1.port_Dis, res1.port_a) + annotation (Line(points={{20,-40},{30,-40}}, color={0,127,255})); + connect(VAVBox_1.port_aHeaWat, bouHeaWat.ports[1]) annotation (Line(points={{5,-60}, + {5,-82},{-60,-82},{-60,-81}}, color={0,127,255})); + connect(VAVBox_1.port_bHeaWat, bouHeaWat.ports[2]) + annotation (Line(points={{-5,-60},{-5,-79},{-60,-79}}, color={0,127,255})); + connect(sigZon.bus, VAVBox_1.bus) annotation (Line( + points={{-60,0},{-20,0},{-20,-24},{-19.9,-24}}, + color={255,204,51}, + thickness=0.5)); + connect(sigAirHan.busTer[1], VAVBox_1.bus) annotation (Line( + points={{-60,30},{-20,30},{-20,-24},{-19.9,-24}}, + color={255,204,51}, + thickness=0.5)); + connect(sigPla.busTer[1], VAVBox_1.bus) annotation (Line( + points={{-60,60},{-19.9,60},{-19.9,-24}}, + color={255,204,51}, + thickness=0.5)); + connect(sigBAS.busTer[1], VAVBox_1.bus) annotation (Line( + points={{-60,90},{-19.9,90},{-19.9,-24}}, + color={255,204,51}, + thickness=0.5)); + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnly.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=1), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment.VAVBoxCoolingOnly. +It is intended to check whether the template model is well-defined for +this particular system configuration. +However, due to the open-loop controls a correct physical behavior +is not expected and the plotted variables are for non-regression testing only. +
+"), + Diagram(coordinateSystem(extent={{-120,-120},{120,120}}))); +end VAVBoxCoolingOnly; diff --git a/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnlyControlG36.mo b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnlyControlG36.mo new file mode 100644 index 00000000000..29247a55157 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnlyControlG36.mo @@ -0,0 +1,22 @@ +within Buildings.Templates.ZoneEquipment.Validation; +model VAVBoxCoolingOnlyControlG36 + "Validation model for VAV terminal unit cooling only" + extends VAVBoxCoolingOnly( + datAll( + redeclare model VAVBox = + UserProject.ZoneEquipment.VAVBoxCoolingOnlyControlG36), + redeclare UserProject.ZoneEquipment.VAVBoxCoolingOnlyControlG36 VAVBox_1); + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/ZoneEquipment/Validation/VAVBoxCoolingOnlyControlG36.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=3600), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment.VAVBoxCoolingOnlyControlG36. +It is intended to check whether the template model is well-defined for +this particular system configuration. +
+")); +end VAVBoxCoolingOnlyControlG36; diff --git a/Buildings/Templates/ZoneEquipment/Validation/VAVBoxReheatControlG36.mo b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxReheatControlG36.mo new file mode 100644 index 00000000000..9cb8c23cbf8 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/VAVBoxReheatControlG36.mo @@ -0,0 +1,21 @@ +within Buildings.Templates.ZoneEquipment.Validation; +model VAVBoxReheatControlG36 "Validation model for VAV terminal unit with reheat" + extends VAVBoxCoolingOnly( + datAll( + redeclare model VAVBox = + UserProject.ZoneEquipment.VAVBoxReheatControlG36), + redeclare UserProject.ZoneEquipment.VAVBoxReheatControlG36 VAVBox_1); + annotation ( + __Dymola_Commands( + file="modelica://Buildings/Resources/Scripts/Dymola/Templates/ZoneEquipment/Validation/VAVBoxReheatControlG36.mos" + "Simulate and plot"), + experiment(Tolerance=1e-6, StopTime=3600), Documentation(info=" ++This is a validation model for the configuration represented by + +Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment.VAVBoxReheatControlG36. +It is intended to check whether the template model is well-defined for +this particular system configuration. +
+")); +end VAVBoxReheatControlG36; diff --git a/Buildings/Templates/ZoneEquipment/Validation/package.mo b/Buildings/Templates/ZoneEquipment/Validation/package.mo new file mode 100644 index 00000000000..4bdfd1da9ad --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/package.mo @@ -0,0 +1,22 @@ +within Buildings.Templates.ZoneEquipment; +package Validation "Package with validation models" + extends Modelica.Icons.ExamplesPackage; + + annotation ( + preferredView="info", + Documentation(info=" ++This package contains models validating the templates within + +Buildings.Templates.ZoneEquipment +for various system configurations. +
++Each system configuration is specified by extending the original template class +to create a so-called configuration class (under + +Buildings.Templates.ZoneEquipment.Validation.UserProject.ZoneEquipment), +that is instantiated in the validation model. +
+")); +end Validation; diff --git a/Buildings/Templates/ZoneEquipment/Validation/package.order b/Buildings/Templates/ZoneEquipment/Validation/package.order new file mode 100644 index 00000000000..1afdeec2e50 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/Validation/package.order @@ -0,0 +1,4 @@ +VAVBoxCoolingOnly +VAVBoxCoolingOnlyControlG36 +VAVBoxReheatControlG36 +UserProject diff --git a/Buildings/Templates/ZoneEquipment/package.mo b/Buildings/Templates/ZoneEquipment/package.mo new file mode 100644 index 00000000000..ad011651305 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/package.mo @@ -0,0 +1,10 @@ +within Buildings.Templates; +package ZoneEquipment "Zone equipment" + extends Modelica.Icons.Package; + +annotation (Documentation(info=" ++This package contains templates for zone equipment (HVAC terminal units). +
+")); +end ZoneEquipment; diff --git a/Buildings/Templates/ZoneEquipment/package.order b/Buildings/Templates/ZoneEquipment/package.order new file mode 100644 index 00000000000..90615915645 --- /dev/null +++ b/Buildings/Templates/ZoneEquipment/package.order @@ -0,0 +1,7 @@ +VAVBoxCoolingOnly +VAVBoxReheat +Components +Data +Types +Validation +Interfaces diff --git a/Buildings/Templates/package.mo b/Buildings/Templates/package.mo new file mode 100644 index 00000000000..c4f771eb327 --- /dev/null +++ b/Buildings/Templates/package.mo @@ -0,0 +1,20 @@ +within Buildings; +package Templates "Package with templates for various HVAC systems" + extends Modelica.Icons.Package; + + annotation (Documentation(info=" ++This package contains templates for common HVAC systems. +A template is defined as a user-configurable model that can represent various +configurations of the same system. The templates include closed-loop controls as +implemented within + +Buildings.Controls.OBC. +
+"), Icon(graphics={Text( + extent={{-100,100},{100,-100}}, + textColor={0,0,0}, + fontName="monospace", + textStyle={TextStyle.Bold}, + textString="T")})); +end Templates; diff --git a/Buildings/Templates/package.order b/Buildings/Templates/package.order new file mode 100644 index 00000000000..9c28253a22a --- /dev/null +++ b/Buildings/Templates/package.order @@ -0,0 +1,6 @@ +UsersGuide +AirHandlersFans +Components +ZoneEquipment +Data +Types diff --git a/Buildings/package.mo b/Buildings/package.mo index 85bd2f49ceb..9549c03423c 100644 --- a/Buildings/package.mo +++ b/Buildings/package.mo @@ -217,6 +217,15 @@ Version 10.0.0 is ... xxx The following new libraries have been added:| Buildings.Templates + | +Package that contains templates for HVAC systems with control sequences + based on ASHRAE Guideline 36. + Currently limited to VAV systems, the package is under active development + and will be further expanded with templates for primary systems and various + types of zone equipment. + | +
| Buildings.ThermalZones.ISO13790 | Package that contains models for reduced building physics of thermal zones
@@ -820,16 +829,6 @@ have been improved in a
#3277. |
| Buildings.Controls.OBC.CDL.Continuous.Sources.Sin - | -Renamed block from Sine to Sin
- to use consistent naming with
- Buildings.Controls.OBC.CDL.Continuous.Sin.- This is for - #3339. - This change is supported in the conversion script. - |
-
| Buildings.Controls.OBC.CDL.Routing.RealExtractor | Removed parameter allowOutOfRange and outOfRangeValue and output the element with the nearest valid index
diff --git a/Buildings/package.order b/Buildings/package.order
index 2f79ab027f2..dbc4ec10240 100644
--- a/Buildings/package.order
+++ b/Buildings/package.order
@@ -9,6 +9,7 @@ Fluid
HeatTransfer
Media
Occupants
+Templates
ThermalZones
Utilities
Types
|