# Variable-Displacement Pump

(To be removed) Variable-displacement bidirectional hydraulic pump

**The Hydraulics (Isothermal) library will be removed in a
future release. Use the Isothermal Liquid library instead. (since R2020a)**

**For more information on updating your models, see Upgrading Hydraulic Models to Use Isothermal Liquid Blocks.**

**Libraries:**

Simscape /
Fluids /
Hydraulics (Isothermal) /
Pumps and Motors

## Description

The Variable-Displacement Pump block represents a device that extracts power from a mechanical rotational network and delivers it to a hydraulic (isothermal liquid) network. The pump displacement varies in proportion to the physical signal specified at port C or D. The exact port used depends on the block variant selected. See Ports.

Ports **T** and **P** represent the pump inlets. Port
**S** represents the pump drive shaft. During normal operation, the pressure
gain from port **T** to port **P** is positive if the angular
velocity at port **S** is positive also. This operation mode is referred to here
as *forward pump*.

**Operation Modes**

A total of four operation modes are possible. The working mode depends on the pressure gain
from port **T** to port **P** (Δ*p*), the angular velocity at port **S** (*ω*),
and on the instantaneous displacement of the component (*D*). The Operation Modes figure maps the modes to the octants of a
Δ*p*-*ω*-*D* chart. The modes are labeled 1–4:

Mode

**1**: forward pump — A positive shaft angular velocity generates a positive pressure gain.Mode

**2**: reverse motor — A negative pressure drop (shown in the figure as a positive pressure gain) generates a negative shaft angular velocity.Mode

**3**: reverse pump — A negative shaft angular velocity generates a negative pressure gain.Mode

**4**: forward motor — A positive pressure drop (shown in the figure as a negative pressure gain) generates a positive shaft angular velocity.

The response time of the pump is considered negligible in comparison with the system response time. The pump is assumed to reach steady state nearly instantaneously and is treated as a quasi-steady component.

### Block Variants and Loss Parameterizations

The pump model accounts for power losses due to leakage and friction. Leakage is internal
and occurs between the pump inlet and outlet only. The block computes the leakage flow rate and
friction torque using your choice of five loss parameterizations. You select a parameterization
using block variants and, in the `Analytical or tabulated data`

case,
the ** Leakage and friction parameterization** parameter.

**Loss Parameterizations**

The block provides three Simscape™ variants to select from. To change the active block variant, use the
**Modeling option** parameter. The available variants are:

`Analytical or tabulated data`

— Obtain the mechanical and volumetric efficiencies or losses from analytical models based on nominal parameters or from tabulated data. Use the**Leakage and friction parameterization**parameter to select the exact input type.`Input efficiencies`

— Provide the mechanical and volumetric efficiencies directly through physical signal input ports.`Input losses`

— Provide the mechanical and volumetric losses directly through physical signal input ports. The mechanical loss is defined as the internal friction torque. The volumetric loss is defined as the internal leakage flow rate.

### Displacement Parameterizations

The displacement volume input depends on the block variant selected. If the active block
variant is `Input efficiencies`

or ```
Input
losses
```

, the block obtains the instantaneous displacement volume directly from the
physical signal input at port D.

If the active block variant is `Analytical or tabulated data`

, the
block computes the instantaneous displacement volume from the control member position specified
at port C. This computation depends on the **Displacement parameterization**
parameter setting:

`Maximum displacement and control member stroke`

— Compute the displacement volume per unit rotation as a linear function of the control member position specified at port C.`Displacement vs. control member position table`

— Compute the displacement volume per unit volume using interpolation or extrapolation of displacement tabular data specified at discrete control member positions.

### Flow Rate and Driving Torque

The volumetric flow rate generated at the pump is

$$q={q}_{\text{Ideal}}+{q}_{\text{Leak}},$$

where:

*q*is the net volumetric flow rate.*q*_{Ideal}is the ideal volumetric flow rate.*q*_{Leak}is the internal leakage volumetric flow rate.

The driving torque required to power the pump is

$$\tau ={\tau}_{\text{Ideal}}+{\tau}_{\text{Friction}},$$

where:

*τ*is the net driving torque.*τ*_{Ideal}is the ideal driving torque.*τ*_{Friction}is the friction torque.

**Ideal Flow Rate and Ideal Torque**

The ideal volumetric flow rate is

$${q}_{\text{Ideal}}={D}_{\text{Sat}}\xb7\omega ,$$

and the ideal driving torque is

$${\tau}_{\text{Ideal}}={D}_{\text{Sat}}\xb7\Delta p,$$

where:

*D*_{Sat}is a smoothed displacement computed so as to remove numerical discontinuities between negative and positive displacements.*ω*is the instantaneous angular velocity of the rotary shaft.*Δp*is the instantaneous pressure gain from inlet to outlet.

**Saturation Displacement**

The saturation displacement depends on the block variant selected. If the active variant
is `Analytical or tabulated data`

,

$${D}_{\text{Sat}}=\{\begin{array}{ll}\text{sign}(D)\xb7{D}_{\text{Max}},\hfill & \left|D\right|\ge {D}_{\text{Max}}\hfill \\ \sqrt{{D}^{2}+{D}_{\text{Threshold}}^{2}},\hfill & D\ge 0\hfill \\ -\sqrt{{D}^{2}+{D}_{\text{Threshold}}^{2}},\hfill & D<0\hfill \end{array},$$

where:

*D*is the instantaneous fluid displacement determined from the physical signal input specified at port**C**or port**D**.*D*_{Max}is the specified value of the**Maximum displacement**block parameter.*D*_{Threshold}is the specified value of the**Displacement threshold for pump-motor transition**block parameter.

If the active variant is `Input efficiencies`

or
`Input losses`

, there is no upper bound on the displacement input and
the saturation displacement reduces to:

$${D}_{Sat}=\{\begin{array}{ll}\sqrt{{D}^{2}+{D}_{Thresh}^{2}},\hfill & D\ge 0\hfill \\ -\sqrt{{D}^{2}+{D}_{Thresh}^{2}},\hfill & D<0\hfill \end{array}.$$

**Leakage Flow Rate and Friction Torque**

The internal leakage flow rate and friction torque calculations depend on the block
variant selected. If the block variant is ```
Analytical or tabulated
data
```

, the calculations depend also on the **Leakage and friction
parameterization** parameter setting. There are five possible permutations of block
variant and parameterization settings.

**Case 1: Analytical Efficiency Calculation**

If the active block variant is `Analytical or tabulated data`

and
the **Leakage and friction parameterization** parameter is set to
`Analytical`

, the leakage flow rate is

$${q}_{\text{Leak}}={K}_{\text{HP}}\Delta p,$$

and the friction torque is

$${\tau}_{\text{Friction}}=\left({\tau}_{0}+K{\text{}}_{\text{TP}}\left|\frac{{D}_{\text{Sat}}}{{D}_{\text{Max}}}\right|\left|\Delta p\right|\right)\mathrm{tanh}\left(\frac{4\omega}{{\omega}_{\text{Thresh}}}\right),$$

where:

*K*_{HP}is the Hagen-Poiseuille coefficient for laminar pipe flows. This coefficient is computed from the specified nominal parameters.*K*_{TP}is the specified value of the**Friction torque vs pressure gain coefficient**block parameter.*τ*_{0}is the specified value of the**No-load torque**block parameter.*ω*_{Threshold}is the threshold angular velocity for the motor-pump transition. The threshold angular velocity is an internally set fraction of the specified value of the**Nominal shaft angular velocity**block parameter.

The Hagen-Poiseuille coefficient is determined from nominal fluid and component parameters through the equation

$${K}_{\text{HP}}=\frac{{\nu}_{\text{Nom}}}{\rho v}\frac{\text{\hspace{0.17em}}{\rho}_{\text{Nom}}{\omega}_{\text{Nom}}{D}_{\text{Max}}}{\Delta {p}_{\text{Nom}}}\left(1-{\eta}_{\text{v,Nom}}\right),$$

where:

*ν*_{Nom}is the specified value of the**Nominal kinematic viscosity**block parameter. This is the kinematic viscosity at which the nominal volumetric efficiency is specified.*ρ*_{Nom}is the specified value of the**Nominal fluid density**block parameter. This is the density at which the nominal volumetric efficiency is specified.*ω*_{Nom}is the specified value of the**Nominal shaft angular velocity**block parameter. This is the angular velocity at which the nominal volumetric efficiency is specified.*ρ*is the actual fluid density in the attached hydraulic (isothermal liquid) network. This density can differ from the specified value of the**Nominal fluid density**block parameter.*v*is the kinematic viscosity of the fluid associated with the fluid network.*Δp*_{Nom}is the specified value of the**Nominal pressure gain**block parameter. This is the pressure drop at which the nominal volumetric efficiency is specified.*η*_{v,Nom}is the specified value of the**Volumetric efficiency at nominal conditions**block parameter. This is the volumetric efficiency corresponding to the specified nominal conditions.

**Case 2: Efficiency Tabulated Data**

If the active block variant is `Analytical or tabulated data`

and
the **Leakage and friction parameterization** parameter is set to
`Tabulated data — volumetric and mechanical efficiencies`

, the
leakage flow rate is

$${q}_{\text{Leak}}={q}_{\text{Leak,Pump}}\frac{\left(1+\alpha \right)}{2}+{q}_{\text{Leak,Motor}}\frac{\left(1-\alpha \right)}{2},$$

and the friction torque is

$${\tau}_{\text{Friction}}={\tau}_{\text{Friction,Pump}}\frac{1+\alpha}{2}+{\tau}_{\text{Friction,Motor}}\frac{1-\alpha}{2},$$

where:

*α*is a numerical smoothing parameter for the motor-pump transition.*q*_{Leak,Pump}is the leakage flow rate in pump mode.*q*_{Leak,Motor}is the leakage flow rate in motor mode.*τ*_{Friction,Pump}is the friction torque in pump mode.*τ*_{Friction,Motor}is the friction torque in motor mode.

The smoothing parameter *α* is given by the hyperbolic function

$$\alpha =\text{tanh}\left(\frac{4\Delta p}{\Delta {p}_{\text{Threshold}}}\right)\xb7\text{tanh}\left(\frac{4\omega}{{\omega}_{\text{Threshold}}}\right)\xb7\mathrm{tanh}\left(\frac{4D}{{D}_{\text{Threshold}}}\right),$$

where:

*Δp*_{Threshold}is the specified value of the**Pressure drop threshold for motor-pump transition**block parameter.*ω*_{Threshold}is the specified value of the**Angular velocity threshold for motor-pump transition**block parameter.*D*_{Threshold}is the specified value of the**Displacement threshold for motor-pump transition**block parameter.

The leakage flow rate is computed from efficiency tabulated data through the equation

$${q}_{\text{Leak,Pump}}=\left(1-{\eta}_{\text{v}}\right){q}_{\text{Ideal}},$$

in pump mode and through the equation

$${q}_{\text{Leak,Motor}}=-\left(1-{\eta}_{\text{v}}\right)q,$$

in motor mode, where:

*η*_{v}is the volumetric efficiency obtained through interpolation or extrapolation of the**Volumetric efficiency table, e_v(dp,w,D)**parameter data.

Similarly, the friction torque is computed from efficiency tabulated data through the equation

$${\tau}_{\text{Friction,Pump}}=\left(1-{\eta}_{\text{m}}\right)\tau ,$$

in pump mode and through the equation

$${\tau}_{\text{Friction,Motor}}=-\left(1-{\eta}_{\text{m}}\right){\tau}_{\text{Ideal}},$$

in motor mode, where:

*η*_{m}is the mechanical efficiency obtained through interpolation or extrapolation of the**Mechanical efficiency table, e_m(dp,w,D)**parameter data.

**Case 3: Loss Tabulated Data**

`Analytical or tabulated data`

and the **Leakage and friction parameterization**parameter is set to

`Tabulated data — volumetric and mechanical losses`

, the
leakage flow rate equation is
$${q}_{\text{Leak}}={q}_{\text{Leak}}\left(\Delta p,\omega ,{D}_{\text{Sat}}\right).$$

and the friction torque equation is

$${\tau}_{\text{Friction}}={\tau}_{\text{Friction}}\left(\Delta p,\omega ,{D}_{\text{Sat}}\right),$$

where *q*_{Leak}(*Δp*,*ω*,*D*_{Sat}) and *τ*_{Friction}(*Δp*,*ω*,*D*_{Sat}) are the volumetric and mechanical losses, obtained through interpolation or
extrapolation of the **Volumetric loss table, q_loss(dp,w,D)** and
**Mechanical loss table, torque_loss (dp,w,D)** parameter data.

**Case 4: Efficiency Physical Signal Inputs**

If the active block variant is `Input efficiencies`

, the leakage
flow rate and friction torque calculations are as described for efficiency tabulated data (case
2). The volumetric and mechanical efficiency lookup tables are replaced with physical signal
inputs that you specify through ports EV and EM.

**Case 5: Loss Physical Signal Inputs**

If the block variant is `Input losses`

, the leakage flow rate and
friction torque calculations are as described for loss tabulated data (case 3). The volumetric
and mechanical loss lookup tables are replaced with physical signal inputs that you specify
through ports LV and LM.

### Assumptions

Fluid compressibility is negligible.

Loading on the pump shaft due to inertia, friction, and spring forces is negligible.