Engee documentation

Leadscrew

Lever screw set consisting of a rotating threaded screw and a transfer nut, with adjustable threads and friction losses.

leadscrew

Description

The Leadscrew unit is a threaded rotary and reciprocating gear that causes two linked axes, a screw (S) and a nut (N), to rotate and move together in a fixed ratio that you specify.

You can choose whether the nut axis rotates in the positive or negative direction, with the right-hand threads of the screw rotating positively. If the screw helix is right-handed, and have the same sign. If the screw helix is left-handed, and have opposite signs.

Limitation of ideal nut and gear ratio

The block imposes one kinematic constraint on two coupled axes:

Gear ratio: . Here is the screw thread pitch, the translational movement of the nut per one turn of the screw. In terms of this ratio, the kinematic constraint is as follows:

ω .

Two degrees of freedom are reduced to one independent degree of freedom. The notation of a direct-shifting gear pair is (1,2) = (S,N).

Torque transmission is realised as follows:

,

thus in the ideal case.

Non-ideal nut constraints and losses

In the non-ideal case .

Geometric surface contact friction

In the case of contact friction and are defined:

  • The geometry of the screw-nut threads, defined by the thread lift angle and the half thread angle .

  • Surface contact friction coefficient .

Constant efficiency

In the case of constant efficiency, you specify and η , regardless of geometric details.

Self-locking and negative efficiency

has two different modes depending on the thread lift angle , separated by a self-locking point where and .

  • In the self-locking mode, . The force acting on the nut can rotate the screw.

  • In self-locking mode, . To unlock a locked mechanism, an external torque must be applied to the screw. The more negative , the greater the torque must be to unlock the mechanism. is conditionally positive.

Clutch efficiency

The clutch efficiency between the screw and the nut is only fully active if the transmitted power exceeds the threshold power.

If the power is less than the threshold, the actual efficiency automatically equalises to one at zero speed.

Viscous friction force

The viscous friction coefficient controls the viscous friction torque generated on the screw due to lubricated non-ideal gear threads. The viscous friction torque on the axis of the screw gear is equal to .

- is the angular velocity of the screw in relation to its mount.

Thermal modelling

You can model the effects of heat flow and temperature change by enabling the optional thermal port. To enable the port, set the Friction model parameter to `Temperature-dependent efficiency'.

Hardware cycle simulation

For optimal real-time simulation performance, set the Friction model parameter to No meshing losses - Suitable for HIL simulation.

Assumptions and limitations

  • The inertia of the gears is negligible.

  • Gears are treated as rigid components.

  • Coulomb friction slows down the modelling.

Ports

Conserving

# S — screw
`rotational mechanics

Details

A mechanical rotary non-directional port associated with a propeller.

Program usage name

screw_flange

# N — mechanical progressive nut
`rotational mechanics

Details

A mechanical non-directional port associated with a nut.

Program usage name

nut_flange

# H — heat flux
`heat

Details

A heat port associated with heat flow.

The heat port allows modelling the heat flow between the unit and the connected network.

Dependencies

To enable this port, set Friction model to `Temperature-dependent efficiency'.

Program usage name

thermal_port

Parameters

Main

# Screw lead (displacement per revolution) — thread pitch
m | cm | ft | in | km | mi | mm | um | yd

Details

Screw displacement of the nut per one turn of the screw.

Values

m | cm | ft | in | km | mi | mm | um | yd

Default value

0.015 m

Program usage name

lead

Evaluatable

Yes

# Screw helix type — direction of rotation
Right-hand | Left-hand

Details

The direction of rotation of the screw corresponding to positive movement of the nut.

For `Right-hand' orientation, the angular velocity of the propeller and the speed of the nut have the same sign.

Values

Right-hand | Left-hand

Default value

Right-hand

Program usage name

screw_handedness

Evaluatable

No

Meshing Losses

# Friction model — propeller friction model
No meshing losses - Suitable for HIL simulation | Constant efficiency | Temperature-dependent efficiency

Details

Propeller Friction Model. The following options are available to choose from:

  • No meshing losses - Suitable for HIL simulation+ - propeller adhesion is perfect.

  • Constant efficiency - torque transmission between screw and nut is reduced due to friction.

  • Temperature-dependent efficiency - torque transmission is determined based on user supplied data: screw-to-nut efficiency, nut-to-screw efficiency and temperature.

Values

No meshing losses - Suitable for HIL simulation | Constant efficiency | Temperature-dependent efficiency

Default value

No meshing losses - Suitable for HIL simulation

Program usage name

friction_model

Evaluatable

No

# Friction parameterization — friction losses
Friction coefficient and geometrical parameters | Efficiencies

Details

Friction losses for non-ideal meshing of gear threads. The following options are available to choose from:

  • Friction coefficient and geometrical parameters - friction is determined by contact friction between surfaces.

  • Efficiencies - friction is defined by constant coefficients 0 < < 1.

Dependencies

To use this parameter, set the Friction model parameter to Constant efficiency.

Values

Friction coefficient and geometrical parameters | Efficiencies

Default value

Friction coefficient and geometrical parameters

Program usage name

friction_parameterization

Evaluatable

No

# Lead angle — thread lift angle
deg | rad | rev | mrad

Details

Thread lift angle , where:

  • - master screw.

  • - screw pitch diameter.

The value of the angle must be greater than zero.

Dependencies

To use this parameter, set the Friction model parameter to `Constant efficiency' and the Friction parameterization parameter to `Friction coefficient and geometrical parameters'.

Values

deg | rad | rev | mrad

Default value

15.0 deg

Program usage name

lead_angle

Evaluatable

Yes

# Acme thread half angle — half thread angle
deg | rad | rev | mrad

Details

The half angle of the thread in the normal plane. In the case of square threads = 0. The value must be greater than zero.

Dependencies

To use this parameter, set the Friction model parameter to `Constant efficiency' and the Friction parameterization parameter to `Friction coefficient and geometrical parameters'.

Values

deg | rad | rev | mrad

Default value

14.5 deg

Program usage name

acme_thread_half_angle

Evaluatable

Yes

# Friction coefficient — thread friction coefficient

Details

Dimensionless coefficient of normal thread friction. The value must be greater than zero.

Dependencies

To use this parameter, set Friction model to `Constant efficiency' and Friction parameterization to `Friction coefficient and geometrical parameters'.

Default value

0.08

Program usage name

friction_coefficicent

Evaluatable

Yes

# Screw-nut efficiency — screw-to-nut efficiency

Details

Efficiency η screw-to-nut efficiency.

Dependencies

To use this parameter, set the Friction model parameter to Constant efficiency and the Friction parameterization parameter to Efficiencies.

Default value

0.75

Program usage name

screw_to_nut_efficiency_const

Evaluatable

Yes

# Nut-screw efficiency — nut-to-screw efficiency

Details

Efficiency η nut-to-screw energy transfer efficiency.

Dependencies

To use this parameter, set the Friction model parameter to Constant efficiency and the Friction parameterization parameter to Efficiencies.

Default value

0.45

Program usage name

nut_to_screw_efficiency_const

Evaluatable

Yes

# Temperature — temperature vector
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

A vector of temperatures used to construct an interpolation table of temperature/efficiency correspondence. The vector values should be monotonically increasing. The temperature vector should be of the same dimensionality as the Screw-nut efficiency and Nut-screw efficiency parameter vectors.

Dependencies

To use this parameter, set the Friction model parameter to `Temperature-dependent efficiency'.

Values

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[280.0, 300.0, 320.0] K

Program usage name

temperature_vector

Evaluatable

Yes

# Screw-nut efficiency — array of efficiency factors from screw to nut

Details

An array of component efficiencies when using the propeller as a drive - that is, when transferring energy from the propeller to the nut. The array values are the efficiencies at the temperatures in the Temperature array. Both arrays must be of the same dimension.

Dependencies

To use this parameter, set the Friction model parameter to `Temperature-dependent efficiency'.

Default value

[0.75, 0.65, 0.60]

Program usage name

screw_to_nut_efficiency_vector

Evaluatable

Yes

# Nut-screw efficiency — array of efficiency factors from nut to screw

Details

An array of component efficiencies when using the nut as a drive - that is, when transferring energy from the nut to the screw. The array values are the efficiencies at the temperatures in the Temperature array. Both arrays must be the same size.

Dependencies

To use this parameter, set the Friction model parameter to `Temperature-dependent efficiency'.

Default value

[0.50, 0.45, 0.40]

Program usage name

nut_to_screw_efficiency_vector

Evaluatable

Yes

# Power threshold — power to enable numerical smoothing
W | GW | MW | kW | mW | uW | HP_DIN

Details

The threshold power above which the full efficiency factor applies. The hyperbolic tangent function smooths the efficiency factor between zero at rest and the current efficiency setpoint.

Values

W | GW | MW | kW | mW | uW | HP_DIN

Default value

0.001 W

Program usage name

power_threshold

Evaluatable

Yes

Viscous Losses

# Viscous friction coefficient — screw viscous friction coefficient
N*m/(rad/s) | ft*lbf/(rad/s)

Details

Viscous friction coefficient for the screw.

Values

N*m/(rad/s) | ft*lbf/(rad/s)

Default value

0.0 N*m/(rad/s)

Program usage name

viscous_coefficient

Evaluatable

Yes

Thermal Port

# Thermal mass — heat capacity
J/K | kJ/K

Details

The heat energy required to change the temperature of a component by one degree. The greater the heat capacity, the more resistant the component is to temperature change.

Values

J/K | kJ/K

Default value

50.0 J/K

Program usage name

thermal_mass

Evaluatable

Yes