modelSingleVariable
Single fan - Variable speed
Extends from Buildings.Templates.Components.Interfaces.PartialFan (Interface class for fan).
Information
This is a model for a variable speed fan (with VFD).
-
The fan is commanded On with a Boolean signal
y1(VFD Run). -
The fan speed is modulated with a fractional speed signal
y(real).
y = 0corresponds to 0 Hz.y = 1corresponds to the maximum speed set in the VFD. -
A status signal
y1_actual(Boolean) is returned.
y1_actual = truemeans that the fan is on.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Templates.Components.Data.Fan | dat (from PartialFan) | Design and operating parameters | |
| Modelica.Units.SI.PressureDifference | dp_nominal (from PartialFan) | dat.dp_nominal | Total pressure rise |
| Assumptions | |||
| Boolean | allowFlowReversal (from PartialTwoPort) | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Nominal condition | |||
| Modelica.Units.SI.MassFlowRate | m_flow_nominal (from PartialTwoPortInterface) | Nominal mass flow rate | |
| Advanced | |||
| Modelica.Units.SI.MassFlowRate | m_flow_small (from PartialTwoPortInterface) | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow |
| Advanced › Diagnostics | |||
| Boolean | show_T (from PartialTwoPortInterface) | false | = true, if actual temperature at port is computed |
| Configuration | |||
| Buildings.Templates.Components.Types.Fan | typ (from PartialFan) | Equipment type | |
| Boolean | have_senFlo (from PartialFan) | false | Set to true for air flow measurement |
| Integer | nFan (from PartialFan) | Number of fans | |
| Dynamics › Nominal condition | |||
| Modelica.Units.SI.Time | tau (from PartialFan) | 1 | Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic |
| Dynamics › Conservation equations | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics (from PartialFan) | Modelica.Fluid.Types.Dynamics.DynamicFreeInitial | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Buildings.Templates.Components.Types.FanSingle | typSin (from PartialFan) | Buildings.Templates.Components.Types.FanSingle.Housed | Type of single fan |
| Integer | text_rotation (from PartialFan) | 0 | Text rotation angle in icon layer |
| Boolean | text_flip (from PartialFan) | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Fluid.Interfaces.FluidPort_a | port_a (from PartialTwoPort) | Fluid connector a (positive design flow direction is from port_a to port_b) | |
| Modelica.Fluid.Interfaces.FluidPort_b | port_b (from PartialTwoPort) | Fluid connector b (positive design flow direction is from port_a to port_b) | |
| Buildings.Templates.Components.Interfaces.Bus | bus (from PartialFan) | Control bus |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Units.SI.MassFlowRate | m_flow (from PartialTwoPortInterface) | port_a.m_flow | Mass flow rate from port_a to port_b (m_flow > 0 is design flow direction) |
| Modelica.Units.SI.PressureDifference | dp (from PartialTwoPortInterface) | port_a.p - port_b.p | Pressure difference between port_a and port_b |
| Medium.ThermodynamicState | sta_a (from PartialTwoPortInterface) | if allowFlowReversal then Medium.setState_phX(port_a.p, noEvent(actualStream(port_a.h_outflow)), noEvent(actualStream(port_a.Xi_outflow))) else Medium.setState_phX(port_a.p, noEvent(inStream(port_a.h_outflow)), noEvent(inStream(port_a.Xi_outflow))) | Medium properties in port_a |
| Medium.ThermodynamicState | sta_b (from PartialTwoPortInterface) | if allowFlowReversal then Medium.setState_phX(port_b.p, noEvent(actualStream(port_b.h_outflow)), noEvent(actualStream(port_b.Xi_outflow))) else Medium.setState_phX(port_b.p, noEvent(port_b.h_outflow), noEvent(port_b.Xi_outflow)) | Medium properties in port_b |
| Buildings.Templates.Components.Sensors.VolumeFlowRate | V_flow (from PartialFan) | Air volume flow rate sensor | |
| Buildings.Templates.Components.BaseClasses.MoverSpeedControlled_y | fan | Fan | |
| Buildings.Controls.OBC.CDL.Conversions.BooleanToReal | sigSta | Start/stop signal | |
| Buildings.Controls.OBC.CDL.Reals.Multiply | sigCon | Resulting control signal | |
| Buildings.Controls.OBC.CDL.Reals.GreaterThreshold | evaSta | Evaluate fan status |
Revisions
-
July 17, 2026, by Antoine Gautier:
Refactored to use a compiler-friendly mover model. This is for #4653. -
November 18, 2022, by Antoine Gautier:
First implementation.