FhSim  3.1.0
Marine systems simulation
Loading...
Searching...
No Matches
Actuator

A linear actuator with a speed reference, force-gated motion and speed and length limits.

+ Collaboration diagram for Actuator:

The actuator is a rate integrator. The state Length integrates the commanded speed SpeedRef, bounded to the range MinSpeed to MaxSpeed. A positive SpeedRef extends the actuator, a negative or zero one retracts it. The force on the actuator gates the motion:

So a large Force blocks retraction and a small Force blocks extension: the force is the load the actuator works against, and a speed that would drive it past the force range is not executed. At MaxLength the actuator does not extend, at MinLength it does not retract. The power is Power = speed * Force, with the speed that is executed (after the gate and the speed bound). The state Energy integrates max(Power, 0): only work that the actuator does is counted, not work that is given back to it.

It has analytical Jacobians, all zero: both derivatives depend on the input ports only.

Author
Karl-Johan Reite
Date
2013.08.16 KJR: Initial version

Example configuration excerpt

<Lib
LibName = "fishery"
SimObject = "Trawl/Actuator"
Name = "A"
MinForce = "0"
MaxForce = "100000"
MinSpeed = "-0.2"
MaxSpeed = "0.2"
MinLength = "1.1"
MaxLength = "5.0"
InitialLength = "2.0"
/>

Input Ports

Name Width Description
SpeedRef 1 The commanded speed [m/s]. Positive extends, otherwise retracts.
Force 1 The force on the actuator [N]. It gates the motion, see above, and gives the power.

Output Ports

Name Width Description
Length 1 The length of the actuator [m], the State state.
Power 1 The mechanical power speed * Force [W]; negative when the force drives the actuator.
Energy 1 The integral of the positive power [J].

Configuration parameters

Name Width Description
MinForce 1 The force above which the actuator can extend [N] (Default: -DBL_MAX, so no lower gate).
MaxForce 1 The force below which the actuator can retract [N] (Default: DBL_MAX, so no upper gate).
MinSpeed 1 The lower bound of the speed [m/s], normally negative (Default: -DBL_MAX).
MaxSpeed 1 The upper bound of the speed [m/s] (Default: DBL_MAX).
MinLength 1 The shortest length [m] (Default: 0). Must not be above MaxLength.
MaxLength 1 The longest length [m] (Default: DBL_MAX).
InitialLength 1 The length at the start [m] (Default: 1). Must be from MinLength to MaxLength; the object reports a parameter error otherwise.

Initial conditions

Name Width Description
State 1 The initial length [m]. Set from InitialLength when the object is created.
Energy 1 The initial energy [J]. Fixed at 0; there is no parameter for it.

Full example file

Example.xml wires an actuator to a door controller (CLControl.Out to Actuator.SpeedRef) and to a crowfoot (Crowfoot.LineTension1 to Actuator.Force). The smallest input is the regression input tests/in/Actuator/Actuator_in.xml, with fixed SpeedRef and Force.

This SimObject is referred to as Trawl/Actuator