3-Way Directional Valve (MA)
Libraries:
Simscape /
Fluids /
Moist Air /
Valves & Orifices /
Directional Control Valves
Description
The 3-Way Directional Valve (MA) block models a valve with three openings in a moist air network, typically between an actuator, pump, and tank. The valve operation is controlled by a single spool displaced according to the signal at port S. You can set the baseline configuration of your valve by specifying the orifices that are open when the spool moves in the positive direction and negative directions in the Positive spool position open connections and Negative spool position open connections parameters, respectively. For more details about how the block calculates flow rate through a variable orifice, see Orifice (MA).

In this configuration, Positive spool position open connections
is set to A-T. When the signal at port S
moves the spool to a positive position, the path between ports A
and T is open to flow. The paths between ports
P and A and between ports
P and T are closed:

In this configuration, Negative spool position open connections
is set to P-A. When the signal at port S
moves the spool to a negative position, the path between ports P
and A is open to flow and the paths between ports
T and A and between ports
P and T are closed:

You can open the path between ports P and T
by setting either Positive spool position open connections or
Negative spool position open connections to
P-T or P-A, A-T, P-T.
A flow path can be open in either the positive or negative spool positions, but not both.
Valve Parameterizations
The block behavior depends on the Valve parametrization parameter:
Cv flow coefficient— The flow coefficient Cv determines the block parameterization. The flow coefficient measures the ease with which the moist air can flow when driven by a certain pressure differential.Kv flow coefficient— The flow coefficient Kv, where , determines the block parameterization. The flow coefficient measures the ease with which the moist air can flow when driven by a certain pressure differential.Sonic conductance— The sonic conductance of the resistive element at steady state determines the block parameterization. The sonic conductance measures the ease with which the moist air can flow when choked, which is a condition in which the flow velocity is at the local speed of sound. Choking occurs when the ratio between downstream and upstream pressures reaches a critical value known as the critical pressure ratio.Orifice area— The size of the flow restriction determines the block parametrization.
Visualize Orifice Openings
To visualize the spool offsets and displacement, right-click the block and select Fluids > Plot Valve Characteristics. The plot shows the sonic conductance, Kv flow coefficient, Cv flow coefficient, or orifice area as a function of spool position.
To update the data after changing the block parameters, click Reload Data in the figure window.
This figure shows the valve configuration with default values.

Assumptions and Limitations
The
Sonic conductancesetting of the Valve parameterization parameter is for pneumatic applications. If you use this setting for moist air with high levels of trace gases or are modeling a fluid other than air, you may need to scale the sonic conductance by the square root of the mixture specific gravity.This block does not model supersonic flow.
There is no heat exchange between the valve and the environment.
Ports
Conserving
Entry or exit point to the valve.
Entry or exit point to the valve.
Entry or exit point to the valve.
Input
Spool position displacement in m, received as a physical signal. For flow paths that open in the positive spool position, a positive signal opens the orifice. For flow paths that open in the negative spool position, a negative signal opens the orifice.
Parameters
Valve Configuration
Flow paths open when the spool is in a positive position. This parameter sets the valve configuration and defines the direction of spool movement according to the signal received at port S.
Flow paths open when the spool moves in the negative direction. This parameter sets the valve configuration and defines the direction of spool movement according to the signal received at port S.
Model Parameterization
Whether to apply uniform or individual flow equations for the valve orifice area. When
you set this parameter to Identical for all flow
paths, the block uses the same orifice and spool
geometries, flow rates, pressure, and area vectors for all valve
orifices. When you set this parameter to Different for each
flow path, you can specify these parameters
individually for each orifice. For both settings, orifices
A, B,
P, and T have the same
cross-sectional areas, discharge coefficients, and Reynolds numbers when
you set Valve parameterization to
Linear - Area vs. spool travel or
Tabulated data - Area vs. spool travel.
Method the block uses to calculate the mass flow rate from the pressure difference across the orifice or the pressure difference from the mass flow rate.
Maximum distance of spool travel.
Dependencies
To enable this parameter, set Area
characteristics to Identical for all
flow paths and Opening
characteristic to
Linear.
Method by which to convert the control signal specified at port S to the chosen measure of flow capacity.
Vector of spool travel distances when parameterizing the orifice according to the tabulated valve area data. The vector elements must correspond one-to-one with the elements in the Orifice area vector parameter. List the values in ascending order. The first element must be 0. The block uses linear interpolation between table data points.
Dependencies
To enable this parameter, set Area
characteristics to Identical for all
flow paths and Opening
characteristic to
Tabulated.
Value of the Cv flow coefficient when the orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to Cv
flow coefficient, and Opening
characteristic to
Linear.
Vector of Cv flow coefficients. Each coefficient corresponds to a value in the Control member position vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the Control member position vector parameter.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to Cv
flow coefficient, and Opening
characteristic to
Tabulated.
Value of the Kv flow coefficient when the orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to Kv
flow coefficient, and Opening
characteristic to
Linear.
Vector of Kv flow coefficients. Each coefficient corresponds to a value in the Control member position vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the Control member position vector parameter.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to Kv
flow coefficient, and Opening
characteristic to
Tabulated.
Largest open area of each orifice during the operation of the valve.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Orifice area, and Opening
characteristic to
Linear.
Vector of opening areas when parameterizing the orifice according to the tabulated valve area data. The vector elements must correspond one-to-one with the elements in the Spool travel vector parameter. List the values in ascending order. The elements must be greater than 0.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Orifice area, and Opening
characteristic to
Tabulated.
Ratio between the inlet pressure, pin, and the outlet pressure, pout, defined as where choking first occurs.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths, and
Valve parameterization to Cv
flow coefficient or Kv flow
coefficient.
Correction factor that accounts for discharge losses in theoretical flows.
Dependencies
To enable this parameter, set Valve parameterization to
Orifice area.
Value of the sonic conductance when the control signal specified at
port S is 1 and
cross-sectional area available for flow is at a maximum.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Sonic conductance, and
Opening characteristic to
Linear.
Pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Sonic conductance, and
Opening characteristic to
Linear.
Empirical value used to more accurately calculate the mass flow rate in the subsonic flow regime.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths and
Valve parameterization to
Sonic conductance.
Temperature at standard reference atmosphere, defined as 293.15 K in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths and
Valve parameterization to
Sonic conductance.
Density at standard reference atmosphere, defined as 1.185 kg/m3 in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths and
Valve parameterization to
Sonic conductance.
Vector of sonic conductances inside the resistive element. Each conductance corresponds to a value in the Spool travel vector parameter. The size of the vector must be the same as the Spool travel vector parameter.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Sonic conductance, and
Opening characteristic to
Tabulated.
Vector of critical pressure ratios at which the flow first chokes, with each critical pressure ratio corresponding to a value in the Spool travel vector parameter. The critical pressure ratio is the fraction of downstream-to-upstream pressures at which the flow velocity reaches the local speed of sound. The size of the vector must be the same as the Spool travel vector parameter.
Dependencies
To enable this parameter, set Area characteristics to
Identical for all flow paths,
Valve parameterization to
Sonic conductance, and
Opening characteristic to
Tabulated.
Ratio of the flow rate of the orifice when it is closed to when it is open.
Dependencies
To enable this parameter, set Opening
characteristic to
Linear.
Continuous smoothing factor that introduces a layer of gradual change based on the flow response when the valve is in the near-open and near-closed positions. To increase the stability of your simulation in these regimes, set this parameter to a nonzero value less than one.
Dependencies
To enable this parameter, set Opening
characteristic to
Linear.
Ratio of the orifice outlet pressure to orifice inlet pressure at which the fluid transitions between the laminar and turbulent regimes. The pressure loss corresponds to the mass flow rate linearly in laminar flows and quadratically in turbulent flows.
Maximum cross-sectional areas at the entry and exit ports P, T, A, and B, which the block uses in the pressure-flow rate equation that determines the mass flow rate through the valve.
P-A Orifice
Spool offset from the neutral position for a fully open P-A orifice.
Dependencies
To enable this parameter, set one of these parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings do not appear in both the Positive spool position open connections and Negative spool position open connections parameters.
Maximum distance of spool travel. This value provides an upper limit to calculations so that simulations do not return unphysical values.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to Linear,
and one of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Value of the constant Cv flow coefficient for the P-A orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Cv flow coefficient when the P-A orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of Cv flow coefficients. Each coefficient corresponds to a value in the P-A orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the P-A orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Value of the constant Kv flow coefficient for the P-A orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Kv flow coefficient when the P-A orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of Kv flow coefficients. Each coefficient corresponds to a value in the P-A orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the P-A orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of spool travel distances for the tabular parameterization of the valve area. List the values in ascending order. The first element must be 0. The block uses linear interpolation between table data points.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to
Tabulated, and one of the following
parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Largest open area of the P-A orifice during the operation of the valve.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of opening areas for the tabular parameterization of the valve area. The vector elements must correspond one-to-one with the elements in the P-A orifice spool travel vector parameter. The elements must be greater than 0 and listed in ascending order.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Orifice area when the positive and negative spool positions include the same orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOne of the following settings in each parameter:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Ratio between the inlet pressure, pin, and the outlet pressure, pout, defined as where choking first occurs for the P-A orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientorCv flow coefficientAt least one of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Sonic conductance when the positive and negative spool positions include the same orifice. This value is the ratio, measured at the onset of choking, of the mass flow rate through the resistive element to the product of the upstream pressure and mass density at standard conditions as defined in ISO 8778. This parameter determines the maximum flow rate allowed at a given upstream pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Critical pressure ratio when the positive and negative spool positions include the same orifice. This value is the pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-A orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the sonic conductance when the P-A orifice is fully open and the area available for flow is at a maximum.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of sonic conductances inside the resistive element. Each conductance corresponds to a value in the P-A orifice spool travel vector parameter. The size of the vector must be the same as the P-A orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Vector of critical pressure ratios at which the flow first chokes, with each critical pressure ratio corresponding to a value in the P-A orifice spool travel vector parameter. The critical pressure ratio is the fraction of downstream-to-upstream pressures at which the flow velocity reaches the local speed of sound. The size of the vector must be the same as the P-A orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Empirical value used to more accurately calculate the mass flow rate in the subsonic flow regime.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Temperature at standard reference atmosphere, defined as 293.15 K in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
Density at standard reference atmosphere, defined as 1.185 kg/m3 in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-AorP-A, A-T, P-T.Negative spool position open connections to
P-AorP-A, A-T, P-T.
A-T Orifice
Spool offset from the neutral position for a fully open A-T orifice.
Dependencies
To enable this parameter, set one of these parameters.
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings do not appear in both the Positive spool position open connections and Negative spool position open connections parameters.
Maximum distance of spool travel. This value provides an upper limit to calculations so that simulations do not return unphysical values.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to Linear,
and one of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Value of the constant Cv flow coefficient for the A-T orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Cv flow coefficient when the A-T orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of Cv flow coefficients. Each coefficient corresponds to a value in the A-T orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the A-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Value of the constant Kv flow coefficient for the A-T orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Kv flow coefficient when the A-T orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of Kv flow coefficients. Each coefficient corresponds to a value in the A-T orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the A-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of spool travel distances for the tabular parameterization of the valve area. List the values in ascending order. The first element must be 0. The block uses linear interpolation between table data points.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to
Tabulated, and one of the following
parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Largest open area of the A-T orifice during the operation of the valve.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of opening areas for the tabular parameterization of the valve area. The vector elements must correspond one-to-one with the elements in the A-T orifice spool travel vector parameter. The elements must be greater than 0 and listed in ascending order.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Orifice area when the positive and negative spool positions include the same orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOne of the following settings in each parameter:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Ratio between the inlet pressure, pin, and the outlet pressure, pout, defined as where choking first occurs for the A-T orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientorCv flow coefficientAt least one of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Sonic conductance when the positive and negative spool positions include the same orifice. This value is the ratio, measured at the onset of choking, of the mass flow rate through the resistive element to the product of the upstream pressure and mass density at standard conditions as defined in ISO 8778. This parameter determines the maximum flow rate allowed at a given upstream pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Critical pressure ratio when the positive and negative spool positions include the same orifice. This value is the pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the A-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the sonic conductance when the A-T orifice is fully open and the area available for flow is at a maximum.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of sonic conductances inside the resistive element. Each conductance corresponds to a value in the A-T orifice spool travel vector parameter. The size of the vector must be the same as the A-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Vector of critical pressure ratios at which the flow first chokes, with each critical pressure ratio corresponding to a value in the A-T orifice spool travel vector parameter. The critical pressure ratio is the fraction of downstream-to-upstream pressures at which the flow velocity reaches the local speed of sound. The size of the vector must be the same as the A-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Empirical value used to more accurately calculate the mass flow rate in the subsonic flow regime.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Temperature at standard reference atmosphere, defined as 293.15 K in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
Density at standard reference atmosphere, defined as 1.185 kg/m3 in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
A-TorP-A, A-T, P-T.Negative spool position open connections to
A-TorP-A, A-T, P-T.
P-T Orifice
Spool offset from the neutral position for a fully open P-T orifice.
Dependencies
To enable this parameter, set one of these parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings do not appear in both the Positive spool position open connections and Negative spool position open connections parameters.
Maximum distance of spool travel. This value provides an upper limit to calculations so that simulations do not return unphysical values.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to Linear,
and one of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Value of the constant Cv flow coefficient for the P-T orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Cv flow coefficient when the P-T orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of Cv flow coefficients. Each coefficient corresponds to a value in the P-T orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the P-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Cv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Value of the constant Kv flow coefficient for the P-T orifice. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Modeling option to
Vapor operating conditionArea characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOne of the following settings in each parameter:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the Kv flow coefficient when the P-T orifice is fully open and the area available for flow is at a maximum. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of Kv flow coefficients. Each coefficient corresponds to a value in the P-T orifice spool travel vector parameter. This parameter measures the ease with which the vapor traverses the resistive element when driven by a pressure differential. The size of the vector must be the same as the P-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Modeling option to
Vapor operating conditionArea characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of spool travel distances for the tabular parameterization of the valve area. List the values in ascending order. The first element must be 0. The block uses linear interpolation between table data points.
Dependencies
To enable this parameter, set Area
characteristics to Different for each
flow path, Opening
characteristic to
Tabulated, and one of the following
parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Largest open area of the P-T orifice during the operation of the valve.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of opening areas for the tabular parameterization of the valve area. The vector elements must correspond one-to-one with the elements in the P-T orifice spool travel vector parameter. The elements must be greater than 0 and listed in ascending order.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Orifice area when the positive and negative spool positions include the same orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Orifice areaOne of the following settings in each parameter:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Ratio between the inlet pressure, pin, and the outlet pressure, pout, defined as where choking first occurs for the P-T orifice.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Kv flow coefficientorCv flow coefficientAt least one of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Sonic conductance when the positive and negative spool positions include the same orifice. This value is the ratio, measured at the onset of choking, of the mass flow rate through the resistive element to the product of the upstream pressure and mass density at standard conditions as defined in ISO 8778. This parameter determines the maximum flow rate allowed at a given upstream pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Critical pressure ratio when the positive and negative spool positions include the same orifice. This value is the pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOne of the following settings in each parameter:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Note:
This parameter is enabled only when the P-T orifice settings appear in both spool position parameters: Positive spool position open connections and Negative spool position open connections.
Value of the sonic conductance when the P-T orifice is fully open and the area available for flow is at a maximum.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Pressure ratio at which flow first begins to choke and the flow velocity reaches its maximum, given by the local speed of sound. The pressure ratio is the outlet pressure divided by inlet pressure.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
LinearOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of sonic conductances inside the resistive element. Each conductance corresponds to a value in the P-T orifice spool travel vector parameter. The size of the vector must be the same as the P-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Vector of critical pressure ratios at which the flow first chokes, with each critical pressure ratio corresponding to a value in the P-T orifice spool travel vector parameter. The critical pressure ratio is the fraction of downstream-to-upstream pressures at which the flow velocity reaches the local speed of sound. The size of the vector must be the same as the P-T orifice spool travel vector parameter.
Dependencies
To enable this parameter, set:
Area characteristics to
Different for each flow pathValve parameterization to
Sonic conductanceOpening characteristic to
TabulatedOne of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Empirical value used to more accurately calculate the mass flow rate in the subsonic flow regime.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Temperature at standard reference atmosphere, defined as 293.15 K in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Density at standard reference atmosphere, defined as 1.185 kg/m3 in ISO 8778.
You only need to adjust the ISO reference parameter values if you are using sonic conductance values that are obtained at difference reference values.
Dependencies
To enable this parameter, set Area characteristics to
Different for each flow path,
Valve parameterization to
Sonic conductance, and at least one
of the following parameters:
Positive spool position open connections to
P-TorP-A, A-T, P-T.Negative spool position open connections to
P-TorP-A, A-T, P-T.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version History
Introduced in R2025a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
