Information about an SDF sensor. More...

#include <Sensor.hh>

Public Member Functions
	Sensor ()
	Default constructor. More...

	Sensor (const Sensor &_sensor)
	Copy constructor. More...

	Sensor (Sensor &&_sensor) noexcept
	Move constructor. More...

	~Sensor ()
	Destructor. More...

const AirPressure *	AirPressureSensor () const
	Get the air pressure sensor, or nullptr if this sensor type is not an AirPressure sensor. More...

const Altimeter *	AltimeterSensor () const
	Get the altimeter sensor, or nullptr if this sensor type is not an Altimeter. More...

const Camera *	CameraSensor () const
	Get a pointer to a camera sensor, or nullptr if the sensor does not contain a camera sensor. More...

sdf::ElementPtr	Element () const
	Get a pointer to the SDF element that was used during load. More...

const Imu *	ImuSensor () const
	Get a pointer to an IMU sensor, or nullptr if the sensor does not contain an IMU sensor. More...

const Lidar *	LidarSensor () const
	Get the lidar sensor, or nullptr if this sensor type is not a Lidar. More...

Errors	Load (ElementPtr _sdf)
	Load the sensor based on a element pointer. More...

const Magnetometer *	MagnetometerSensor () const
	Get the magnetometer sensor, or nullptr if this sensor type is not a Magnetometer. More...

std::string	Name () const
	Get the name of the sensor. More...

bool	operator!= (const Sensor &_sensor) const
	Return true this Sensor object does not contain the same values as the passed in parameter. More...

Sensor &	operator= (const Sensor &_sensor)
	Assignment operator. More...

Sensor &	operator= (Sensor &&_sensor)
	Move assignment operator. More...

bool	operator== (const Sensor &_sensor) const
	Return true if both Sensor objects contain the same values. More...

const ignition::math::Pose3d &	Pose () const SDF_DEPRECATED(9.0)
	Get the pose of the sensor. More...

const std::string &	PoseFrame () const SDF_DEPRECATED(9.0)
	Get the name of the coordinate frame in which this sensor's pose is expressed. More...

const std::string &	PoseRelativeTo () const
	Get the name of the coordinate frame relative to which this object's pose is expressed. More...

const ignition::math::Pose3d &	RawPose () const
	Get the pose of the sensor. More...

sdf::SemanticPose	SemanticPose () const
	Get SemanticPose object of this object to aid in resolving poses. More...

void	SetAirPressureSensor (const AirPressure &_air)
	Set the air pressure sensor. More...

void	SetAltimeterSensor (const Altimeter &_alt)
	Set the altimeter sensor. More...

void	SetCameraSensor (const Camera &_cam)
	Set the camera sensor. More...

void	SetImuSensor (const Imu &_imu)
	Set the IMU sensor. More...

void	SetLidarSensor (const Lidar &_lidar)
	Set the lidar sensor. More...

void	SetMagnetometerSensor (const Magnetometer &_mag)
	Set the magnetometer sensor. More...

void	SetName (const std::string &_name)
	Set the name of the sensor. More...

void	SetPose (const ignition::math::Pose3d &_pose) SDF_DEPRECATED(9.0)
	Set the pose of the sensor. More...

void	SetPoseFrame (const std::string &_frame) SDF_DEPRECATED(9.0)
	Set the name of the coordinate frame in which this sensor's pose is expressed. More...

void	SetPoseRelativeTo (const std::string &_frame)
	Set the name of the coordinate frame relative to which this object's pose is expressed. More...

void	SetRawPose (const ignition::math::Pose3d &_pose)
	Set the pose of the sensor. More...

void	SetTopic (const std::string &_topic)
	Set the topic on which sensor data should be published. More...

void	SetType (const SensorType _type)
	Set the sensor type. More...

bool	SetType (const std::string &_typeStr)
	Set the sensor type from a string. More...

void	SetUpdateRate (double _hz)
	Set the update rate. More...

std::string	Topic () const
	Get the topic on which sensor data should be published. More...

SensorType	Type () const
	Get the sensor type. More...

std::string	TypeStr () const
	Get the sensor type as a string. More...

double	UpdateRate () const
	Get the update rate in Hz. More...

Detailed Description

Information about an SDF sensor.

Constructor & Destructor Documentation

◆ Sensor() [1/3]

sdf::SDF_VERSION_NAMESPACE::Sensor::Sensor ( )

Default constructor.

◆ Sensor() [2/3]

sdf::SDF_VERSION_NAMESPACE::Sensor::Sensor ( const Sensor & _sensor )

Copy constructor.

Parameters

[in] _sensor Sensor to copy.

◆ Sensor() [3/3]

sdf::SDF_VERSION_NAMESPACE::Sensor::Sensor ( Sensor && _sensor )

noexcept

Move constructor.

Parameters

[in] _sensor Sensor to move.

◆ ~Sensor()

sdf::SDF_VERSION_NAMESPACE::Sensor::~Sensor ( )

Destructor.

Member Function Documentation

◆ AirPressureSensor()

const AirPressure* sdf::SDF_VERSION_NAMESPACE::Sensor::AirPressureSensor ( ) const

Get the air pressure sensor, or nullptr if this sensor type is not an AirPressure sensor.

Returns: Pointer to the AirPressure sensor, or nullptr if this Sensor is not a AirPressure sensor.

See also: SensorType Type() const

◆ AltimeterSensor()

const Altimeter* sdf::SDF_VERSION_NAMESPACE::Sensor::AltimeterSensor ( ) const

Get the altimeter sensor, or nullptr if this sensor type is not an Altimeter.

Returns: Pointer to the Altimeter sensor, or nullptr if this Sensor is not a Altimeter.

See also: SensorType Type() const

◆ CameraSensor()

const Camera* sdf::SDF_VERSION_NAMESPACE::Sensor::CameraSensor ( ) const

Get a pointer to a camera sensor, or nullptr if the sensor does not contain a camera sensor.

Returns: Pointer to the sensor's camera, or nullptr if the sensor is not a camera.

See also: SensorType Type() const

◆ Element()

sdf::ElementPtr sdf::SDF_VERSION_NAMESPACE::Sensor::Element ( ) const

Get a pointer to the SDF element that was used during load.

Returns: SDF element pointer. The value will be nullptr if Load has not been called.

◆ ImuSensor()

const Imu* sdf::SDF_VERSION_NAMESPACE::Sensor::ImuSensor ( ) const

Get a pointer to an IMU sensor, or nullptr if the sensor does not contain an IMU sensor.

Returns: Pointer to the sensor's IMU, or nullptr if the sensor is not an IMU.

See also: SensorType Type() const

◆ LidarSensor()

const Lidar* sdf::SDF_VERSION_NAMESPACE::Sensor::LidarSensor ( ) const

Get the lidar sensor, or nullptr if this sensor type is not a Lidar.

Returns: Pointer to the Lidar sensor, or nullptr if this Sensor is not a Lidar.

See also: SensorType Type() const

◆ Load()

Errors sdf::SDF_VERSION_NAMESPACE::Sensor::Load ( ElementPtr _sdf )

Load the sensor based on a element pointer.

This is not the usual entry point. Typical usage of the SDF DOM is through the Root object.

Parameters

[in] _sdf The SDF Element pointer

Returns: Errors, which is a vector of Error objects. Each Error includes an error code and message. An empty vector indicates no error.

◆ MagnetometerSensor()

const Magnetometer* sdf::SDF_VERSION_NAMESPACE::Sensor::MagnetometerSensor ( ) const

Get the magnetometer sensor, or nullptr if this sensor type is not a Magnetometer.

Returns: Pointer to the Magnetometer sensor, or nullptr if this Sensor is not a Magnetometer.

See also: SensorType Type() const

◆ Name()

std::string sdf::SDF_VERSION_NAMESPACE::Sensor::Name ( ) const

Get the name of the sensor.

The name of the sensor should be unique within the scope of a World.

Returns: Name of the sensor.

◆ operator!=()

bool sdf::SDF_VERSION_NAMESPACE::Sensor::operator!= ( const Sensor & _sensor ) const

Return true this Sensor object does not contain the same values as the passed in parameter.

Parameters

◆ operator=() [1/2]

Sensor& sdf::SDF_VERSION_NAMESPACE::Sensor::operator= ( const Sensor & _sensor )

Assignment operator.

Parameters

[in] _sensor The sensor to set values from.

Returns: *this

◆ operator=() [2/2]

Sensor& sdf::SDF_VERSION_NAMESPACE::Sensor::operator= ( Sensor && _sensor )

Move assignment operator.

Parameters

[in] _sensor The sensor to set values from.

Returns: *this

◆ operator==()

bool sdf::SDF_VERSION_NAMESPACE::Sensor::operator== ( const Sensor & _sensor ) const

Return true if both Sensor objects contain the same values.

Parameters

◆ Pose()

const ignition::math::Pose3d& sdf::SDF_VERSION_NAMESPACE::Sensor::Pose ( ) const

Get the pose of the sensor.

This is the pose of the sensor as specified in SDF (<sensor> <pose> ... </pose></sensor>), and is typically used to express the position and rotation of a sensor in a global coordinate frame.

Returns: The pose of the sensor.

Deprecated:: See RawPose.

◆ PoseFrame()

const std::string& sdf::SDF_VERSION_NAMESPACE::Sensor::PoseFrame ( ) const

Get the name of the coordinate frame in which this sensor's pose is expressed.

A empty value indicates that the frame is the global/world coordinate frame.

Returns: The name of the pose frame.

Deprecated:: See PoseRelativeTo.

◆ PoseRelativeTo()

const std::string& sdf::SDF_VERSION_NAMESPACE::Sensor::PoseRelativeTo ( ) const

Get the name of the coordinate frame relative to which this object's pose is expressed.

An empty value indicates that the frame is relative to the parent link/joint coordinate frame.

Returns: The name of the pose relative-to frame.

◆ RawPose()

const ignition::math::Pose3d& sdf::SDF_VERSION_NAMESPACE::Sensor::RawPose ( ) const

Get the pose of the sensor.

This is the pose of the sensor as specified in SDF (<sensor> <pose> ... </pose></sensor>), and is typically used to express the position and rotation of a sensor in a global coordinate frame.

Returns: The pose of the sensor.

◆ SemanticPose()

sdf::SemanticPose sdf::SDF_VERSION_NAMESPACE::Sensor::SemanticPose ( ) const

Get SemanticPose object of this object to aid in resolving poses.

Returns: SemanticPose object for this link.

◆ SetAirPressureSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetAirPressureSensor ( const AirPressure & _air )

Set the air pressure sensor.

Parameters

[in] _air The air pressure sensor.

◆ SetAltimeterSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetAltimeterSensor ( const Altimeter & _alt )

Set the altimeter sensor.

Parameters

[in] _alt The altimeter sensor.

◆ SetCameraSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetCameraSensor ( const Camera & _cam )

Set the camera sensor.

Parameters

[in] _cam The camera sensor.

◆ SetImuSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetImuSensor ( const Imu & _imu )

Set the IMU sensor.

Parameters

[in] _imu The IMU sensor.

◆ SetLidarSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetLidarSensor ( const Lidar & _lidar )

Set the lidar sensor.

Parameters

[in] _lidar The lidar sensor.

◆ SetMagnetometerSensor()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetMagnetometerSensor ( const Magnetometer & _mag )

Set the magnetometer sensor.

Parameters

[in] _mag The magnetometer sensor.

◆ SetName()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetName ( const std::string & _name )

Set the name of the sensor.

The name of the sensor should be unique within the scope of a World.

Parameters

[in] _name Name of the sensor.

◆ SetPose()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetPose ( const ignition::math::Pose3d & _pose )

Set the pose of the sensor.

See also: const ignition::math::Pose3d &Pose() const

Parameters

[in] _pose The new sensor pose.

Deprecated:: See SetRawPose.

◆ SetPoseFrame()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetPoseFrame ( const std::string & _frame )

Set the name of the coordinate frame in which this sensor's pose is expressed.

A empty value indicates that the frame is the global/world coordinate frame.

Parameters

[in] _frame The name of the pose frame.

Deprecated:: See SetPoseRelativeTo.

◆ SetPoseRelativeTo()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetPoseRelativeTo ( const std::string & _frame )

Set the name of the coordinate frame relative to which this object's pose is expressed.

An empty value indicates that the frame is relative to the parent link/joint coordinate frame.

Parameters

[in] _frame The name of the pose relative-to frame.

◆ SetRawPose()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetRawPose ( const ignition::math::Pose3d & _pose )

Set the pose of the sensor.

See also: const ignition::math::Pose3d &RawPose() const

Parameters

[in] _pose The new sensor pose.

◆ SetTopic()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetTopic ( const std::string & _topic )

Set the topic on which sensor data should be published.

Parameters

[in] _topic Topic for this sensor's data.

◆ SetType() [1/2]

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetType ( const SensorType _type )

Set the sensor type.

Parameters

[in] _type The sensor type.

◆ SetType() [2/2]

bool sdf::SDF_VERSION_NAMESPACE::Sensor::SetType ( const std::string & _typeStr )

Set the sensor type from a string.

Parameters

[in] _typeStr The sensor type. A valid parameter should equal one of the enum value name in the SensorType enum. For example, "altimeter" or "camera".

Returns: True if the _typeStr parameter matched a known sensor type. False if the sensor type could not be set.

◆ SetUpdateRate()

void sdf::SDF_VERSION_NAMESPACE::Sensor::SetUpdateRate ( double _hz )

Set the update rate.

This is The frequency at which the sensor data is generated. If left unspecified (0.0), the sensor will generate data every cycle.

Parameters

[in] _rate The update rate in Hz.

◆ Topic()

std::string sdf::SDF_VERSION_NAMESPACE::Sensor::Topic ( ) const

Get the topic on which sensor data should be published.

Returns: Topic for this sensor's data.

◆ Type()

SensorType sdf::SDF_VERSION_NAMESPACE::Sensor::Type ( ) const

Get the sensor type.

Returns: The sensor type.

◆ TypeStr()

std::string sdf::SDF_VERSION_NAMESPACE::Sensor::TypeStr ( ) const

Get the sensor type as a string.

Returns: The sensor type as a string.

◆ UpdateRate()

double sdf::SDF_VERSION_NAMESPACE::Sensor::UpdateRate ( ) const

Get the update rate in Hz.

This is The frequency at which the sensor data is generated. If left unspecified (0.0), the sensor will generate data every cycle.

Returns: The update rate in Hz.

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

Sensor.hh

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Sensor() [1/3]

◆ Sensor() [2/3]

◆ Sensor() [3/3]

◆ ~Sensor()

Member Function Documentation

◆ AirPressureSensor()

◆ AltimeterSensor()

◆ CameraSensor()

◆ Element()

◆ ImuSensor()

◆ LidarSensor()

◆ Load()

◆ MagnetometerSensor()

◆ Name()

◆ operator!=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ Pose()

◆ PoseFrame()

◆ PoseRelativeTo()

◆ RawPose()

◆ SemanticPose()

◆ SetAirPressureSensor()

◆ SetAltimeterSensor()

◆ SetCameraSensor()

◆ SetImuSensor()

◆ SetLidarSensor()

◆ SetMagnetometerSensor()

◆ SetName()

◆ SetPose()

◆ SetPoseFrame()

◆ SetPoseRelativeTo()

◆ SetRawPose()

◆ SetTopic()

◆ SetType() [1/2]

◆ SetType() [2/2]

◆ SetUpdateRate()

◆ Topic()

◆ Type()

◆ TypeStr()

◆ UpdateRate()