transformDirection

Class: simscape.multibody.Transformation
Namespace: simscape.multibody

Apply rotation to 3-D column vectors

Since R2022a

Syntax

xv = transformDirection(T,v)

Description

xv = transformDirection(T,v) transforms a set of 3-D column vectors that represent directions. The rotational part of the transformation changes the orientations for the directions. The translational part does not affect the 3-D column vectors because directions do not have offset.

v argument specifies the vectors of the directions, T argument specifies a desired transformation used to change the directions. xv argument returns the computed 3-D column vectors, and each column vector represents a transformed direction. The returned vectors, xv, have the same format as v.

If the T argument is the transformation from follower frame to base frame, and the ith column of the v argument is a direction resolved in follower frame, then the ith column of the xv argument is the same direction resolved in base frame.

Input Arguments

expand all

`T` — Transformation
`simscape.multibody.Transformation` object

Transformation, specified as a simscape.multibody.Transformation object.

`v` — Directions
3-D column vectors | `simscape.Value` | object

Directions, specified as either 3-D column vectors or a simscape.Value object that represents 3-D column vectors with arbitrary units. Each vector represents a direction.

Output Arguments

expand all

`xv` — Transformed directions
3-D column vectors | `simscape.Value` | object

Transformed directions, returned as either 3-D column vectors or a simscape.Value object that represents 3-D column vectors with arbitrary units. Each vector represents a direction. This argument and the vectors specified for the v argument always have the same format.

Attributes

Access public

To learn about attributes of methods, see Method Attributes.

Version History

Introduced in R2022a