pose

Current orientation and position estimate for `ahrs10filter`

Syntax

``[position, orientation, velocity] = pose(FUSE)``
``[position, orientation, velocity] = pose(FUSE,format)``

Description

example

````[position, orientation, velocity] = pose(FUSE)` returns the current estimate of the pose.```
````[position, orientation, velocity] = pose(FUSE,format)` returns the current estimate of the pose with orientation in the specified orientation format.```

Examples

collapse all

Create an `ahrs10filter` object and set its sample rate to 10 Hz.

`filter = ahrs10filter(IMUSampleRate=10);`

Predict the state of the filter based on an accelerometer reading of [1 1 1] $\mathrm{m}/{\mathrm{s}}^{2}$ and a gyroscope reading of [1 1 0] rad/s.

```predict(filter,[1 1 1],[1 1 0]); predict(filter,[1 1 1],[1 1 0]);```

Obtain pose from the filter state.

`[position,orientation,velocity] = pose(filter)`
```position = 0.0441 ```
```orientation = quaternion 0.99438 + 0.074859i + 0.074859j + 0k ```
```velocity = 1.3217 ```

Input Arguments

collapse all

Object of `ahrs10filter` (Sensor Fusion and Tracking Toolbox).

Output orientation format, specified as either `'quaternion'` for a `quaternion` or `'rotmat'` for a rotation matrix.

Data Types: `char` | `string`

Output Arguments

collapse all

Position estimate expressed in the local coordinate system of the filter in meters, returned as a 3-element row vector.

Data Types: `single` | `double`

Orientation estimate expressed in the local coordinate system of the filter, returned as a scalar quaternion or 3-by-3 rotation matrix. The quaternion or rotation matrix represents a frame rotation from the local reference frame of the filter to the body reference frame.

Data Types: `single` | `double` | `quaternion`

Velocity estimate expressed in the local coordinate system of the filter in m/s, returned as a 3-element row vector.

Data Types: `single` | `double`

Version History

Introduced in R2019a