*SetSpringPreloadOption() - pair coil/torsion spring

Sets the preload control option for the coil or torsion spring pair.

Syntax

*SetSpringPreloadOption(spr_name, option_left, option_right)

Arguments

spr_name
The variable name of an existing coil/torsion spring.
Data type: varname
option_left
Preload option for the left side of the spring pair.
Data type: Option
Valid choices:
  • Coil spring – OFF|FORCE|LENGTH| FORCE_LENGTH
  • Torsion spring – OFF|TORQUE|ANGLE|TORQUE_ANGLE
option_right
Preload option for the right side of the spring pair.
Data type: Option
Valid choices:
  • Coil spring – OFF|FORCE|LENGTH| FORCE_LENGTH
  • Torsion spring – OFF|TORQUE|ANGLE|TORQUE_ANGLE

Coil Spring Example

*BodyPair(b_lca, "LCA", p_lca_cm)
*BodyPair(b_frame, "Frame", p_frame_cm)
*PointPair(p_spr_upr, "Spring @ frame")
*PointPair(p_spr_lwr, "Spring @ lca")
*CoilSpringPair(spring_uca, "Coil Spring", b_lca, b_frame, p_spr_upr, p_spr_lwr)
*SetCoilSpring( sd_coil,   , LIN, 10.0, LIN, , 490, mag(sd_coil.l.p1.data - sd_coil.l.p2.data)+10, LIN, 10.0, LIN, 0.0, 500, 512) //Unsymmetric coil spring
*SetSpringPreloadOption(spring_uca,  FORCE, LENGTH ) //Sets preload option to use force only on the left and length only on the right
*SetCoilSpring(spring_uca, LEFT) //Spring is set to symmetry with left as leader. Preload option will be force only on both sides.

Torsion Spring Example

*BodyPair(b_lever, "Lever", p_lever)
*PointPair(p_spr, "Spring Origin")
*TorsionSpringPair(spring, "Torsion Spring", b_lever, B_Ground, p_spr, VECTOR, V_Global_Z)
*SetTorsionSpring(spring,   , LIN, 100.0, LIN, 1, -4950, 10, LIN, 100.0, LIN, 1, 5000,10 )//Unsymmetric spring with different preloads on left and right (both torque and angle specified)
*SetSpringPreloadOption(spring,  TORQUE, TORQUE_ANGLE ) //Sets preload option to use torque only on left and both torque and angle on the right
*SetTorsionSpring(spring, RIGHT) //Spring is set to symmetric with right as leader. Preload option will use both torque and angle for both sides

Context

*BeginMdl()

*DefineAnalysis()

*DefineAssembly()

*DefineSystem()

Comments

This statement can be used to set which option to use for preload application when values for force and length are specified for the spring using *SetCoilSpring().
Option Effect on Total Preload
OFF Preload is turned off.
FORCE Only the force value of preload is active.
LENGTH Only the length-based preload is active.
FORCE_LENGTH Use both the Force and Length methods to specify preload.

A similar set of options are available for a torsion spring which involves TORQUE and ANGLE. Refer to examples above.

The symmetry for the preload is controlled by the symmetry property on the *SetCoilSpring()/*SetTorsionSpring() statement.