Gazebo Sensors

API Reference

6.8.1
ImuSensor Class Reference

Imu Sensor Class. More...

#include <ImuSensor.hh>

Public Member Functions

 ImuSensor ()
 constructor More...
 
virtual ~ImuSensor ()
 destructor More...
 
math::Vector3d AngularVelocity () const
 Get the angular velocity of the imu. More...
 
math::Vector3d Gravity () const
 Get the gravity vector. More...
 
bool HasConnections () const
 Check if there are any subscribers. More...
 
virtual bool Init () override
 Initialize values in the sensor. More...
 
math::Vector3d LinearAcceleration () const
 Get the linear acceleration of the imu. More...
 
virtual bool Load (const sdf::Sensor &_sdf) override
 Load the sensor based on data from an sdf::Sensor object. More...
 
virtual bool Load (sdf::ElementPtr _sdf) override
 Load the sensor with SDF parameters. More...
 
math::Quaterniond Orientation () const
 Get the orienation of the imu with respect to reference frame. More...
 
bool OrientationEnabled () const
 Get whether or not orientation is enabled. More...
 
math::Quaterniond OrientationReference () const
 Get the world orienation reference of the imu. More...
 
void SetAngularVelocity (const math::Vector3d &_angularVel)
 Set the angular velocity of the imu. More...
 
void SetGravity (const math::Vector3d &_gravity)
 Set the gravity vector. More...
 
void SetLinearAcceleration (const math::Vector3d &_linearAcc)
 Set the linear acceleration of the imu. More...
 
void SetOrientationEnabled (bool _enabled)
 Set whether to output orientation. Not all imu's generate orientation values as they use filters to produce orientation estimates. More...
 
void SetOrientationReference (const math::Quaterniond &_orient)
 Set the orientation reference, i.e. initial imu orientation. Imu orientation data generated will be relative to this reference frame. More...
 
void SetWorldFrameOrientation (const math::Quaterniond &_rot, WorldFrameEnumType _relativeTo)
 Specify the rotation offset of the coordinates of the World frame relative to a geo-referenced frame. More...
 
void SetWorldPose (const math::Pose3d _pose)
 Set the world pose of the imu. More...
 
virtual bool Update (const std::chrono::steady_clock::duration &_now) override
 Update the sensor and generate data. More...
 
math::Pose3d WorldPose () const
 Get the world pose of the imu. More...
 
- Public Member Functions inherited from Sensor
virtual ~Sensor ()
 destructor More...
 
void AddSequence (gz::msgs::Header *_msg, const std::string &_seqKey="default")
 Add a sequence number to an gz::msgs::Header. This function can be called by a sensor that wants to add a sequence number to a sensor message in order to have improved accountability for generated sensor data. More...
 
bool EnableMetrics () const
 Get flag state for enabling performance metrics publication. More...
 
std::string FrameId () const
 FrameId. More...
 
SensorId Id () const
 Get the sensor's ID. More...
 
bool IsActive () const
 Get whether the sensor is enabled or not. More...
 
std::string Name () const
 Get name. More...
 
std::chrono::steady_clock::duration NextDataUpdateTime () const
 Return the next time the sensor will generate data. More...
 
std::string Parent () const
 Get parent link of the sensor. More...
 
gz::math::Pose3d Pose () const
 Get the current pose. More...
 
void PublishMetrics (const std::chrono::duration< double > &_now)
 Publishes information about the performance of the sensor. This method is called by Update(). More...
 
sdf::ElementPtr SDF () const
 Get the SDF used to load this sensor. More...
 
void SetActive (bool _active)
 Enable or disable the sensor. Disabled sensors will not generate or publish data unless Update is called with the '_force' argument set to true. More...
 
void SetEnableMetrics (bool _enableMetrics)
 Set flag to enable publishing performance metrics. More...
 
void SetFrameId (const std::string &_frameId)
 Set Frame ID of the sensor. More...
 
virtual void SetParent (const std::string &_parent)
 Set the parent of the sensor. More...
 
void SetPose (const gz::math::Pose3d &_pose)
 Update the pose of the sensor. More...
 
bool SetTopic (const std::string &_topic)
 Set topic where sensor data is published. More...
 
void SetUpdateRate (const double _hz)
 Set the update rate of the sensor. An update rate of zero means that the sensor is updated every cycle. It's zero by default. \detail Negative rates become zero. More...
 
std::string Topic () const
 Get topic where sensor data is published. More...
 
bool Update (const std::chrono::steady_clock::duration &_now, const bool _force)
 Update the sensor. More...
 
double UpdateRate () const
 Get the update rate of the sensor. More...
 

Additional Inherited Members

- Protected Member Functions inherited from Sensor
 Sensor ()
 constructor More...
 

Detailed Description

Imu Sensor Class.

An imu sensor that reports linear acceleration, angular velocity, and orientation

Constructor & Destructor Documentation

◆ ImuSensor()

ImuSensor ( )

constructor

◆ ~ImuSensor()

virtual ~ImuSensor ( )
virtual

destructor

Member Function Documentation

◆ AngularVelocity()

math::Vector3d AngularVelocity ( ) const

Get the angular velocity of the imu.

Returns
Angular velocity of the imu in body frame, expressed in radians per second.

◆ Gravity()

math::Vector3d Gravity ( ) const

Get the gravity vector.

Returns
Gravity vectory in meters per second squared.

◆ HasConnections()

bool HasConnections ( ) const

Check if there are any subscribers.

Returns
True if there are subscribers, false otherwise
Todo:
(iche033) Make this function virtual on Garden

◆ Init()

virtual bool Init ( )
overridevirtual

Initialize values in the sensor.

Returns
True on success

Reimplemented from Sensor.

◆ LinearAcceleration()

math::Vector3d LinearAcceleration ( ) const

Get the linear acceleration of the imu.

Returns
Linear acceleration of the imu in local frame, expressed in meters per second squared.

◆ Load() [1/2]

virtual bool Load ( const sdf::Sensor &  _sdf)
overridevirtual

Load the sensor based on data from an sdf::Sensor object.

Parameters
[in]_sdfSDF Sensor parameters.
Returns
true if loading was successful

Reimplemented from Sensor.

◆ Load() [2/2]

virtual bool Load ( sdf::ElementPtr  _sdf)
overridevirtual

Load the sensor with SDF parameters.

Parameters
[in]_sdfSDF Sensor parameters.
Returns
true if loading was successful

Reimplemented from Sensor.

◆ Orientation()

math::Quaterniond Orientation ( ) const

Get the orienation of the imu with respect to reference frame.

Returns
Orientation in reference frame. If orientation is not enabled, this will return the last computed orientation before orientation is disabled or identity Quaternion if orientation has never been enabled.

◆ OrientationEnabled()

bool OrientationEnabled ( ) const

Get whether or not orientation is enabled.

Returns
True if orientation is enabled, false otherwise.

◆ OrientationReference()

math::Quaterniond OrientationReference ( ) const

Get the world orienation reference of the imu.

Returns
Orientation reference in world frame

◆ SetAngularVelocity()

void SetAngularVelocity ( const math::Vector3d &  _angularVel)

Set the angular velocity of the imu.

Parameters
[in]_angularVelAngular velocity of the imu in body frame expressed in radians per second

◆ SetGravity()

void SetGravity ( const math::Vector3d &  _gravity)

Set the gravity vector.

Parameters
[in]_gravitygravity vector in meters per second squared.

◆ SetLinearAcceleration()

void SetLinearAcceleration ( const math::Vector3d &  _linearAcc)

Set the linear acceleration of the imu.

Parameters
[in]_linearAccLinear accceleration of the imu in body frame expressed in meters per second squared.

◆ SetOrientationEnabled()

void SetOrientationEnabled ( bool  _enabled)

Set whether to output orientation. Not all imu's generate orientation values as they use filters to produce orientation estimates.

Parameters
[in]_enabledTrue to publish orientation data, false to leave the message field empty.

◆ SetOrientationReference()

void SetOrientationReference ( const math::Quaterniond &  _orient)

Set the orientation reference, i.e. initial imu orientation. Imu orientation data generated will be relative to this reference frame.

Parameters
[in]_orientationReference orientation

◆ SetWorldFrameOrientation()

void SetWorldFrameOrientation ( const math::Quaterniond &  _rot,
WorldFrameEnumType  _relativeTo 
)

Specify the rotation offset of the coordinates of the World frame relative to a geo-referenced frame.

Parameters
[in]_rotrotation offset
[in]_relativeToworld frame orientation, ENU by default

◆ SetWorldPose()

void SetWorldPose ( const math::Pose3d  _pose)

Set the world pose of the imu.

Parameters
[in]_posePose in world frame

◆ Update()

virtual bool Update ( const std::chrono::steady_clock::duration &  _now)
overridevirtual

Update the sensor and generate data.

Parameters
[in]_nowThe current time
Returns
true if the update was successfull

Implements Sensor.

◆ WorldPose()

math::Pose3d WorldPose ( ) const

Get the world pose of the imu.

Returns
Pose in world frame.

The documentation for this class was generated from the following file: