Name

Default

Description

Modelica ID

side

$A$

Choose winch side to attach a rope

side

${\stackrel{\^}{e}}_{\mathrm{axis}}$

$⟨0\,0\,1⟩$

Unit vector (w.r.t. local frame) defining the axis of rotation for the pulley

e_axis

Use alternative configuration

$\mathrm{false}$

Choose between two possible solutions for the rope/pulley configuration. Refer to the section Rope Arrangement above.

useAltConfig

Name

Condition

Default

Units

Description

Modelica ID

D

0.2

$m$

Barrel diameter. The pitch radius of the rope around the pulley is: $\frac{\mathrm{D}}{2}\+\left(2n_{\mathrm{Layer}}\+1\right)r$ where $n_{\mathrm{Layer}}\ge 0$ is the current winding layer.

D

m

1

$\mathrm{kg}$

Pulley mass (excluding the holder)

m

Use cylindrical geometry

true

When checked (true) pulley inertia is calculated assuming a uniform thin-disk geometry

useCylindricalGeometry

$\left[\mathrm{I}\right]$

$\mathrm{Use\; cylindrical\; geometry}\=\mathrm{false}$

$\mathrm{kg}{m}^2$

Pulley rotational inertia

Inertia

Name

Default

Units

Description

Modelica ID

$\mathrm{\lambda }$

$0$

$\frac{\mathrm{kg}}{m}$

Linear density. If a positive number is used, the winch inertia w.r.t. the axis of rotation becomes a function of rope winding (i.e. length and layers).

lambda

$r$

$0.02$

$m$

Rope radius.  Unlike all other components in this library, the rope radius has physical meaning in the Winch 3D component as it affects the traverse speed and changes in the drum radius due to multi-layer winding.

radius

$L$

$0.02$

$m$

Rope traverse. The length is centered on the connection point. The actual value used is $2r⌊\frac{L}{2r}\+1⌋$

L

$n_{\mathrm{LD}}$

$4$

Initial number of wound layers

nLayers

Name

Condition

Default

Units

Description

Modelica ID

$m_f$

$\mathrm{Locked}\=\mathrm{false}$

$1$

$\mathrm{kg}$

Frame (holder) mass

mf

${\left[I\right]}_f$

$\mathrm{Locked}\=\mathrm{false}$

$\mathrm{kg}{m}^2$

Frame (holder) rotational inertia

Inertiaf

Add frame offset

false

When checked (true), a rigid body frame is added to the winch frame to move the connection point away from the center

addFrameOffset

$r_f$

$\mathrm{Add\; frame\; offset}\=\mathrm{true}$

$\left[0\,R\right]$

$m$

Offset in the winch plane. If the rotational axis is local $X$, the offset is local $\left\{Y\,Z\right\}$. Offset for other choices for the rotation axis follow the right-hand rule.

rf

Name

Default

Units

Description

Modelica ID

${\mathrm{IC}}_{\mathrm{\theta }\,\mathrm{\omega }}$

Ignore

Indicates whether MapleSim ignores, tries to enforce, or strictly enforces the rotational initial conditions

MechRotTree

${\mathrm{\theta }}_0$

0

$\mathrm{rad}$

Initial rotation of the joint at the start of the simulation, expressed about the ${\stackrel{\^}{e}}_{\mathrm{axis}}$ axis

InitAng

${\mathrm{\omega }}_0$

0

$\frac{\mathrm{rad}}{s}$

Initial angular velocity of the the joint at the start of the simulation, expressed about the ${\stackrel{\^}{e}}_{\mathrm{axis}}$ axis

IntAngVel

Name

Condition

Default

Description

Modelica ID

Show pulley

true

Show pulley visualization

showPulley

Show band

$\mathrm{Show\; pulley}\=\mathrm{true}$

true

Show a rotating band in the pulley visualization

showBand

Show frame

$\mathrm{Add\; frame\; offset}\=\mathrm{true}$

true

Show winch frame visualization

showFrame

Show rope

true

Show rope visualization

showRope

Transparent pulley

$\mathrm{Show\; pulley}\=\mathrm{true}$

false

Select this option to make the pulley transparent

transparent_pulley

Transparent frame

$\left(\mathrm{Add\; frame\; offset}\=\mathrm{true}\right)\wedge \left(\mathrm{Show\; frame}\=\mathrm{true}\right)$

false

Select this option to make the frame transparent

transparent_frame

Transparent rope

$\mathrm{Show\; rope}\=\mathrm{true}$

false

Select this option to make the rope transparent

transparent_rope

Pulley color

$\mathrm{Show\; pulley}\=\mathrm{true}$

blue

Pulley color

color_pulley

Band color

$\mathrm{Show\; pulley}\=\mathrm{true}$

yellow

Band color

color_band

Frame color

$\left(\mathrm{Add\; frame\; offset}\=\mathrm{true}\right)\wedge \left(\mathrm{Show\; frame}\=\mathrm{true}\right)$

orange

Frame color

color_frame

Rope color

$\mathrm{Show\; rope}\=\mathrm{true}$

gray

Rope color

color

Name

Default

Description

Modelica ID

Test mode

false

Use this option to test the pulley configuration.  All rope connections and internal dynamics are switched off when in test mode

testMode

Halt at no rope

true

When checked (true) simulation is halted if the winch ran out of rope

useRopeLimit