Main Content

Single-Acting Actuator (IL)

Single-acting linear actuator in an isothermal liquid system

Since R2020a

  • Single-Acting Actuator (IL) block

Libraries:
Simscape / Fluids / Isothermal Liquid / Actuators

Description

The Single-Acting Actuator (IL) block represents an actuator that converts the liquid pressure at port A into a mechanical force at port R via an extending-retracting piston. The piston motion is limited by a hard stop model. When the piston position is calculated internally, it is reported at port p, and when the position is set by a connection to a Simscape™ Multibody™ joint, it is received as a physical signal at port p.

The Initial piston displacement, Fluid dynamic compressibility, and reference environmental pressure can be modified. Fluid and mechanical inertia are not modeled.

Displacement

The piston displacement is measured as the position at port R relative to port C. The Mechanical orientation identifies the direction of piston displacement. The piston displacement is neutral, or 0, when the chamber volume is equal to the Dead volume. When displacement is received as an input, ensure that the derivative of the position is equal to the piston velocity. This is automatically the case when the input is received from a Translational Multibody Interface block connection to a Simscape Multibody joint.

Hard Stop Model

Four models are available to model the extension limit of the actuator piston. This block uses a similar formulation as the Translational Hard Stop block and models uniform damping and stiffness coefficients at both ends of the piston stroke. For more information on the hard stop model options, see the Translational Hard Stop block.

The hard stop force is modeled when the piston is at its upper or lower bound. The boundary region is within the Transition region of the Piston stroke or Piston initial displacement. Outside of this region, FHardStop=0.

Cushion

The block can model cushioning toward the extremes of the piston stroke. Select Cylinder end cushioning to slow the piston motion as it approaches the maximum extension, defined by the Piston stroke parameter. For more information on the functionality of a cylinder cushion, see the Cylinder Cushion (IL) block.

Friction

The block can model friction against piston motion. When you select Cylinder friction, the resulting friction is a combination of the Stribeck, Coulomb, and viscous effects. The block measures the pressure difference between the chamber pressure and the environment pressure. For more information on the friction model and its limitations, see the Cylinder Friction (IL) block.

Leakage

You can optionally model leakage between the liquid chamber and the piston reservoir. When you select Leakage, Poiseuille flow is modeled between the piston and cylinder. This block uses the Simscape Foundation Library Laminar Leakage (IL) block. The flow rate is calculated as:

m˙=π128(d04di4(d02di2)2log(d0/di))υL(pApenv),

where:

  • ν is the fluid kinematic viscosity.

  • L is the piston length, pP0.

  • pA is the pressure at port A.

  • penv is the environmental pressure, which is selected in the Environment pressure specification parameter.

The cylinder diameter, d0, is d0=di+2c, where c is the Piston-cylinder clearance, and the piston diameter, di, is di=4APπ, where AP is the Piston cross-sectional area.

Numerically-Smoothed Area and Pressure

You can maintain numerical robustness in your simulation by adjusting the Smoothing factor parameter. If the Smoothing factor parameter is nonzero, the block smooths the cushion orifice area and the check valve pressure range. The orifice area is smoothly saturated between the Leakage area between plunger and cushion sleeve and Cushion plunger cross-sectional area parameters while the valve pressure is saturated between the Check valve cracking pressure differential and Check valve maximum pressure differential parameters. For more information, see Numerical Smoothing.

Block Sub-Components

The Single-Acting Actuator (IL) block comprises four Simscape Foundation and two Fluids Library blocks:

Actuator Structural Diagram

Examples

Ports

Input

expand all

Physical signal input port associated with the piston position, in m. Connect this port to a Simscape Multibody block.

Dependencies

To enable this port, set Piston displacement to Provide input signal from Multibody joint.

Output

expand all

Piston position in m, returned as a physical signal.

Dependencies

To expose this port, set Piston displacement to Calculate from velocity of port R relative to port C.

Conserving

expand all

Thermal liquid conserving port associated with chamber A.

Translational mechanical conserving port associated with the actuator casing.

Translational mechanical conserving port associated with the actuator piston.

Parameters

expand all

Actuator

Sets the piston displacement direction. When you set this parameter to:

  • Pressure at A causes positive displacement of R relative to C the piston displacement is positive when the volume of liquid at port A is expanding. This corresponds to rod extension.

  • Pressure at A causes negative displacement of R relative to C the piston displacement is negative when the volume of liquid at port A is expanding. This corresponds to rod contraction.

Cross-sectional area of the piston rod.

Maximum piston travel distance.

Volume of liquid when the piston displacement is 0. This is the liquid volume when the piston is up against the actuator end cap.

Environment reference pressure. The Atmospheric pressure option sets the environmental pressure to 0.101325 MPa.

User-defined environmental pressure.

Dependencies

To enable this parameter, set Environment pressure specification to Specified pressure.

Hard Stop

Model choice for the force on the piston at full extension or full retraction. See the Translational Hard Stop block for more information.

Piston stiffness coefficient.

Dependencies

To enable this parameter, set Hard stop model to

  • Stiffness and damping applied smoothly through transition region, damped rebound

  • Full stiffness and damping applied at bounds, undamped rebound

  • Full stiffness and damping applied at bounds, damped rebound

Piston damping coefficient.

Dependencies

To enable this parameter, set Hard stop model to

  • Stiffness and damping applied smoothly through transition region, damped rebound

  • Full stiffness and damping applied at bounds, undamped rebound

  • Full stiffness and damping applied at bounds, damped rebound

Application range of the hard stop force model. Outside of this range of the piston maximum extension and piston maximum retraction, the Hard stop model is not applied and there is no additional force on the piston.

Dependencies

To enable this parameter, set Hard stop model to Stiffness and damping applied smoothly through transition region, damped rebound.

Ratio of the final to the initial relative speed between the slider and the stop after the slider bounces.

Dependencies

To enable this parameter, set Hard stop model to Based on coefficient of restitution.

Threshold relative speed between slider and stop before collision. When the slider hits the case with speed less than the value of the Static contact speed threshold parameter, they stay in contact. Otherwise, the slider bounces. To avoid modeling static contact between the slider and the case, set this parameter to 0.

Dependencies

To enable this parameter, set Hard stop model to Based on coefficient of restitution.

Minimum force needed to release the slider from a static contact mode.

Dependencies

To enable this parameter, set Hard stop model to Based on coefficient of restitution.

Cushion

Whether to model piston slow-down at the maximum extension. See the Cylinder Cushion (IL) block for more information.

Area of the plunger inside the actuator cushion element.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Length of the cushion plunger.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Area of the orifice between the cushion chambers.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Gap area between the cushion plunger and sleeve. This value contributes to numerical stability by maintaining continuity in the flow.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Pressure beyond which the valve operation triggers. When the pressure difference between port A and Penv meets or exceeds the value of this parameter, the cushion valve begins to open.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Maximum cushion valve differential pressure. This parameter provides an upper limit to the pressure so that system pressures remain realistic.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Cross-sectional area of the cushion valve in the fully open position.

Dependencies

To enable this parameter, select Cylinder end cushioning.

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

Dependencies

To enable this parameter, select Cylinder end cushioning.

Continuous smoothing factor that introduces a layer of gradual change to the flow response when the variable orifice and check valve are 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.

Dependencies

To enable this parameter, select Cylinder end cushioning.

Friction

Whether to model friction against piston motion. The block accounts for Coulomb, Stribeck, and viscous friction. See the Cylinder Friction block for more information.

Ratio of the breakaway force to the Coulomb friction force.

Dependencies

To enable this parameter, select Cylinder friction.

Threshold velocity for the motion against the friction force to begin.

Dependencies

To enable this parameter, select Cylinder friction.

Initial force in the cylinder due to the seal assembly.

Dependencies

To enable this parameter, select Cylinder friction.

Coulomb force coefficient of friction.

Dependencies

To enable this parameter, select Cylinder friction.

Viscous friction coefficient.

Dependencies

To enable this parameter, select Cylinder friction.

Leakage

Whether to model annular leakage between the fluid chamber and the piston reservoir at reference environment conditions. The leakage is considered laminar. See the Laminar Leakage (IL) block for more information.

Radial distance between the piston rod and cylinder casing.

Dependencies

To enable this parameter, select Leakage.

Length of the piston head.

Dependencies

To enable this parameter, select Leakage.

Initial conditions

Method for determining the piston position. The block can receive the position from a Multibody block when set to Provide input signal from Multibody joint, or calculates the position internally and reports the position at port p. The position is between 0 and the Piston stroke when the mechanical orientation is positive and 0 and –Piston stroke when the mechanical orientation is negative.

Piston position at the start of the simulation.

Dependencies

To enable this parameter, set Piston displacement to Calculate from velocity of port R relative to port C.

Whether to model any change in fluid density due to fluid compressibility. When you select Fluid dynamic compressibility, changes due to the mass flow rate into the block are calculated in addition to density changes due to changes in pressure. In the Isothermal Liquid Library, all blocks calculate density as a function of pressure.

Starting liquid pressure for compressible fluids.

Dependencies

To enable this parameter, select Fluid dynamic compressibility.

Extended Capabilities

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

Version History

Introduced in R2020a

expand all