# Double-Acting Hydraulic Cylinder (Simple)

(To be removed) Basic functionality of double-acting hydraulic cylinder

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

## Library

Hydraulic Cylinders

## Description

The Double-Acting Hydraulic Cylinder (Simple) block represents a simplified version of a double-acting hydraulic cylinder, developed for applications where only the basic cylinder functionality must be reproduced, in exchange for better numerical efficiency. For these reasons, such factors as fluid compressibility, friction, and leakages are assumed to be negligible. The hard stops are assumed to be fully inelastic, to eliminate any possible oscillations at the end of the stroke. The model is especially suitable for real-time and HIL (hardware-in-the-loop) simulation, if such simplifications are acceptable.

The model is described with the following equations:

$$F={A}_{A}\cdot {p}_{A}-{A}_{B}\cdot {p}_{B}-{F}_{c}$$

$${q}_{A}={A}_{A}\cdot v$$

$${q}_{B}={A}_{B}\cdot v$$

$$\frac{dx}{dt}=v$$

$$v={v}_{R}-{v}_{C}$$

$${F}_{c}=\{\begin{array}{ll}\left(x-{x}_{E}\right)\cdot {K}_{p}\cdot v\hfill & \text{if}x{x}_{E},v0\hfill \\ \left(x-{x}_{R}\right)\cdot {K}_{p}\cdot v\hfill & \text{if}x{x}_{R},v0\hfill \\ 0\hfill & \text{otherwise}\hfill \end{array}$$

$${x}_{E}=S-{x}_{0}$$

$${x}_{R}=-{x}_{0}$$

where

F | Force developed by the cylinder |

v | Cylinder rod velocity |

v,_{R}v_{C} | Absolute velocities of cylinder rod and cylinder case, respectively |

A_{A} | Piston area at port A side |

A_{B} | Piston area at port B side |

p_{A} | Pressure at the cylinder port A |

p_{B} | Pressure at the cylinder port B |

q_{A} | Flow rate through port A into the cylinder |

q_{B} | Flow rate through port B from the cylinder |

x | Piston position |

x_{0} | Initial distance between piston and cap A |

F_{c} | Hard stop force |

x_{E} | Distance the piston can travel to fully extend from initial position |

x_{R} | Distance the piston can travel to fully retract from initial position |

K_{p} | Penetration coefficient |

S | Piston stroke |

The main difference between this block and the Double-Acting Hydraulic Cylinder block is the representation of the hard stop:

The Double-Acting Hydraulic Cylinder block utilizes the elastic model of the stop, which is essentially a combination of a spring and a damper, connected in parallel. The stiffness of the spring, which represents contact stiffness of colliding bodies, is very high, resulting in high-frequency, low-magnitude oscillations at the moment the bodies collide. These oscillations can hardly be noticed experimentally, but they are difficult to process by a numerical simulation and generally decrease numerical efficiency.

The hard stop in the Double-Acting Hydraulic Cylinder (Simple) block is represented with the inelastic model, which is essentially a viscous damper with the penetration-dependent damping coefficient. This coefficient is referred to as the penetration coefficient. With inelastic model, no oscillation is generated during an impact, resulting in improved numerical robustness and efficiency. But inelastic stop model has a feature that you must consider while selecting the model: colliding bodies continue slowly moving into each other as long as the contact is loaded with the compressing force. In real life, this phenomenon is similar to collision of two bodies separated by a sizable layer of viscous liquid. It takes some time to squeeze the liquid before bodies themselves come into contact.

Connections R and C are mechanical translational conserving ports corresponding to the cylinder rod and cylinder clamping structure, respectively. Connections A and B are hydraulic conserving ports. Port A is connected to chamber A and port B is connected to chamber B.

You can adjust the block directionality with the **Cylinder orientation**
parameter.

## Basic Assumptions and Limitations

Friction between moving parts is not taken into account.

Inertia effects are not taken into account.

Fluid compressibility is not taken into account.

Leakage flows are assumed to be negligible.

The hard stops are assumed to be fully inelastic, as explained above.

## Parameters

**Piston area A**Chamber A effective piston area. The default value is

`0.001`

m^2.**Piston area B**Chamber B effective piston area. The default value is

`5e-4`

m^2.**Piston stroke**Piston maximum travel between caps. The default value is

`0.1`

m.**Piston initial distance from cap A**The distance between the piston and cap A at the beginning of simulation. This value cannot exceed the piston stroke. The default value is

`0`

.**Penetration coefficient**Specifies the penetration property of colliding bodies. The higher the value of the coefficient, the less the bodies penetrate into each other, but the sharper the increase of the impact force. To find out the value of the coefficient for a particular application, it is recommended to run the same model with different hard stop models (or with different cylinder models) until they show close results. The default value of the coefficient is

`1e12`

N/m/(m/s).**Cylinder orientation**Specifies cylinder orientation with respect to the globally assigned positive direction. The cylinder can be installed in two different ways, depending upon whether it exerts force in the positive or in the negative direction when pressure is applied at its inlet. If pressure applied at port A exerts force in negative direction, set the parameter to

`Acts in negative direction`

. The default value is`Acts in positive direction`

.

## Ports

The block has the following ports:

`A`

Hydraulic conserving port associated with the cylinder chamber A.

`B`

Hydraulic conserving port associated with the cylinder chamber B.

`R`

Mechanical translational conserving port associated with the cylinder rod.

`C`

Mechanical translational conserving port associated with the cylinder clamping structure.

## Examples

The Closed-Loop Hydraulic Actuator Model for Real-Time Simulation example shows how to use this cylinder along with other blocks optimized for real-time and HIL simulation.

## Extended Capabilities

## Version History

**Introduced in R2010a**