Main Content

Leadscrew

R2026b

Leadscrew gear set of threaded rotating screw and translating nut, with adjustable thread and friction losses

  • Leadscrew block

Libraries:
Simscape / Driveline / Gears / Rotational- Translational

Description

The Leadscrew block represents a threaded rotational-translational gear that constrains the two connected driveline axes, screw (S) and nut (N), to, respectively, rotate and translate together in a fixed ratio that you specify. You can choose whether the nut axis translates in a positive or negative direction, as the screw rotates in a positive right-hand direction. If the screw helix is right-hand, ωS and vN have the same sign. If the screw helix is left-hand, ωS and vN have opposite signs.

Ideal Nut Constraint and Transmission Ratio

The block imposes one kinematic constraint on the two connected axes:

ωSL = 2πvN.(1)

The transmission ratio is RNS = 2π/L. L is the screw lead, the translational displacement of the nut for one turn of the screw. In terms of this ratio, the kinematic constraint is:

ωS = RNSvN.(2)

The two degrees of freedom are reduced to one independent degree of freedom. The forward-transfer gear pair convention is (1,2) = (S,N).

The torque-force transfer is:

RNSτS + FN – Floss = 0,(3)

with Floss = 0 in the ideal case.

Nonideal Nut Constraint and Losses

In the nonideal case, Floss ≠ 0. For general considerations on nonideal gear modeling, see Model Gears with Losses.

Geometric Surface Contact Friction

In the contact friction case, ηSN and ηNS are determined by:

  • The screw-nut threading geometry, specified by lead angle λ and acme thread half-angle α.

  • The surface contact friction coefficient k.

ηSN = (cosα – k·tanλ)/(cosα + k/tanλ),(4)
ηNS = (cosα – k/tanλ)/(cosα + k·tanλ).(5)
Constant Efficiencies

In the constant efficiency case, you specify ηSN and ηNS, independently of geometric details.

Self-Locking and Negative Efficiency

ηNS has two distinct regimes, depending on lead angle λ, separated by the self-locking point at which ηNS = 0 and cosα = k/tanλ.

  • In the overhauling regime, ηNS > 0. The force acting on the nut can rotate the screw.

  • In the self-locking regime, ηNS < 0. An external torque must be applied to the screw to release an otherwise locked mechanism. The more negative is ηNS, the larger the torque must be to release the mechanism.

ηSN is conventionally positive.

Meshing Efficiency

The efficiencies η of meshing between screw and nut are fully active only if the transmitted power is greater than the power threshold.

If the power is less than the threshold, the actual efficiency is automatically regularized to unity at zero velocity.

Viscous Friction Torque

The viscous friction coefficient μ controls the viscous friction torque experienced by the screw from lubricated, nonideal gear threads. The viscous friction torque on a screw driveline axis is –μSωS. ωS is the angular velocity of the screw with respect to its mounting.

Thermal Modeling

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

Hardware-in-the-Loop Simulation

For optimal performance of your real-time simulation, set the Friction model to No meshing losses - Suitable for HIL simulation on the Meshing Losses tab.

Variables

Use the Variables settings to set the priority and initial target values for the block variables before simulating. For more information, see Set Priority and Initial Target for Block Variables.

Limitations

  • Gear inertia is assumed to be negligible.

  • Gears are treated as rigid components.

  • Coulomb friction slows down simulation. For more information, see Adjust Model Fidelity.

Ports

Conserving

expand all

Mechanical rotational conserving port associated with the screw.

Programmatic Use

Port: S

Mechanical translational conserving port associated with the nut.

Programmatic Use

Port: N

Thermal conserving port associated with heat flow.

Programmatic Use

Port: H

Parameters

expand all

Main

Translational displacement L of the nut per revolution of the screw.

Programmatic Use

Parameter: Lead

Choose the directional sense of screw rotation corresponding to positive nut translation. For the Right-hand orientation, the screw angular velocity and the nut velocity have the same sign.

Programmatic Use

Parameter: helix_type
Values: "sdl.enum.handedness.right" | "sdl.enum.handedness.left"

Meshing Losses

  • No meshing losses — Suitable for HIL simulation — Screw meshing is ideal.

  • Constant efficiency — Power transfer between screw and nut is reduced by friction.

  • Temperature-dependent efficiency — Power transfer is determined from user-supplied data for screw-nut efficiency, nut-screw efficiency, and temperature.

Programmatic Use

Parameter: friction_model
Values: "sdl.enum.gear_friction.constant" | "sdl.enum.gear_friction.thermal" | "sdl.enum.gear_friction.none"
  • Friction coefficient and geometrical parameters — Friction is determined by contact friction between surfaces.

  • Efficiencies — Friction is determined by constant efficiencies 0 < η < 1.

Dependencies

To enable this parameter, set Friction model to Constant efficiency.

Programmatic Use

Parameter: friction_parameterization
Values: "sdl.enum.frictionParameterization.geometry" | "sdl.enum.frictionParameterization.efficiencies"

Thread helix angle λ = arctan[L/(πd)], where:

  • L is the screw lead.

  • d is the screw pitch diameter.

The value must be greater than zero.

Dependencies

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

Programmatic Use

Parameter: lambda

Half-angle of the acme thread α in the normal plane. In the case of a square thread, α = 0. The value must be greater than or equal to zero.

Dependencies

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

Programmatic Use

Parameter: alpha

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

Dependencies

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

Programmatic Use

Parameter: fr_coeff

Efficiency ηSN of the power transfer from screw to nut.

Dependencies

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

Programmatic Use

Parameter: eff_sn

Efficiency ηNS of the power transfer from nut to screw.

Dependencies

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

Programmatic Use

Parameter: eff_ns

Array of temperatures used to construct a 1-D temperature-efficiency lookup table. The array values must increase left to right. The temperature array must be the same size as the Screw-nut efficiency and Nut-screw efficiency arrays.

Dependencies

To enable this parameter, set Friction model to Temperature-dependent efficiency.

Programmatic Use

Parameter: temperature_TLU

Array of component efficiencies with the screw as the driver— that is, with power from the screw to the nut. The array values are the efficiencies at the temperatures in the Temperature array. The two arrays must be the same size.

Dependencies

To enable this parameter, set Friction model to Temperature-dependent efficiency.

Programmatic Use

Parameter: efficiency_sn_TLU

Array of component efficiencies with the nut as the driver— that is, with power flowing from the nut to the screw. The array values are the efficiencies at the temperatures in the Temperature array. The two arrays must be the same size.

Dependencies

To enable this parameter, set Friction model to Temperature-dependent efficiency.

Programmatic Use

Parameter: efficiency_ns_TLU

Power threshold above which full efficiency factor is in effect. A hyperbolic tangent function smooths the efficiency factor between zero at rest and the current efficiency set point.

Programmatic Use

Parameter: pwr_thr

Viscous Losses

Viscous friction coefficient μS for the screw.

Programmatic Use

Parameter: mu_visc

Thermal Port

Thermal energy required to change the component temperature by a single degree. The greater the thermal mass, the more resistant the component is to temperature change.

Programmatic Use

Parameter: thermal_mass

Component temperature at the start of simulation. The initial temperature alters the component efficiency according to an efficiency vector that you specify, affecting the starting meshing or friction losses.

Programmatic Use

Parameter: T_init

Extended Capabilities

expand all

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

Version History

Introduced in R2011a