Name

Condition

Default

Description

Modelica ID

$n$

$5$

Number of middle nodes. E.g., when $n\=5$, there are 7 mass points.

n

No force in compression

$\mathrm{Extensible}\=\mathrm{true}$

false

When checked (true) the chain applies no force in compression. This option may be avoided if the chain always remains in tension.

noCompression

Detail

$\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; one\; end\; b}\right)\=\mathrm{true}$

$1$

Formulation detail level: (1) Level 1: No flow inertial reaction (low flow velocity or acceleration) (2) Level 2: Full formulation (high flow velocity or acceleration)

Detail

Use node frames

$\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; one\; end\; b}\right)\=\mathrm{true}$

false

When checked (true) $n$ frames for the middle nodes are enabled

useNodeFrames

Tangent to pulley

$\left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; one\; end\; b}\right)\=\mathrm{true}$

false

When checked (true) the chain segment connected to the pulley is forced to remain tangent to the pulley. Using this option will result in more realistic-looking simulations, however, the initialization may fail or the simulation may become unstable if the lengths of the chain segments are smaller than the radius of the pulley.

forceTangent

Name

Condition

Default

Units

Description

Modelica ID

$\mathrm{\lambda }$

$0.5$

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

Linear density

lambda

EA

$1000000$

$N$

Axial rigidity: Modulus of elasticity (E) times area (A)

EA

$d_r$

$0.01$

Damping ratio: $c\=d_r\mathrm{EA}$

dr

Pretension

false

When checked (true) the unstretched length is given by the initial length of the chain minus the pretension length.

usePretension

${\mathrm{\delta }}_L$

$\mathrm{Pretension}\=\mathrm{true}$

$0.1$

$m$

Pretension length

dL

$d_0$

$\mathrm{Use\; wind}\=\mathrm{false}$

$0.1$

$\frac{Ns}{m}$

Linear drag (per unit length). This effect is only used to reduce excessive lateral vibrations.

d_0

Name

Condition

Default

Units

Description

Modelica ID

Use wind

false

Enable wind calculations

useWind

Use data table

$\mathrm{Use\; wind}\=\mathrm{true}$

false

When true (checked) lift and drag coefficients are defined as a function of the angle between chain segment and relative wind velocity.

useTable

$c_{\mathrm{D0}}$

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{false}\right)$

$1.1$

Drag coefficient, $c_{\mathrm{D}}\=c_{\mathrm{D0}}{\sin \left(\mathrm{\alpha }\right)}^3\+\mathrm{\pi }{c}_F$ and $c_L\=c_{\mathrm{D0}}{\sin \left(\mathrm{\alpha }\right)}^2\cos \left(\mathrm{\alpha }\right)$

cD0

$c_F$

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{false}\right)$

$0$

Friction coefficient, $c_{\mathrm{D}}\=c_{\mathrm{D0}}{\sin \left(\mathrm{\alpha }\right)}^3\+\mathrm{\pi }{c}_F$

cF

data source

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{true}\right)$

inline

Data source

datasourcemode

table

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{true}\right)$

Data set. First column: Angle of Attack (in rad), Second column: Lift coefficient, Third column: Drag coefficient

table

data

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{true}\right)$

Attached data set. First column: Angle of Attack, Second column: Lift coefficient, Third column: Drag coefficient.

data

skip rows

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{true}\right)$

$0$

Number of rows to skip

skipRows

smoothness

$\left(\mathrm{Use\; wind}\=\mathrm{true}\right)\wedge \left(\mathrm{Use\; data\; table}\=\mathrm{true}\right)$

Linear segments

Smoothness of table interpolation

smoothness

${\mathrm{\rho }}_{\mathrm{air}}$

$\mathrm{Use\; wind}\=\mathrm{true}$

$1.2$

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

Air density

rho_air

$\mathrm{D}$

$\mathrm{Use\; wind}\=\mathrm{true}$

$0.04$

$m$

Chain effective diameter

D

Name

Condition

Default

Description

Modelica ID

Pulley on end a

false

When checked (true) the chain is to be connected to a pulley at frame_a

toPulley_a

Pulley on end b

false

When checked (true) the chain is to be connected to a pulley at frame_b

toPulley_b

Fixed end a

$\mathrm{Pulley\; on\; end\; a}\=\mathrm{false}$

true

When checked (true) the chain is fixed to frame_a. When unchecked (false) a 1D mechanical flange is enabled for material flow.

fixed_a

Fixed end b

$\mathrm{Pulley\; on\; end\; b}\=\mathrm{false}$

true

When checked (true) the chain is fixed to frame_b. When unchecked (false) a 1D mechanical flange is enabled for material flow.

fixed_b

Name

Condition

Default

Units

Description

Modelica ID

Show visualization

true

$N$

Show visualization

showVisualization

Transparent

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

false

Transparent

transparent

radius

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

$0.02$

$m$

Chain radius. This radius is only used for the cylindrical visualization of the chain

radius

Color mode

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

Single color

Choose color option: (1) Single color, (2) Two colors: Tension and No tension, (3) Multi-color: Color based on tension value

colorMode

Chain color

$\left(\mathrm{Show\; visualization}\=\mathrm{true}\right)\wedge \left(\mathrm{Color\; mode}\=2\right)$

gray

Chain color 1

color

2nd chain color

$\left(\mathrm{Show\; visualization}\=\mathrm{true}\right)\wedge \left(\mathrm{Color\; mode}\in \left\{2\,3\right\}\right)$

red

Chain color 2

color2

${\mathrm{\tau }}_{\min }$

$\left(\mathrm{Show\; visualization}\=\mathrm{true}\right)\wedge \left(\mathrm{Color\; mode}\=3\right)$

$0$

$N$

Minimum Tension: color 1

minTension

${\mathrm{\tau }}_{\max }$

$\left(\mathrm{Show\; visualization}\=\mathrm{true}\right)\wedge \left(\mathrm{Color\; mode}\=3\right)$

$1000$

$N$

Maximum Tension: color 2

maxTension

Force arrows

false

When checked (true), arrows are added at end points  to visualize tension.

show Tension

Scale

$\mathrm{Tension\; visualization}\=\mathrm{true}$

$1$

Force scale (N to m)

tensionscale

Color

$\mathrm{Tension\; visualization}\=\mathrm{true}$

cyan

Force arrow color

tensioncolor

Transparent

$\mathrm{Tension\; visualization}\=\mathrm{true}$

false

Force arrow transparency

tensiontransparent

Flow rate arrow

$\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; on\; end\; b}\=\mathrm{true}\right)$

false

When checked (true), an arrow is added to visualize material flow speed and direction

showFlow

Scale

$\left(\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; on\; end\; b}\=\mathrm{true}\right)\right)\wedge \left(\mathrm{Flow\; visualization}\=\mathrm{true}\right)$

$1$

Speed scale (m/s to m)

speedscale

Color

$\left(\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; on\; end\; b}\=\mathrm{true}\right)\right)\wedge \left(\mathrm{Flow\; visualization}\=\mathrm{true}\right)$

magenta

Flow arrow color

flowcolor

Transparent

$\left(\left(\mathrm{Fixed\; end\; a}\=\mathrm{false}\right)\vee \left(\mathrm{Fixed\; end\; b}\=\mathrm{false}\right)\vee \left(\mathrm{Pulley\; on\; end\; a}\=\mathrm{true}\right)\vee \left(\mathrm{Pulley\; on\; end\; b}\=\mathrm{true}\right)\right)\wedge \left(\mathrm{Flow\; visualization}\=\mathrm{true}\right)$

false

Flow arrow transparency

flowtransparent

Name

Default

Description

Modelica ID

Force unit

$N$

Unit in which the summary variables summary_Tension_a and summary_Tension_b are expressed

forceUnitSummary