modelStageChangeCommandPolyvalent

Validation model for stage change logic with polyvalent heat pumps
Diagram of StageChangeCommandPolyvalentOpen the diagram
▶ Simulate in your browser

Extends from Buildings.Templates.Plants.Controls.StagingRotation.Validation.StageChangeCommand (Validation model for stage change logic).

Information

This model validates Buildings.Templates.Plants.Controls.StagingRotation.StageChangeCommand in a configuration with two reversible heat pumps and two polyvalent heat pumps. In response to a varying flow rate, the variation of the required capacity chaSta.capReq.y triggers stage change events. The block Buildings.Templates.Plants.Controls.Utilities.StageIndex is used to illustrate how these events translate into a varying plant stage index idxSta.y.

Parameters

TypeNameDefaultDescription
IntegernSta (from StageChangeCommand)chaSta.nStaNumber of stages
IntegernEqu (from StageChangeCommand)chaSta.nEquNumber of pieces of equipment
RealcapHeaHp_nominal1E5Design heating capacity - Each heat pump (excluding polyvalent HP)
RealcapHeaPhp_nominal0.9E5Design heating capacity - Each polyvalent heat pump
RealcapHeaPhpShc_nominalBuildings.Templates.Data.Defaults.COPHpWwHea/Buildings.Templates.Data.Defaults.COPHpAwHea*capHeaPhp_nominalDesign heating capacity in SHC mode - Each polyvalent heat pump
Configuration
Booleanhave_php (from StageChangeCommand)falseSet to true for plants with polyvalent heat pumps
Realcp_default (from StageChangeCommand)4184Default specific heat capacity
Realrho_default (from StageChangeCommand)996Default specific heat capacity
Nominal condition
RealcapHea_nominal (from StageChangeCommand)sum(chaSta.capEqu)Installed heating capacity
RealTHeaWatSup_nominal (from StageChangeCommand)50 + 273.15Design HW supply temperature
RealTHeaWatRet_nominal (from StageChangeCommand)42 + 273.15Design HW return temperature
RealVHeaWat_flow_nominal (from StageChangeCommand)capHea_nominal/(THeaWatSup_nominal - THeaWatRet_nominal)/cp_default/rho_defaultDesign primary HW volume flow rate

Components

TypeNameDefaultDescription
Buildings.Controls.OBC.CDL.Reals.Sources.TimeTableratV_flow (from StageChangeCommand)Source signal for volume flow rate ratio
Buildings.Templates.Plants.Controls.StagingRotation.StageChangeCommandchaSta (from StageChangeCommand)Generate stage change command
Buildings.Controls.OBC.CDL.Reals.Sources.ConstantTSupSet (from StageChangeCommand)HWST setpoint
Buildings.Controls.OBC.CDL.Reals.Sources.ConstantTRet (from StageChangeCommand)HWRT
Utilities.StageIndexidxSta (from StageChangeCommand)Compute stage index
Buildings.Controls.OBC.CDL.Logical.Sources.Constantu1Lea (from StageChangeCommand)Lead equipment enable signal
Buildings.Controls.OBC.CDL.Logical.Sources.Constant[nSta]u1AvaSta (from StageChangeCommand)Stage available signal
Buildings.Controls.OBC.CDL.Logical.TrueFalseHoldy1UpHol (from StageChangeCommand)Hold stage up command for plotting
Buildings.Controls.OBC.CDL.Logical.TrueFalseHoldy1DowHol (from StageChangeCommand)Hold stage down command for plotting
Buildings.Controls.OBC.CDL.Reals.MultiplyByParameterV_flow (from StageChangeCommand)Scale by design flow
Buildings.Templates.Plants.Controls.StagingRotation.EquipmentEnableenaEqu (from StageChangeCommand)Enable equipment
Buildings.Controls.OBC.CDL.Integers.Sources.Constant[2]idxEquLeaLag (from StageChangeCommand)Indices of lead/lag equipment
Buildings.Controls.OBC.CDL.Logical.Sources.Constant[nEqu]u1AvaEqu (from StageChangeCommand)Equipment available signal
Components.Controls.StatusEmulator[nEqu]staEqu (from StageChangeCommand)Evaluate equipment status
Buildings.Templates.Plants.Controls.StagingRotation.StageCompletioncomSta (from StageChangeCommand)Check completion of stage change
Buildings.Templates.Plants.Controls.HeatPumps.Subsequences.SelectModeStateselModSelect equipment mode at stage
PolyvalentHeatPumps.StagingParametersstaPhpStaging parameters
Buildings.Controls.OBC.CDL.Integers.Sources.TimeTablestaCooCooling stage, and next higher stage
PolyvalentHeatPumps.ExtractStagingMatrixextStaCooExtract transpose of cooling staging matrix at heating stage

Revisions

  • June 10, 2026, by Antoine Gautier:
    First implementation.