modelBasicControlValve
Extends from ThermofluidStream.Undirected.FlowControl.Internal.PartialValve (Partial valve model).
Information
Undirected implementation of the Basic Control Valve.
This model serves for most incompressible applications where basic control valves are needed.
The modeler has the ability to choose between different valve characteristics and flow coefficients.
The three standard curve characteristics (linear, parabolic, equal-percentage) are implemented and can be chosen.
To conclude the parameterization, a flow coefficient has to be set. Most data sheets of valves deliver a corresponding "KVs (CVs)"-Value. Otherwise a nominal mass-flow rate can be set.
For incompressible flow, the reference values for density (1g/cm3) and pressure (1bar) should be unchanged.
Reference values for standardized flow coefficients
When using Kvs, Cvs_US, or
Cvs_UK, the default values
dp_ref = 1 bar and
rho_ref = 1000 kg/m3 must not be modified.
Changing these reference values currently leads to incorrect model
behavior. The assertion level can be configured using
assertionLevel. To test this behavior, a test model has been setup in ValveReferenceValues_Undirected
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| String | instanceName (from DropOfCommonsPlus) | getInstanceName() | Instance name |
| Boolean | invertInput (from PartialValve) | false | = true, if input u_in is inverted |
| Real | k_min (from PartialValve) | 0.03 | Remaining flow at actuation signal u = 0 (fraction of maximum mass flow at u = 1) |
| Boolean | enable_dp_rho_ref (from PartialValve) | Enables/ hides showing dp_ref and rho_ref | |
| Layout | |||
| Boolean | displayInstanceName (from DropOfCommonsPlus) | dropOfCommons.displayInstanceNames | = true, if instance name is displayed |
| Boolean | displayParameters (from DropOfCommonsPlus) | dropOfCommons.displayParameters | = true, if displaying parameters is enabled |
| Advanced | |||
| Utilities.Units.Inertance | L (from SISOBiFlow) | dropOfCommons.L | Inertance |
| StateSelect | m_flowStateSelect (from SISOBiFlow) | StateSelect.default | State select for mass flow rate |
| Boolean | clip_p_out (from SISOBiFlow) | If true, set dr_corr to zero | |
| Medium.AbsolutePressure | p_min (from SISOBiFlow) | dropOfCommons.p_min | Minimal steady-state output pressure |
| AssertionLevel | assertionLevel | AssertionLevel.error | Assertion level for invalid reference values |
| Initialization | |||
| InitializationMethods | initM_flow (from SISOBiFlow) | ThermofluidStream.Utilities.Types.InitializationMethods.none | Initialization method for mass flow rate |
| SI.MassFlowRate | m_flow_0 (from SISOBiFlow) | 0 | Initial value for mass flow rate |
| Utilities.Units.MassFlowAcceleration | m_acceleration_0 (from SISOBiFlow) | 0 | Initial value for der(m_flow) |
| Advanced › Regularization | |||
| SI.MassFlowRate | m_flow_reg (from SISOBiFlow) | dropOfCommons.m_flow_reg | Regularization threshold of mass flow rate |
| Advanced › Reference values | |||
| SI.Pressure | dp_ref (from PartialValve) | 1e5 | Reference pressure difference |
| Medium.Density | rho_ref (from PartialValve) | 1000 | Reference density |
| Valve parameters | |||
| FlowCoeffType | flowCoefficient | FlowCoeffType.Kvs | Select type of flow coefficient |
| Real | Kvs | 0 | Kvs-value (metric) from data sheet (valve fully open) |
| Real | Cvs_US | 0 | Cvs-value (US [gal/min]) from data sheet (valve fully open) |
| Real | Cvs_UK | 0 | Cvs-value (UK [gal/min]) from data sheet (valve fully open, deprecated; use Kvs or Cvs_US instead) |
| SI.MassFlowRate | m_flow_ref_set | 0 | Reference mass flow rate |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Fore | fore (from SISOBiFlow) | ||
| Rear | rear (from SISOBiFlow) | ||
| Modelica.Blocks.Interfaces.RealInput | u_in (from PartialValve) | Valve control signal [] |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| SI.MassFlowRate | m_flow (from SISOBiFlow) | rear.m_flow | Mass flow rate |
| SI.Pressure | dp_fore (from SISOBiFlow) | ||
| SI.Pressure | dp_rear (from SISOBiFlow) | ||
| SI.Pressure | dr_corr_fore (from SISOBiFlow) | ||
| SI.Pressure | dr_corr_rear (from SISOBiFlow) | ||
| SI.Pressure | dr_corr (from SISOBiFlow) | ||
| Real | u (from PartialValve) | Actuation input for flow calculation |
Contents
| Name | Description |
|---|---|
 valveCharacteristics |