Main Content

3-Way Directional Valve (MA)

3-way directional valve in a moist air network

Since R2025a

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).

Diagram of example valve configuration

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:

Diagram showing flow between ports A and T with port P closed off

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:

Diagram showing flow between ports A and T with port P closed off

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 Kv=0.865Cv, 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.

Plot of area versus spool position for each orifice.

Assumptions and Limitations

  • The Sonic conductance setting 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

expand all

Entry or exit point to the valve.

Entry or exit point to the valve.

Entry or exit point to the valve.

Input

expand all

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

expand all

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 (pinpout)/pin 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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-A, A-T, P-T.

Orifice area when the positive and negative spool positions include the same orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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 (pinpout)/pin where choking first occurs for the P-A orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient or Cv flow coefficient

  3. At least one of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-A or P-A, A-T, P-T.

    • Negative spool position open connections to P-A or P-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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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-A or P-A, A-T, P-T.

  • Negative spool position open connections to P-A or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. One of the following settings in each parameter:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. One of the following settings in each parameter:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-A, A-T, P-T.

Orifice area when the positive and negative spool positions include the same orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. One of the following settings in each parameter:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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 (pinpout)/pin where choking first occurs for the A-T orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient or Cv flow coefficient

  3. At least one of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to A-T or P-A, A-T, P-T.

    • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to A-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Cv flow coefficient

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Modeling option to Vapor operating condition

  2. Area characteristics to Different for each flow path

  3. Valve parameterization to Kv flow coefficient

  4. One of the following settings in each parameter:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Modeling option to Vapor operating condition

  2. Area characteristics to Different for each flow path

  3. Valve parameterization to Kv flow coefficient

  4. Opening characteristic to Tabulated

  5. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-A, A-T, P-T.

Orifice area when the positive and negative spool positions include the same orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Orifice area

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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 (pinpout)/pin where choking first occurs for the P-T orifice.

Dependencies

To enable this parameter, set:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Kv flow coefficient or Cv flow coefficient

  3. At least one of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. One of the following settings in each parameter:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Linear

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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:

  1. Area characteristics to Different for each flow path

  2. Valve parameterization to Sonic conductance

  3. Opening characteristic to Tabulated

  4. One of the following parameters:

    • Positive spool position open connections to P-T or P-A, A-T, P-T.

    • Negative spool position open connections to P-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-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-T or P-A, A-T, P-T.

  • Negative spool position open connections to P-T or P-A, A-T, P-T.

Extended Capabilities

expand all

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2025a