|
FhSim
3.1.0
Marine systems simulation
|
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:
Force > MinForce and Length < MaxLength.Force < MaxForce and Length > MinLength.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.
| 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. |
| 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]. |
| 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. |
| 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. |
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