Cylinder
Library
HydraulicsByFluidon/Components/Cylinders
Description
Model of a differential cylinder with Stribeck friction and volumetric losses.
The fundamental geometrical properties of the differential cylinder are the piston and rod diameters (pistonDiameter and rodDiameter) as well as the lengths of the cylinder and the rod (cylinderLength and rodLength). By using the parameter angle, the inclination of the cylinder with respect to the horizon can be adjusted. The resulting forces due to gravity are taken into account automatically, however without inclusion of static fluid masses.
For dynamic calculations, the masses of the piston and the cylinder are required. These can be provided by specifying the parameters massPiston and massCylinder. The dynamic mass of the fluid, which acts as an additional inertia, is automatically taken into account by the model.
The parameters fBreakaway, fCoulomb, fProp and vM (velocity parameter of Stribeck friction at which the friction force begins to grow linearly) characterize the velocity dependence of the friction force between piston and cylinder. Instead of using the Stribeck friction model, a simplified friction calculation can be enabled by setting the check mark relFric. In this case, the friction force equals the net force acting on the interface between piston and cylinder multiplied by the parameter relFricFactor. Regardless of which friction model is used, the friction force is not influenced by the inclination of the cylinder or the system pressure. The parameter vSmall is used by the internal state machine of the cylinder model and determines the velocity below which the piston is considered stuck.

The pressure in both cylinder chambers can be initialized by assigning start values to pA (bore side) and pB (rod side). The parameter deadVolume determines the size of the parasitic volume which remains even if the piston has reached the mechanical stops at the cylinder ends.
Cylinder ends are modeled as bumstops whose stiffness, damping and stiffness exponent can be tuned in the appropriate Bumpstops parameter tab. Alternatively, the stroke limits can be enforced by means of hard constraints (through useHardBumpstops) thus strictly impeding the cylinder to overextend.
The volumetric losses due to internal and external leakage are parameterized by providing the respective flow rates (Internal leakage: volume flow and External leakage: volume flow), associated pressure drops (Internal leakage: pressure difference and External leakage: pressure difference) and the fluid density Reference density for volume flow and pressure difference for which these values were obtained.
The fluid properties can be propagated between the two hydraulic ports by setting the parameter forwardFluidProperties to "true".
Parameters
Name | Label | Description | Data Type | Valid Values |
---|---|---|---|---|
mo_pistonDiameter | pistonDiameter | Piston diameter | Scalar | |
mo_rodDiameter | rodDiameter | Rod diameter | Scalar | |
mo_cylinderLength | cylinderLength | Cylinder length | Scalar | |
mo_rodLength | rodLength | Rod length | Scalar | |
mo_angle | angle | Inclination angle | Scalar | |
mo_deadVolume | deadVolume | Dead volume | Scalar | |
mo_massPiston | massPiston | Piston mass | Scalar | |
mo_massCylinder | massCylinder | Cylinder mass | Scalar | |
mo_stroke | stroke | stroke | Structure | |
mo_stroke/fixed | fixed | Cell of scalars | true | |
mo_stroke/start | start | Cell of scalars | ||
mo_relVelocity | relVelocity | relVelocity | Structure | |
mo_relVelocity/fixed | fixed | Cell of scalars | true | |
mo_relVelocity/start | start | Cell of scalars | ||
mo_pA | pA | pA | Structure | |
mo_pA/fixed | fixed | Cell of scalars | true | |
mo_pA/start | start | Cell of scalars | ||
mo_pB | pB | pB | Structure | |
mo_pB/fixed | fixed | Cell of scalars | true | |
mo_pB/start | start | Cell of scalars |
Name | Label | Description | Data Type | Valid Values |
---|---|---|---|---|
mo_fProp | fProp | Velocity dependent friction | Scalar | |
mo_fCoulomb | fCoulomb | Constant friction/Coulomb force | Scalar | |
mo_fBreakaway | fBreakaway | Breakaway friction force | Scalar | |
mo_vM | vM | Velocity parameter for Stribeck friction | Scalar | |
mo_relFric | relFric | Use "relative friction factor" to calculate friction | Scalar | true |
mo_relFricFactor | relFricFactor | Relative friction factor | Scalar | |
mo_vSmall | vSmall | Relative velocity near to zero | Scalar | |
mo_leakageFlowRateInternal | leakageFlowRateInternal | Internal leakage: volume flow | Scalar | |
mo_leakagePressureDiffInternal | leakagePressureDiffInternal | Internal leakage: pressure difference | Scalar | |
mo_leakageFlowRateExternal | leakageFlowRateExternal | External leakage: volume flow | Scalar | |
mo_leakagePressureDiffExternal | leakagePressureDiffExternal | External leakage: pressure difference | Scalar | |
mo_leakageReferenceDensity | leakageReferenceDensity | Reference density for volume flow and pressure difference | Scalar |
Name | Label | Description | Data Type | Valid Values |
---|---|---|---|---|
mo_useHardBumpstops | useHardBumpstops | Enforce hard limits on stroke instead of bumpstops | Scalar | true |
mo_c | c | Bumpstops spring constant | Scalar | |
mo_d | d | Bumpstops damping constant | Scalar | |
mo_n | n | Exponent of bumpstops spring force ( f_c = -c*|s_rel-s_rel0|^n ) | Scalar |
Name | Label | Description | Data Type | Valid Values |
---|---|---|---|---|
mo_forwardFluidProperties | forwardFluidProperties | Forward fluid properties between ports | Scalar | true |
Name | Label | Description | Data Type | Valid Values |
---|---|---|---|---|
mo__nmodifiers | Number of Modifiers | Specifies the number of modifiers | Number | |
mo__modifiers | Modifiers | Add new modifier | Structure | |
mo__modifiers/varname | Variable name | Cell of strings | ||
mo__modifiers/attribute | Attribute | Cell of strings | 'start' | |
mo__modifiers/value | Value |
Ports
Name | Type | Description | IO Type | Number |
---|---|---|---|---|
flange_c | implicit | input | 1 | |
flange_p | implicit | output | 1 | |
fluidPortA | implicit | Hydraulic port A | input | 2 |
fluidPortB | implicit | Hydraulic port B | input | 3 |
strokeOut | implicit | Relative position of piston | output | 2 |