modelPartialDamper
Information
This is the base model for Damper_parallelBlades and Damper_opposedBlades strongly inspired from the PartialValve of Modelica Standard Library (MSL).
The model is based on the IEC 534 / ISA-75.01.01-2007 standard for valve sizing.
The model optionally supports reverse flow conditions (assuming symmetrical behaviour) or check valve operation, and has been suitably regularized, compared to the equations in the standard, in order to avoid numerical singularities around zero pressure drop operating conditions.
The model assumes adiabatic operation (no heat losses to the ambient); changes in kinetic energy from inlet to outlet are neglected in the energy balance.
Modelling options
The following options are available to specify the valve flow coefficient in fully open conditions:
CvData = Modelica.Fluid.Types.CvTypes.Av: The cross section surface area is given by the metricAcoefficient (m^2).CvData = Modelica.Fluid.Types.CvTypes.Kv: the flow coefficient is given by the metricKvcoefficient (m^3/h).CvData = Modelica.Fluid.Types.CvTypes.Cv: the flow coefficient is given by the USCvcoefficient (USG/min).CvData = Modelica.Fluid.Types.CvTypes.OpPoint: the flow is computed from the nominal operating point specified byp_nominal,dp_nominal,m_flow_nominal,rho_nominal,opening_nominal.
The nominal conditions (mainly pressure drop dp_nominal and mass flow rate m_flow_nominal) must always be specified;
- To avoid numerical singularities, the flow characteristic is modified for pressure drops less than
dp_small. The default value fordp_smallis 1% of the nominal pressure dropdp_nominal. Increasedp_smallif numerical problems occur in dampers with very low pressure drops - To be used a guess values. Moreover the homotopy operator used
dp_nominalandm_flow_nominalto compute the flow with the 'simplified' solution.
If checkValve is true, then the flow is stopped when the outlet pressure is higher than the inlet pressure; otherwise, reverse flow takes place.
Use this option only when needed, as it increases the numerical complexity of the problem.
The valve opening characteristic valveCharacteristic, linear by default, can be replaced by any user-defined function available in the ValveCharacteristics package.
Functions provides by the Modelica Standard Library (MSL) are compatible.
The characteristics for constant port_a.p and port_b.p pressures with continuously changing opening are shown in the next two figures:

The treatment of parameters Kv and Cv slightly differs from the explaination detailled in the User's Guide and derives more from the standard.

In the above equation, m_flow and p unit are respectively in m3/h and bar.



Where:
- m_flow is the mass flow rate in m3/h
-
Yis the expansion factor as defined in the standard -
xis the ratio of pressure differential to upstream absolute pressure (dp /p) -
Fγis the Specific heat ratio factor (γ/1.4) -
dis the upstream density -
N6is a constant depending of the chosen coefficient Kv or Cv
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Assumptions | |||
| Boolean | allowFlowReversal | true | = true to allow flow reversal, false restricts to design direction (port_a -> port_b) |
| Boolean | checkValve | false | Reverse flow stopped |
| Advanced | |||
| Medium.AbsolutePressure | dp_start | dp_nominal | Guess value of dp = port_a.p - port_b.p |
| Medium.MassFlowRate | m_flow_start | m_flow_nominal | Guess value of m_flow = port_a.m_flow |
| SI.Pressure | dp_small | 0.01*dp_nominal | Regularisation of zero flow |
| Medium.MassFlowRate | m_flow_small | 0.0 | Small mass flow rate for regularization of zero flow |
| Advanced › Diagnostics | |||
| Boolean | show_T | true | = true, if temperatures at port_a and port_b are computed |
| Boolean | show_V_flow | true | = true, if volume flow rate at inflowing port is computed |
| Flow Coefficient | |||
| Modelica.Fluid.Types.CvTypes | CvData | Modelica.Fluid.Types.CvTypes.OpPoint | Selection of flow coefficient |
| SI.Area | A | 0 | Damper cross section surface area |
| Real | Kv | 0 | Kv (metric) flow coefficient [m3/h] |
| Real | Cv | 0 | Cv (US) flow coefficient [USG/min] |
| Nominal operating point | |||
| SI.Pressure | dp_nominal | Nominal pressure drop | |
| Medium.MassFlowRate | m_flow_nominal | Nominal mass flow rate | |
| Medium.Density | rho_nominal | Medium.density_pTX(Medium.p_default, Medium.T_default, Medium.X_default) | Nominal inlet density |
| Real | opening_nominal | 1 | Nominal opening |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Fluid.Interfaces.FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) | |
| Modelica.Fluid.Interfaces.FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) | |
| Modelica.Blocks.Interfaces.RealInput | opening | Valve position in the range 0..1 |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Medium.MassFlowRate | m_flow | Mass flow rate in design flow direction | |
| Modelica.SIunits.Pressure | dp | Pressure difference between port_a and port_b (= port_a.p - port_b.p) | |
| Modelica.SIunits.VolumeFlowRate | V_flow | m_flow/Modelica.Fluid.Utilities.regStep(m_flow, Medium.density(state_a), Medium.density(state_b), m_flow_small) | Volume flow rate at inflowing port (positive when flow from port_a to port_b) |
| Medium.Temperature | port_a_T | Modelica.Fluid.Utilities.regStep(port_a.m_flow, Medium.temperature(state_a), Medium.temperature(Medium.setState_phX(port_a.p, port_a.h_outflow, port_a.Xi_outflow)), m_flow_small) | Temperature close to port_a, if show_T = true |
| Medium.Temperature | port_b_T | Modelica.Fluid.Utilities.regStep(port_b.m_flow, Medium.temperature(state_b), Medium.temperature(Medium.setState_phX(port_b.p, port_b.h_outflow, port_b.Xi_outflow)), m_flow_small) | Temperature close to port_b, if show_T = true |
Contents
| Name | Description |
|---|---|
| Medium in the component |