# Orifice (IL)

Constant-area or variable-area orifice in an isothermal system

• Library:
• Simscape / Fluids / Isothermal Liquid / Valves & Orifices / Orifices

## Description

The Orifice (IL) block models the flow through a local restriction with a constant or variable opening area. For variable orifices, a control member connected to port S sets the opening position. The opening area is parametrized either linearly or by lookup table.

For orifices that open and close based on the displacement of a central spool, see Spool Orifice (IL).

You can enable fault modeling behavior by setting Enable faults to `On`.

The block conserves mass such that

`${\stackrel{˙}{m}}_{A}+{\stackrel{˙}{m}}_{B}=\rho {v}_{A}{A}_{A}+\rho {v}_{B}{A}_{B}=0.$`

This mass balance implies that there is an increase in velocity when there is a decrease in area, and a reduction in velocity when the flow discharges into a larger area. In accordance with the Bernoulli principle, this change in velocity results in a region of lower pressure in the orifice and a higher pressure in the expansion zone. The resulting increase in pressure, which is called pressure recovery, depends on the discharge coefficient of the orifice and the ratio of the orifice and port areas.

### Constant Orifices

For constant orifices, the orifice area, Aorifice, does not change over the course of the simulation.

Using the `Constant` Area Parameterization

The block calculates the mass flow rate as

`$\stackrel{˙}{m}=\frac{{C}_{d}{A}_{orifice}\sqrt{2\overline{\rho }}}{\sqrt{P{R}_{loss}\left(1-{\left(\frac{{A}_{orifice}}{{A}_{port}}\right)}^{2}\right)}}\sqrt{{p}_{A}-{p}_{B}}\approx \frac{{C}_{d}{A}_{orifice}\sqrt{2\overline{\rho }}}{\sqrt{P{R}_{loss}\left(1-{\left(\frac{{A}_{orifice}}{{A}_{port}}\right)}^{2}\right)}}\frac{{p}_{A}-{p}_{B}}{{\left[{\left({p}_{A}-{p}_{B}\right)}^{2}+\Delta {p}_{crit}\right]}^{1/4}},$`

where:

• Cd is the Discharge coefficient.

• Aorifice is the instantaneous orifice open area.

• Aport is the Cross-sectional area at ports A and B.

• $\overline{\rho }$ is the average fluid density.

PRloss and Δpcrit are calculated in the same manner for constant and variable orifices and are defined in the Pressure Loss and Critical Pressure sections below.

This approximation for $\stackrel{˙}{m}$ and the Local Restriction (IL) block are the same.

Using the ```Tabulated data - Volumetric flow rate vs. pressure drop``` Parameterization

The volumetric flow rate is determined from the tabular values of the pressure differential, Δp, which you can provide. If only non-negative values are provided for both the volumetric flow rate and pressure drop vectors, the table will be extrapolated to contain negative values. The volumetric flow rate is interpolated from this extended table.

### Variable Orifices

For variable orifices, setting Opening orientation to `Positive control member displacement opens orifice` opens the orifice when the signal at S is positive, while a `Negative control member displacement opens orifice` orientation opens the orifice when the signal at S is negative. In both cases, the signal is positive and the orifice opening is set by the magnitude of the signal.

Using the `Linear - Area vs. control member position` Parameterization

The orifice area Aorifice is based on the control member position and the ratio of orifice area and maximum control member position:

`${A}_{orifice}=\frac{\left({A}_{\mathrm{max}}-{A}_{leak}\right)}{\Delta S}\left(S-{S}_{\mathrm{min}}\right)\epsilon +{A}_{leak},$`

where:

• Smin is the control member position when the orifice is fully closed.

• ΔS is the Control member travel between closed and open orifice.

• Amax is the Maximum orifice area.

• Aleak is the Leakage area.

• ε is the Opening orientation.

When the valve is in a near-open or near-closed position in the linear parameterization, you can maintain numerical robustness in your simulation by adjusting the parameter. If the parameter is nonzero, the block smoothly saturates the orifice area between Aleak and Amax. For more information, see Numerical Smoothing.

The volumetric flow rate is determined by the pressure-flow rate equation:

`$\stackrel{˙}{m}=\frac{{C}_{d}{A}_{orifice}\sqrt{2\overline{\rho }}}{\sqrt{P{R}_{loss}\left(1-{\left(\frac{{A}_{orifice}}{A}\right)}^{2}\right)}}\frac{\Delta p}{{\left[\Delta {p}^{2}+\Delta {p}_{crit}^{2}\right]}^{1/4}},$`

where A is the Cross-sectional area at ports A and B.

Using the `Tabulated data - Area vs. control member position` Parameterization

When you use the ```Tabulated data - Area vs. control member position``` parameterization, the orifice area Aorifice is interpolated from the tabular values of opening area and the control member position, ΔS, which you can provide. As with the `Linear - Area vs. control member position` parameterization, the volumetric flow rate is determined by the pressure-flow rate equation:

`$\stackrel{˙}{m}=\frac{{C}_{d}{A}_{orifice}\sqrt{2\overline{\rho }}}{\sqrt{P{R}_{loss}\left(1-{\left(\frac{{A}_{orifice}}{A}\right)}^{2}\right)}}\frac{\Delta p}{{\left[\Delta {p}^{2}+\Delta {p}_{crit}^{2}\right]}^{1/4}},$`

where Aorifice is:

• Amax, the last element of the Orifice area vector, if the opening is larger than the maximum specified opening.

• Aleak, the first element of the Orifice area vector, if the orifice opening is less than the minimum opening.

• Aorifice if the calculated area is between the limits of the Orifice area vector.

Aopen is a function of the control member position received at port S. The block queries between data points with linear interpolation and uses nearest extrapolation for points beyond the table boundaries.

Using the ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop``` Parameterization

The ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop``` parameterization interpolates the volumetric flow rate directly from a user-provided volumetric flow rate table, which is based on the control member position and pressure drop over the orifice. The block queries between data points with linear interpolation and uses linear extrapolation for points beyond the table boundaries.

This data can include negative pressure drops and negative opening values. If a negative pressure drop is included in the dataset, the volumetric flow rate will change direction. However, the flow rate will remain unchanged for negative opening values.

### Pressure Loss

Pressure loss describes the reduction of pressure in the valve due to a decrease in area. The pressure loss term, PRloss is calculated as:

`$P{R}_{loss}=\frac{\sqrt{1-{\left(\frac{{A}_{orifice}}{{A}_{port}}\right)}^{2}\left(1-{C}_{d}^{2}\right)}-{C}_{d}\frac{{A}_{orifice}}{{A}_{port}}}{\sqrt{1-{\left(\frac{{A}_{orifice}}{{A}_{port}}\right)}^{2}\left(1-{C}_{d}^{2}\right)}+{C}_{d}\frac{{A}_{orifice}}{{A}_{port}}}.$`

Pressure recovery describes the positive pressure change in the valve due to an increase in area. If you do not wish to capture this increase in pressure, set Pressure recovery to `Off`. In this case, PRloss is 1.

### Critical Pressure

The critical pressure difference, Δpcrit, is the pressure differential associated with the Critical Reynolds number, Recrit, which is the point of transition between laminar and turbulent flow in the fluid:

`$\Delta {p}_{crit}=\frac{\pi \overline{\rho }}{8{A}_{orifice}}{\left(\frac{\nu {\mathrm{Re}}_{crit}}{{C}_{d}}\right)}^{2}.$`

### Faults

When Orifice type is set to `Variable` and faults are enabled, the orifice open area becomes stuck at a specified value in response to one or both of these triggers:

• Simulation time — Faulting occurs at a specified time.

• Simulation behavior — Faulting occurs in response to an external trigger. This exposes port T.

Three fault options are available in the Opening area when faulted parameter:

• `Closed` — The orifice freezes at its smallest value, depending on the Orifice parameterization:

• When Orifice parameterization is set to ```Linear - Area vs. control member position```, the orifice freezes at the Leakage area.

• When Orifice parameterization is set to ```Tabulated data - Area vs. control member position```, the orifice freezes at the first element of the Orifice area vector.

• When Orifice parameterization is set to ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```, the orifice freezes at the first row of the Volumetric flow rate table, q(s,dp).

• `Open` — The orifice freezes at its largest value, depending on the Orifice parameterization:

• When Orifice parameterization is set to ```Linear - Area vs. control member position```, the orifice freezes at the Maximum orifice area.

• When Orifice parameterization is set to ```Tabulated data - Area vs. control member position```, the orifice freezes at the last element of the Orifice area vector.

• When Orifice parameterization is set to ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```, the orifice freezes at the last row of the Volumetric flow rate table, q(s,dp).

• `Maintain at last value` — The orifice seizes at the open area or volumetric flow rate when the trigger occurs.

Due to numerical smoothing at the extremes of the orifice area, the minimum area applied is larger than the parameter value, and the maximum is smaller than the parameter value, in proportion to the Smoothing factor value.

Once triggered, the orifice remains at the faulted area for the rest of the simulation.

You can set the block to issue a fault report as a warning or error message in the Simulink Diagnostic Viewer with the Reporting when fault occurs parameter.

## Ports

### Conserving

expand all

Liquid entry or exit point to the orifice.

Liquid entry or exit point to the orifice.

### Input

expand all

Control member displacement that sets orifice opening.

Physical signal port for an external fault trigger. Triggering occurs when the value is greater than 0.5. There is no unit associated with the trigger value.

#### Dependencies

This port is visible when Enable faults is set to `On` and Enable external fault trigger is set to `On`.

## Parameters

expand all

### Parameters

Type of orifice, defined by the orifice area. When set to `Variable`, the orifice area varies according to the input signal received at port S.

Method of calculating orifice area over simulation. When Orifice type is set to `Constant`, there are two parameterization options.

• `Orifice area` (default). The assigned area does not change over the simulation.

• ```Tabulated data - Volumetric flow rate vs. pressure drop```. The area remains constant, but the volumetric flow rate through the orifice can vary. This value is interpolated directly from the Volumetric flow rate vector and the Pressure drop vector dataset.

When the Orifice type is set to `Variable`, there are three parameterization options.

• ```Linear - Area vs. control member position```. Area is determined by a linear relationship to the control member position with respect to a fully open or fully closed orifice. The position is set by a varying physical signal at port S.

• ```Tabulated data - Area vs. control member position```. The opening area is interpolated from the Control member position vector and the Orifice area vector based on the control member position received at port S.

• ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```. The volumetric flow rate is directly interpolated from the user- provided Control member position vector, s, Pressure drop vector, dp, and Volumetric flow rate table, q(s,dp) parameters based on the control member position received at port S and the pressure drop across ports A and B.

Cross-sectional area of the orifice opening.

#### Dependencies

To enable this parameter, set Orifice type to `Constant` and Orifice parameterization to ```Orifice area```.

Vector of pressure differential values for the tabular parameterization of volumetric flow rate. The values in this vector correspond one-to-one to values in the Volumetric flow rate vector parameter. The pressure drop vector values are listed in ascending order. The volumetric flow rate is interpolated directly from the Volumetric flow rate vector, which depends on the Pressure drop vector parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Constant` and Orifice parameterization to ```Tabulated data - Volumetric flow rate vs. pressure drop```.

Vector of volumetric flow rate values for the tabular parameterization of volumetric flow rate. The values in this vector correspond one-to-one to values in the Pressure drop vector. The volumetric flow rate is interpolated directly from the provided Volumetric flow rate vector, which depends on the Pressure drop vector parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Constant` and Orifice parameterization to ```Tabulated data - Volumetric flow rate vs. pressure drop```.

Initial control member offset when the variable orifice is fully closed.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`.

Maximum distance the control member travels between closed and open orifice. The orifice is fully open at the sum of the Control member position at closed orifice and Control member travel between closed and open orifice,

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Linear - Area vs. control member position```.

Maximum orifice area experienced during simulation. When using ```Tabulated data - Area vs. control member position```, the maximum orifice area is the last element of the Orifice area vector.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Linear - Area vs. control member position```.

Sum of all gaps when the valve is in fully closed position. Any area smaller than this value is maintained at the specified leakage area. This parameter contributes to numerical stability by maintaining continuity in the flow.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Linear - Area vs. control member position```.

.

Vector of control member positions for the tabular parameterization of orifice area. The vector elements correspond one-to-one to the values in the Orifice area vector. The vector elements are listed in ascending order and the first element must be 0. The orifice opening area is interpolated from the Orifice area vector, which depends on the Control member position vector parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Tabulated data - Area vs. control member position```.

Vector of orifice area values for the tabular parameterization of orifice area. The values in this vector correspond one-to-one with the elements in the Control member position vector. The first element of this vector is the orifice leakage area and the last element is the maximum orifice area. The orifice opening area is interpolated from the Orifice area vector, which depends on the Control member position vector.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Tabulated data - Area vs. control member position```.

Cross-sectional area at the entry and exit ports A and B. This area is used in the pressure-flow rate equation that determines the mass flow rate through the orifice.

#### Dependencies

To enable this parameter, set either:

• Orifice type to `Variable` and Orifice parameterization to either ```Linear - Area vs. control member position``` or ```Tabulated data - Area vs. control member position```.

• Orifice type to `Constant` and Orifice parameterization to `Orifice area`.

Direction of member displacement that opens a variable orifice. A positive orientation means that a positive signal at S opens the orifice. A negative orientation means that a negative signal at S opens the orifice.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`.

Correction factor that accounts for discharge losses in theoretical flows.

#### Dependencies

To enable this parameter, set either:

• Orifice type to `Variable` and Orifice parameterization to either ```Linear - Area vs. control member position``` or ```Tabulated data - Area vs. control member position```.

• Orifice type to `Constant` and Orifice parameterization to `Orifice area`.

Upper Reynolds number limit for laminar flow through the orifice.

#### Dependencies

To enable this parameter, set either:

• Orifice type to `Variable` and Orifice parameterization to either ```Linear - Area vs. control member position``` or ```Tabulated data - Area vs. control member position```.

• Orifice type to `Constant` and Orifice parameterization to `Orifice area`.

Continuous smoothing factor that introduces a layer of gradual change to the flow response when the orifice is in near-open or near-closed positions. Set this value to a nonzero value less than one to increase the stability of your simulation in these regimes.

Whether to account for pressure increase when fluid flows from a region of smaller cross-sectional area to a region of larger cross-sectional area. This increase in pressure is not captured when Pressure recovery is set on `Off`.

#### Dependencies

To enable this parameter, set either:

• Orifice type to `Variable` and Orifice parameterization to either ```Linear - Area vs. control member position``` or ```Tabulated data - Area vs. control member position```.

• Orifice type to `Constant` and Orifice parameterization to `Orifice area`.

Vector of control member positions for tabular parametrization of volumetric flow rate. The control member position vector forms an independent axis with the Pressure drop vector, dp parameter for the 2-D dependent Volumetric flow rate table, q(s,dp) parameter. A positive displacement corresponds to valve opening. The values are listed in ascending order and the first element must be 0. Linear interpolation is employed between table data points.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```.

Vector of pressure drop values for tabular parametrization of volumetric flow rate. The pressure drop vector forms an independent axis with the Control member position vector, s parameter for the 2-D dependent Volumetric flow rate table, q(s,dp) parameter. The values are listed in ascending order and must be greater than 0. Linear interpolation is employed between table data points.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```.

M-by-N matrix of volumetric flow rates based on independent values of pressure drop and control member position. M and N are the sizes of the corresponding vectors:

• M is the number of elements in the Pressure drop vector, dp parameter.

• N is the number of elements in the parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Variable` and Orifice parameterization to ```Tabulated data - Volumetric flow rate vs. control member position and pressure drop```.

### Faults

Enable externally or temporally triggered faults. When faulting occurs, the valve area normally set by the opening parameterization will be set to the value specified in the Opening area when faulted parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`.

Sets the faulted orifice area. You can choose for the orifice to seize at the fully closed or fully open position, or at the valve area when faulting is triggered.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`Enable faults to `On`.

Enables port T. A physical signal at port T that is greater than `0.5` triggers faulting.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`Enable faults to `On`.

Enables fault triggering at a specified time. When the Simulation time for fault event is reached, the orifice area will be set to the value specified in the Opening area when faulted parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`Enable faults to `On`.

When the Simulation time for fault event is reached, the orifice area is set to the value specified in the Opening area when faulted parameter.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`, Enable faults to `On`, and Enable temporal fault trigger to `On`.

Reporting preference for the fault condition. When reporting is set to `Warning` or `Error`, a message is displayed in the Simulink Diagnostic Viewer. When `Error` is selected, the simulation will stop if faulting occurs.

#### Dependencies

To enable this parameter, set Orifice type to `Variable`Enable faults to `On`.

## Version History

Introduced in R2020a