Documentation |
Fixed distance between two frame origins
This block applies a fixed distance between the origins of the base and follower port frames. The frames lose one translational degree of freedom if the constraint distance is greater than zero. They lose three translational degrees of freedom if the constraint distance is exactly zero. The figure shows the distance constraint between two frames.
Constraint distance between the base and follower frame origins. The distance must be greater than zero. For a distance of zero, use a Spherical Joint or Gimbal Joint block instead. The default value is 1 m.
Select whether to compute and output the distance constraint force vector and its signed magnitude. The distance constraint force is the force that the block must apply in order to maintain the distance you specify between the base and follower port frames.
Constraint forces act in pairs. As expressed by Newton's third law of motion, if the base port frame exerts a constraint force on the follower port frame, then the follower port frame must exert an equal and opposite force on the base port frame. Select which of the two constraint forces to sense:
Follower on Base — Sense the constraint force that the follower port frame exerts on the base port frame.
Base on Follower — Sense the constraint force that the base port frame exerts on the follower port frame.
The block expresses the constraint force vector in terms of its Cartesian vector components. The splitting of a vector into vector components is known as vector resolution. The frame whose axes define the vector component directions is known as the resolution frame. Select whether to resolve the constraint force vector in the base or follower port frame.
Compute and output the Cartesian components of the distance constraint force vector. The output signal is a three-dimensional vector, [f_{x}, f_{y}, f_{z}].
Compute and output the magnitude of the distance constraint force, including its sign.
The block provides two frame ports:
B — Base frame port
F — Follower frame port
In addition, the block provides two physical signal output ports:
f — Distance constraint force vector
fm — Signed magnitude of the distance constraint force