Main Content

simscape.multibody.RotationSequenceRotation Class

Namespace: simscape.multibody
Superclasses: simscape.multibody.Rotation

Construct rotation by using rotation-sequence parameterization

Since R2022a

Description

Use an object of the simscape.multibody.RotationSequenceRotation class to construct a 3-D rotation by using a rotation-sequence parameterization. Any 3-D rotation can be described by three successive elementary rotations. The elementary rotations correspond to the axes of a frame that can be either the base or follower frame. Note that the base frame is fixed while the follower frame rotates after each elementary rotation.

The Axes property specifies which frame's axes the elementary rotations are performed about. The Sequence property specifies the sequence of the elementary rotations. The Angles property specifies the angles for the three elementary rotations. Note that consecutive axes are distinct.

Class Attributes

Sealed
true
ConstructOnLoad
true
RestrictsSubclassing
true

For information on class attributes, see Class Attributes.

Creation

Description

R = simscape.multibody.RotationSequenceRotation creates a rotation-sequence rotation with default values.

R = simscape.multibody.RotationSequenceRotation(axes,sequence,angles) creates a rotation-sequence rotation with the specified axes of rotation, rotation sequence, and rotation angles.

Properties

expand all

Selection of rotation axes, specified as either the simscape.multibody.FrameSide.Follower or simscape.multibody.FrameSide.Base member. Use the simscape.multibody.FrameSide.Base member to set the axes of the base frame as rotation axes for elementary rotations, or use simscape.multibody.FrameSide.Follower to set the axes of the follower frame as rotation axes for elementary rotations.

Example: simscape.multibody.FrameSide.Base

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Sequence of three axes to rotate about, specified as a member of the simscape.multibody.AxisSequence class. Use one of the following members to set the Sequence property:

  • simscape.multibody.AxisSequence.XYX

  • simscape.multibody.AxisSequence.XYZ

  • simscape.multibody.AxisSequence.XZX

  • simscape.multibody.AxisSequence.XZY

  • simscape.multibody.AxisSequence.YXY

  • simscape.multibody.AxisSequence.YXZ

  • simscape.multibody.AxisSequence.YZX

  • simscape.multibody.AxisSequence.YZY

  • simscape.multibody.AxisSequence.ZXY

  • simscape.multibody.AxisSequence.ZXZ

  • simscape.multibody.AxisSequence.ZYX

  • simscape.multibody.AxisSequence.ZYZ

Example: simscape.multibody.AxisSequence.XZY

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Angles of elementary rotations, specified as a simscape.Value object that represents a 3-by-1 or 1-by-3 array in units of angle.

Example: simscape.Value([30 10 40],"deg")

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Version History

Introduced in R2022a