GpuRaySensor Class Reference

GPU based laser sensor. More...

#include <sensors/sensors.hh>

Inherits Sensor.

Public Member Functions

 GpuRaySensor ()
 Constructor. More...
 
virtual ~GpuRaySensor ()
 Destructor. More...
 
ignition::math::Angle AngleMax () const
 Get the maximum angle. More...
 
ignition::math::Angle AngleMin () const
 Get the minimum angle. More...
 
double AngleResolution () const
 Get radians between each range. More...
 
unsigned int CameraCount () const
 Gets the camera count. More...
 
SensorCategory Category () const
 Get the category of the sensor. More...
 
event::ConnectionPtr ConnectNewLaserFrame (std::function< void(const float *, unsigned int, unsigned int, unsigned int, const std::string &)> _subscriber)
 Connect to the new laser frame event. More...
 
event::ConnectionPtr ConnectUpdated (std::function< void()> _subscriber)
 Connect a signal that is triggered when the sensor is updated. More...
 
double CosHorzFOV () const
 Get Cos Horz field-of-view. More...
 
double CosVertFOV () const
 Get Cos Vert field-of-view. More...
 
void DisconnectNewLaserFrame (event::ConnectionPtr &_conn)
 Disconnect Laser Frame. More...
 
void DisconnectUpdated (event::ConnectionPtr &_c)
 Disconnect from a the updated signal. More...
 
int Fiducial (const unsigned int _index) const
 Get detected fiducial value for a ray. More...
 
void FillMsg (msgs::Sensor &_msg)
 fills a msgs::Sensor message. More...
 
double GetAngleResolution () const GAZEBO_DEPRECATED(7.0)
 Get radians between each range. More...
 
unsigned int GetCameraCount () const GAZEBO_DEPRECATED(7.0)
 Gets the camera count. More...
 
SensorCategory GetCategory () const GAZEBO_DEPRECATED(7.0)
 Get the category of the sensor. More...
 
double GetCosHorzFOV () const GAZEBO_DEPRECATED(7.0)
 Get Cos Horz field-of-view. More...
 
double GetCosVertFOV () const GAZEBO_DEPRECATED(7.0)
 Get Cos Vert field-of-view. More...
 
int GetFiducial (int _index) const GAZEBO_DEPRECATED(7.0)
 Get detected fiducial value for a ray. More...
 
double GetHorzFOV () const GAZEBO_DEPRECATED(7.0)
 Get the horizontal field of view of the laser sensor. More...
 
double GetHorzHalfAngle () const GAZEBO_DEPRECATED(7.0)
 Get (horizontal_max_angle + horizontal_min_angle) * 0.5. More...
 
uint32_t GetId () const GAZEBO_DEPRECATED(7.0)
 Get the sensor's ID. More...
 
rendering::GpuLaserPtr GetLaserCamera () const GAZEBO_DEPRECATED(7.0)
 Returns a pointer to the internally kept rendering::GpuLaser. More...
 
common::Time GetLastMeasurementTime () GAZEBO_DEPRECATED(7.0)
 Return last measurement time. More...
 
common::Time GetLastUpdateTime () GAZEBO_DEPRECATED(7.0)
 Return last update time. More...
 
std::string GetName () const GAZEBO_DEPRECATED(7.0)
 Get name. More...
 
NoisePtr GetNoise (const SensorNoiseType _type) const GAZEBO_DEPRECATED(7.0)
 Get the sensor's noise model for a specified noise type. More...
 
uint32_t GetParentId () const GAZEBO_DEPRECATED(7.0)
 Get the sensor's parent's ID. More...
 
std::string GetParentName () const GAZEBO_DEPRECATED(7.0)
 Returns the name of the sensor parent. More...
 
double GetRange (int _index) GAZEBO_DEPRECATED(7.0)
 Get detected range for a ray. More...
 
int GetRangeCount () const GAZEBO_DEPRECATED(7.0)
 Get the range count. More...
 
double GetRangeCountRatio () const GAZEBO_DEPRECATED(7.0)
 Return the ratio of horizontal range count to vertical range count. More...
 
double GetRangeMax () const GAZEBO_DEPRECATED(7.0)
 Get the maximum range. More...
 
double GetRangeMin () const GAZEBO_DEPRECATED(7.0)
 Get the minimum range. More...
 
double GetRangeResolution () const GAZEBO_DEPRECATED(7.0)
 Get the range resolution If RangeResolution is 1, the number of simulated rays is equal to the number of returned range readings. More...
 
void GetRanges (std::vector< double > &_ranges) GAZEBO_DEPRECATED(7.0)
 Get all the ranges. More...
 
int GetRayCount () const GAZEBO_DEPRECATED(7.0)
 Get the ray count. More...
 
double GetRayCountRatio () const GAZEBO_DEPRECATED(7.0)
 Return the ratio of horizontal ray count to vertical ray count. More...
 
double GetRetro (int _index) const GAZEBO_DEPRECATED(7.0)
 Get detected retro (intensity) value for a ray. More...
 
std::string GetScopedName () const GAZEBO_DEPRECATED(7.0)
 Get fully scoped name of the sensor. More...
 
virtual std::string GetTopic () const GAZEBO_DEPRECATED(7.0)
 Returns the topic name as set in SDF. More...
 
std::string GetType () const GAZEBO_DEPRECATED(7.0)
 Get sensor type. More...
 
double GetUpdateRate () GAZEBO_DEPRECATED(7.0)
 Get the update rate of the sensor. More...
 
double GetVertFOV () const GAZEBO_DEPRECATED(7.0)
 Get the vertical field-of-view. More...
 
double GetVertHalfAngle () const GAZEBO_DEPRECATED(7.0)
 Get (vertical_max_angle + vertical_min_angle) * 0.5. More...
 
double GetVerticalAngleResolution () const GAZEBO_DEPRECATED(7.0)
 Get the vertical angle in radians between each range. More...
 
int GetVerticalRangeCount () const GAZEBO_DEPRECATED(7.0)
 Get the vertical scan line count. More...
 
int GetVerticalRayCount () const GAZEBO_DEPRECATED(7.0)
 Get the vertical scan line count. More...
 
bool GetVisualize () const GAZEBO_DEPRECATED(7.0)
 Return true if user requests the sensor to be visualized via tag: <visualize>true</visualize> in SDF. More...
 
std::string GetWorldName () const GAZEBO_DEPRECATED(7.0)
 Returns the name of the world the sensor is in. More...
 
double HorzFOV () const
 Get the horizontal field of view of the laser sensor. More...
 
double HorzHalfAngle () const
 Get (horizontal_max_angle + horizontal_min_angle) * 0.5. More...
 
uint32_t Id () const
 Get the sensor's ID. More...
 
virtual void Init ()
 Initialize the ray. More...
 
virtual bool IsActive () const
 Returns true if sensor generation is active. More...
 
bool IsHorizontal () const
 Gets if sensor is horizontal. More...
 
rendering::GpuLaserPtr LaserCamera () const
 Returns a pointer to the internally kept rendering::GpuLaser. More...
 
common::Time LastMeasurementTime () const
 Return last measurement time. More...
 
common::Time LastUpdateTime () const
 Return last update time. More...
 
virtual void Load (const std::string &_worldName, sdf::ElementPtr _sdf)
 Load the sensor with SDF parameters. More...
 
virtual void Load (const std::string &_worldName)
 Load the sensor with default parameters. More...
 
std::string Name () const
 Get name. More...
 
NoisePtr Noise (const SensorNoiseType _type) const
 Get the sensor's noise model for a specified noise type. More...
 
uint32_t ParentId () const
 Get the sensor's parent's ID. More...
 
std::string ParentName () const
 Returns the name of the sensor parent. More...
 
virtual ignition::math::Pose3d Pose () const
 Get the current pose. More...
 
double Range (const int _index) const
 Get detected range for a ray. More...
 
int RangeCount () const
 Get the range count. More...
 
double RangeCountRatio () const
 Return the ratio of horizontal range count to vertical range count. More...
 
double RangeMax () const
 Get the maximum range. More...
 
double RangeMin () const
 Get the minimum range. More...
 
double RangeResolution () const
 Get the range resolution If RangeResolution is 1, the number of simulated rays is equal to the number of returned range readings. More...
 
void Ranges (std::vector< double > &_ranges) const
 Get all the ranges. More...
 
int RayCount () const
 Get the ray count. More...
 
double RayCountRatio () const
 Return the ratio of horizontal ray count to vertical ray count. More...
 
void ResetLastUpdateTime ()
 Reset the lastUpdateTime to zero. More...
 
double Retro (const int _index) const
 Get detected retro (intensity) value for a ray. More...
 
std::string ScopedName () const
 Get fully scoped name of the sensor. More...
 
virtual void SetActive (const bool _value)
 Set whether the sensor is active or not. More...
 
void SetAngleMax (const double _angle)
 Set the scan maximum angle. More...
 
void SetAngleMin (const double _angle)
 Set the scan minimum angle. More...
 
void SetParent (const std::string &_name, const uint32_t _id)
 Set the sensor's parent. More...
 
virtual void SetPose (const ignition::math::Pose3d &_pose)
 Set the current pose. More...
 
void SetUpdateRate (const double _hz)
 Set the update rate of the sensor. More...
 
void SetVerticalAngleMax (const double _angle)
 Set the vertical scan line top angle. More...
 
void SetVerticalAngleMin (const double _angle)
 Set the vertical scan bottom angle. More...
 
virtual std::string Topic () const
 Returns the topic name as set in SDF. More...
 
std::string Type () const
 Get sensor type. More...
 
void Update (const bool _force)
 Update the sensor. More...
 
double UpdateRate () const
 Get the update rate of the sensor. More...
 
double VertFOV () const
 Get the vertical field-of-view. More...
 
double VertHalfAngle () const
 Get (vertical_max_angle + vertical_min_angle) * 0.5. More...
 
ignition::math::Angle VerticalAngleMax () const
 Get the vertical scan line top angle. More...
 
ignition::math::Angle VerticalAngleMin () const
 Get the vertical scan bottom angle. More...
 
double VerticalAngleResolution () const
 Get the vertical angle in radians between each range. More...
 
int VerticalRangeCount () const
 Get the vertical scan line count. More...
 
int VerticalRayCount () const
 Get the vertical scan line count. More...
 
bool Visualize () const
 Return true if user requests the sensor to be visualized via tag: <visualize>true</visualize> in SDF. More...
 
std::string WorldName () const
 Returns the name of the world the sensor is in. More...
 

Protected Member Functions

virtual void Fini ()
 Finalize the ray. More...
 
bool NeedsUpdate ()
 Return true if the sensor needs to be updated. More...
 
virtual bool UpdateImpl (const bool _force)
 This gets overwritten by derived sensor types. More...
 

Protected Attributes

bool active
 True if sensor generation is active. More...
 
std::vector< event::ConnectionPtrconnections
 All event connections. More...
 
common::Time lastMeasurementTime
 Stores last time that a sensor measurement was generated; this value must be updated within each sensor's UpdateImpl. More...
 
common::Time lastUpdateTime
 Time of the last update. More...
 
transport::NodePtr node
 Node for communication. More...
 
std::map< SensorNoiseType, NoisePtrnoises
 Noise added to sensor data. More...
 
uint32_t parentId
 The sensor's parent ID. More...
 
std::string parentName
 Name of the parent. More...
 
std::vector< SensorPluginPtrplugins
 All the plugins for the sensor. More...
 
ignition::math::Pose3d pose
 Pose of the sensor. More...
 
gazebo::rendering::ScenePtr scene
 Pointer to the Scene. More...
 
sdf::ElementPtr sdf
 Pointer the the SDF element for the sensor. More...
 
common::Time updatePeriod
 Desired time between updates, set indirectly by Sensor::SetUpdateRate. More...
 
gazebo::physics::WorldPtr world
 Pointer to the world. More...
 

Detailed Description

GPU based laser sensor.

This sensor cast rays into the world, tests for intersections, and reports the range to the nearest object. It is used by ranging sensor models (e.g., sonars and scanning laser range finders).

Constructor & Destructor Documentation

§ GpuRaySensor()

Constructor.

§ ~GpuRaySensor()

virtual ~GpuRaySensor ( )
virtual

Destructor.

Member Function Documentation

§ AngleMax()

ignition::math::Angle AngleMax ( ) const

Get the maximum angle.

Returns
the maximum angle

§ AngleMin()

ignition::math::Angle AngleMin ( ) const

Get the minimum angle.

Returns
The minimum angle

§ AngleResolution()

double AngleResolution ( ) const

Get radians between each range.

Returns
Return angle resolution

§ CameraCount()

unsigned int CameraCount ( ) const

Gets the camera count.

Returns
Number of cameras

§ Category()

SensorCategory Category ( ) const
inherited

Get the category of the sensor.

Returns
The category of the sensor.
See also
SensorCategory

§ ConnectNewLaserFrame()

event::ConnectionPtr ConnectNewLaserFrame ( std::function< void(const float *, unsigned int, unsigned int, unsigned int, const std::string &)>  _subscriber)

Connect to the new laser frame event.

Parameters
[in]_subscriberEvent callback.
Deprecated:
See ConnectNewLaserFrame that accepts a std::function.

§ ConnectUpdated()

event::ConnectionPtr ConnectUpdated ( std::function< void()>  _subscriber)
inherited

Connect a signal that is triggered when the sensor is updated.

Parameters
[in]_subscriberCallback that receives the signal.
Returns
A pointer to the connection. This must be kept in scope.
See also
Sensor::DisconnectUpdated

§ CosHorzFOV()

double CosHorzFOV ( ) const

Get Cos Horz field-of-view.

Returns
2 * atan(tan(this->hfov/2) / cos(this->vfov/2))

§ CosVertFOV()

double CosVertFOV ( ) const

Get Cos Vert field-of-view.

Returns
2 * atan(tan(this->vfov/2) / cos(this->hfov/2))

§ DisconnectNewLaserFrame()

void DisconnectNewLaserFrame ( event::ConnectionPtr _conn)

Disconnect Laser Frame.

Parameters
[in,out]_connConnection pointer to disconnect.

§ DisconnectUpdated()

void DisconnectUpdated ( event::ConnectionPtr _c)
inherited

Disconnect from a the updated signal.

Parameters
[in]_cThe connection to disconnect
See also
Sensor::ConnectUpdated

§ Fiducial()

int Fiducial ( const unsigned int  _index) const

Get detected fiducial value for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Fiducial value of ray

§ FillMsg()

void FillMsg ( msgs::Sensor &  _msg)
inherited

fills a msgs::Sensor message.

Parameters
[out]_msgMessage to fill.

§ Fini()

virtual void Fini ( )
protectedvirtual

Finalize the ray.

Reimplemented from Sensor.

§ GetAngleResolution()

double GetAngleResolution ( ) const

Get radians between each range.

Returns
Return angle resolution
Deprecated:
See AngleResolution()

§ GetCameraCount()

unsigned int GetCameraCount ( ) const

Gets the camera count.

Returns
Number of cameras
Deprecated:
See CameraCount()

§ GetCategory()

SensorCategory GetCategory ( ) const
inherited

Get the category of the sensor.

Returns
The category of the sensor.
See also
SensorCategory
Deprecated:
See Category() function.

§ GetCosHorzFOV()

double GetCosHorzFOV ( ) const

Get Cos Horz field-of-view.

Returns
2 * atan(tan(this->hfov/2) / cos(this->vfov/2))
Deprecated:
See CosHorzFOV

§ GetCosVertFOV()

double GetCosVertFOV ( ) const

Get Cos Vert field-of-view.

Returns
2 * atan(tan(this->vfov/2) / cos(this->hfov/2))
Deprecated:
See CosVertFOV.

§ GetFiducial()

int GetFiducial ( int  _index) const

Get detected fiducial value for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Fiducial value of ray
Deprecated:
See Fiducial(unsigned int _index)

§ GetHorzFOV()

double GetHorzFOV ( ) const

Get the horizontal field of view of the laser sensor.

Returns
The horizontal field of view of the laser sensor.
Deprecated:
See HorzFOV

§ GetHorzHalfAngle()

double GetHorzHalfAngle ( ) const

Get (horizontal_max_angle + horizontal_min_angle) * 0.5.

Returns
(horizontal_max_angle + horizontal_min_angle) * 0.5
Deprecated:
See HorzHalfAngle()

§ GetId()

uint32_t GetId ( ) const
inherited

Get the sensor's ID.

Returns
The sensor's ID.
Deprecated:
See Id() function

§ GetLaserCamera()

rendering::GpuLaserPtr GetLaserCamera ( ) const

Returns a pointer to the internally kept rendering::GpuLaser.

Returns
Pointer to GpuLaser See LaserCamera

§ GetLastMeasurementTime()

common::Time GetLastMeasurementTime ( )
inherited

Return last measurement time.

Returns
Time of last measurement.
Deprecated:
See LastMeasurementTime() function.

§ GetLastUpdateTime()

common::Time GetLastUpdateTime ( )
inherited

Return last update time.

Returns
Time of last update.
Deprecated:
See LastUpdateTime() function

§ GetName()

std::string GetName ( ) const
inherited

Get name.

Returns
Name of sensor.
Deprecated:
See Name() function.

§ GetNoise()

NoisePtr GetNoise ( const SensorNoiseType  _type) const
inherited

Get the sensor's noise model for a specified noise type.

Parameters
[in]_typeIndex of the noise type. Refer to SensorNoiseType enumeration for possible indices
Returns
The sensor's noise model for the given noise type
Deprecated:
See Noise(const SensorNoiseType _type) function

§ GetParentId()

uint32_t GetParentId ( ) const
inherited

Get the sensor's parent's ID.

Returns
The sensor's parent's ID.
Deprecated:
See ParentId() function

§ GetParentName()

std::string GetParentName ( ) const
inherited

Returns the name of the sensor parent.

The parent name is set by Sensor::SetParent.

Returns
Name of Parent.
Deprecated:
See ParentName() function.

§ GetRange()

double GetRange ( int  _index)

Get detected range for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Returns RangeMax for no detection.
Deprecated:
See Range(int _index)

§ GetRangeCount()

int GetRangeCount ( ) const

Get the range count.

Returns
The number of ranges
Deprecated:
See RangeCount

§ GetRangeCountRatio()

double GetRangeCountRatio ( ) const

Return the ratio of horizontal range count to vertical range count.

A ray count is the number of simulated rays. Whereas a range count is the total number of data points returned. When range count != ray count, then values are interpolated between rays.

Deprecated:
See RangeCountRatio

§ GetRangeMax()

double GetRangeMax ( ) const

Get the maximum range.

Returns
The maximum range
Deprecated:
See RangeMax

§ GetRangeMin()

double GetRangeMin ( ) const

Get the minimum range.

Returns
The minimum range
Deprecated:
See RangeMin

§ GetRangeResolution()

double GetRangeResolution ( ) const

Get the range resolution If RangeResolution is 1, the number of simulated rays is equal to the number of returned range readings.

If it's less than 1, fewer simulated rays than actual returned range readings are used, the results are interpolated from two nearest neighbors, and vice versa.

Returns
The Range Resolution
Deprecated:
See RangeResolution()

§ GetRanges()

void GetRanges ( std::vector< double > &  _ranges)

Get all the ranges.

Parameters
[out]_rangeA vector that will contain all the range data
Deprecated:
See Ranges(std::vector<double> &_ranges)

§ GetRayCount()

int GetRayCount ( ) const

Get the ray count.

Returns
The number of rays
Deprecated:
See RayCount

§ GetRayCountRatio()

double GetRayCountRatio ( ) const

Return the ratio of horizontal ray count to vertical ray count.

A ray count is the number of simulated rays. Whereas a range count is the total number of data points returned. When range count != ray count, then values are interpolated between rays.

Deprecated:
See RayCountRatio

§ GetRetro()

double GetRetro ( int  _index) const

Get detected retro (intensity) value for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Intensity value of ray
Deprecated:
See Retro(int _index)

§ GetScopedName()

std::string GetScopedName ( ) const
inherited

Get fully scoped name of the sensor.

Returns
world_name::model_name::link_name::sensor_name.
Deprecated:
See ScopedName() function

§ GetTopic()

virtual std::string GetTopic ( ) const
virtualinherited

Returns the topic name as set in SDF.

Returns
Topic name.
Deprecated:
See Topic() function.

Reimplemented in AltimeterSensor, LogicalCameraSensor, and MagnetometerSensor.

§ GetType()

std::string GetType ( ) const
inherited

Get sensor type.

Returns
Type of sensor.
Deprecated:
See Type() function.

§ GetUpdateRate()

double GetUpdateRate ( )
inherited

Get the update rate of the sensor.

Returns
_hz update rate of sensor. Returns 0 if unthrottled.
Deprecated:
See UpdateRate() function

§ GetVertFOV()

double GetVertFOV ( ) const

Get the vertical field-of-view.

Deprecated:
See VertFOV

§ GetVertHalfAngle()

double GetVertHalfAngle ( ) const

Get (vertical_max_angle + vertical_min_angle) * 0.5.

Returns
(vertical_max_angle + vertical_min_angle) * 0.5
Deprecated:
See VertHalfAngle

§ GetVerticalAngleResolution()

double GetVerticalAngleResolution ( ) const

Get the vertical angle in radians between each range.

Returns
Resolution of the angle
Deprecated:
See VerticalAngleResolution

§ GetVerticalRangeCount()

int GetVerticalRangeCount ( ) const

Get the vertical scan line count.

Returns
The number of scan lines vertically
Deprecated:
See VerticalRangeCount()

§ GetVerticalRayCount()

int GetVerticalRayCount ( ) const

Get the vertical scan line count.

Returns
The number of scan lines vertically
Deprecated:
See VerticalRayCount()

§ GetVisualize()

bool GetVisualize ( ) const
inherited

Return true if user requests the sensor to be visualized via tag: <visualize>true</visualize> in SDF.

Returns
True if visualized, false if not.
Deprecated:
See Visualize() function

§ GetWorldName()

std::string GetWorldName ( ) const
inherited

Returns the name of the world the sensor is in.

Returns
Name of the world.
Deprecated:
See WorldName() function.

§ HorzFOV()

double HorzFOV ( ) const

Get the horizontal field of view of the laser sensor.

Returns
The horizontal field of view of the laser sensor.

§ HorzHalfAngle()

double HorzHalfAngle ( ) const

Get (horizontal_max_angle + horizontal_min_angle) * 0.5.

Returns
(horizontal_max_angle + horizontal_min_angle) * 0.5

§ Id()

uint32_t Id ( ) const
inherited

Get the sensor's ID.

Returns
The sensor's ID.

§ Init()

virtual void Init ( )
virtual

Initialize the ray.

Reimplemented from Sensor.

§ IsActive()

virtual bool IsActive ( ) const
virtual

Returns true if sensor generation is active.

Returns
True if active, false if not.

Reimplemented from Sensor.

§ IsHorizontal()

bool IsHorizontal ( ) const

Gets if sensor is horizontal.

Returns
True if horizontal, false if not

§ LaserCamera()

rendering::GpuLaserPtr LaserCamera ( ) const

Returns a pointer to the internally kept rendering::GpuLaser.

Returns
Pointer to GpuLaser

§ LastMeasurementTime()

common::Time LastMeasurementTime ( ) const
inherited

Return last measurement time.

Returns
Time of last measurement.
Deprecated:
See LastMeasurementTime() function.

§ LastUpdateTime()

common::Time LastUpdateTime ( ) const
inherited

Return last update time.

Returns
Time of last update.

§ Load() [1/2]

virtual void Load ( const std::string &  _worldName,
sdf::ElementPtr  _sdf 
)
virtual

Load the sensor with SDF parameters.

Parameters
[in]_sdfSDF Sensor parameters
[in]_worldNameName of world to load from

Reimplemented from Sensor.

§ Load() [2/2]

virtual void Load ( const std::string &  _worldName)
virtual

Load the sensor with default parameters.

Parameters
[in]_worldNameName of world to load from

Reimplemented from Sensor.

§ Name()

std::string Name ( ) const
inherited

Get name.

Returns
Name of sensor.

§ NeedsUpdate()

bool NeedsUpdate ( )
protectedinherited

Return true if the sensor needs to be updated.

Returns
True when sensor should be updated.

§ Noise()

NoisePtr Noise ( const SensorNoiseType  _type) const
inherited

Get the sensor's noise model for a specified noise type.

Parameters
[in]_typeIndex of the noise type. Refer to SensorNoiseType enumeration for possible indices
Returns
The sensor's noise model for the given noise type

§ ParentId()

uint32_t ParentId ( ) const
inherited

Get the sensor's parent's ID.

Returns
The sensor's parent's ID.

§ ParentName()

std::string ParentName ( ) const
inherited

Returns the name of the sensor parent.

The parent name is set by Sensor::SetParent.

Returns
Name of Parent.

§ Pose()

virtual ignition::math::Pose3d Pose ( ) const
virtualinherited

Get the current pose.

Returns
Current pose of the sensor.
See also
SetPose()

§ Range()

double Range ( const int  _index) const

Get detected range for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Returns RangeMax for no detection.

§ RangeCount()

int RangeCount ( ) const

Get the range count.

Returns
The number of ranges

§ RangeCountRatio()

double RangeCountRatio ( ) const

Return the ratio of horizontal range count to vertical range count.

A ray count is the number of simulated rays. Whereas a range count is the total number of data points returned. When range count != ray count, then values are interpolated between rays.

§ RangeMax()

double RangeMax ( ) const

Get the maximum range.

Returns
The maximum range

§ RangeMin()

double RangeMin ( ) const

Get the minimum range.

Returns
The minimum range

§ RangeResolution()

double RangeResolution ( ) const

Get the range resolution If RangeResolution is 1, the number of simulated rays is equal to the number of returned range readings.

If it's less than 1, fewer simulated rays than actual returned range readings are used, the results are interpolated from two nearest neighbors, and vice versa.

Returns
The Range Resolution

§ Ranges()

void Ranges ( std::vector< double > &  _ranges) const

Get all the ranges.

Parameters
[out]_rangeA vector that will contain all the range data

§ RayCount()

int RayCount ( ) const

Get the ray count.

Returns
The number of rays

§ RayCountRatio()

double RayCountRatio ( ) const

Return the ratio of horizontal ray count to vertical ray count.

A ray count is the number of simulated rays. Whereas a range count is the total number of data points returned. When range count != ray count, then values are interpolated between rays.

§ ResetLastUpdateTime()

void ResetLastUpdateTime ( )
inherited

Reset the lastUpdateTime to zero.

§ Retro()

double Retro ( const int  _index) const

Get detected retro (intensity) value for a ray.

Warning: If you are accessing all the ray data in a loop it's possible that the Ray will update in the middle of your access loop. This means some data will come from one scan, and some from another scan. You can solve this problem by using SetActive(false) <your accessor="" loop>=""> SetActive(true).

Parameters
[in]_indexIndex of specific ray
Returns
Intensity value of ray

§ ScopedName()

std::string ScopedName ( ) const
inherited

Get fully scoped name of the sensor.

Returns
world_name::model_name::link_name::sensor_name.

§ SetActive()

virtual void SetActive ( const bool  _value)
virtualinherited

Set whether the sensor is active or not.

Parameters
[in]_valueTrue if active, false if not.

Reimplemented in DepthCameraSensor.

§ SetAngleMax()

void SetAngleMax ( const double  _angle)

Set the scan maximum angle.

Parameters
[in]_angleThe maximum angle

§ SetAngleMin()

void SetAngleMin ( const double  _angle)

Set the scan minimum angle.

Parameters
[in]_angleThe minimum angle

§ SetParent()

void SetParent ( const std::string &  _name,
const uint32_t  _id 
)
inherited

Set the sensor's parent.

Parameters
[in]_nameThe sensor's parent's name.
[in]_idThe sensor's parent's ID.

§ SetPose()

virtual void SetPose ( const ignition::math::Pose3d &  _pose)
virtualinherited

Set the current pose.

Parameters
[in]_poseNew pose of the sensor.
See also
Pose()

§ SetUpdateRate()

void SetUpdateRate ( const double  _hz)
inherited

Set the update rate of the sensor.

Parameters
[in]_hzupdate rate of sensor.

§ SetVerticalAngleMax()

void SetVerticalAngleMax ( const double  _angle)

Set the vertical scan line top angle.

Parameters
[in]_angleThe Maximum angle of the scan block

§ SetVerticalAngleMin()

void SetVerticalAngleMin ( const double  _angle)

Set the vertical scan bottom angle.

Parameters
[in]_angleThe minimum angle of the scan block

§ Topic()

virtual std::string Topic ( ) const
virtual

Returns the topic name as set in SDF.

Returns
Topic name.

Reimplemented from Sensor.

§ Type()

std::string Type ( ) const
inherited

Get sensor type.

Returns
Type of sensor.

§ Update()

void Update ( const bool  _force)
inherited

Update the sensor.

Parameters
[in]_forceTrue to force update, false otherwise.

§ UpdateImpl()

virtual bool UpdateImpl ( const bool  )
protectedvirtual

This gets overwritten by derived sensor types.

This function is called during Sensor::Update. And in turn, Sensor::Update is called by SensorManager::Update

Parameters
[in]_forceTrue if update is forced, false if not
Returns
True if the sensor was updated.

Reimplemented from Sensor.

§ UpdateRate()

double UpdateRate ( ) const
inherited

Get the update rate of the sensor.

Returns
_hz update rate of sensor. Returns 0 if unthrottled.

§ VertFOV()

double VertFOV ( ) const

Get the vertical field-of-view.

Returns
Vertical field of view.

§ VertHalfAngle()

double VertHalfAngle ( ) const

Get (vertical_max_angle + vertical_min_angle) * 0.5.

Returns
(vertical_max_angle + vertical_min_angle) * 0.5

§ VerticalAngleMax()

ignition::math::Angle VerticalAngleMax ( ) const

Get the vertical scan line top angle.

Returns
The Maximum angle of the scan block

§ VerticalAngleMin()

ignition::math::Angle VerticalAngleMin ( ) const

Get the vertical scan bottom angle.

Returns
The minimum angle of the scan block

§ VerticalAngleResolution()

double VerticalAngleResolution ( ) const

Get the vertical angle in radians between each range.

Returns
Resolution of the angle

§ VerticalRangeCount()

int VerticalRangeCount ( ) const

Get the vertical scan line count.

Returns
The number of scan lines vertically

§ VerticalRayCount()

int VerticalRayCount ( ) const

Get the vertical scan line count.

Returns
The number of scan lines vertically

§ Visualize()

bool Visualize ( ) const
inherited

Return true if user requests the sensor to be visualized via tag: <visualize>true</visualize> in SDF.

Returns
True if visualized, false if not.

§ WorldName()

std::string WorldName ( ) const
inherited

Returns the name of the world the sensor is in.

Returns
Name of the world.

Member Data Documentation

§ active

bool active
protectedinherited

True if sensor generation is active.

§ connections

std::vector<event::ConnectionPtr> connections
protectedinherited

All event connections.

§ lastMeasurementTime

common::Time lastMeasurementTime
protectedinherited

Stores last time that a sensor measurement was generated; this value must be updated within each sensor's UpdateImpl.

§ lastUpdateTime

common::Time lastUpdateTime
protectedinherited

Time of the last update.

§ node

transport::NodePtr node
protectedinherited

Node for communication.

§ noises

std::map<SensorNoiseType, NoisePtr> noises
protectedinherited

Noise added to sensor data.

§ parentId

uint32_t parentId
protectedinherited

The sensor's parent ID.

§ parentName

std::string parentName
protectedinherited

Name of the parent.

§ plugins

std::vector<SensorPluginPtr> plugins
protectedinherited

All the plugins for the sensor.

§ pose

ignition::math::Pose3d pose
protectedinherited

Pose of the sensor.

§ scene

gazebo::rendering::ScenePtr scene
protectedinherited

Pointer to the Scene.

§ sdf

sdf::ElementPtr sdf
protectedinherited

Pointer the the SDF element for the sensor.

§ updatePeriod

common::Time updatePeriod
protectedinherited

Desired time between updates, set indirectly by Sensor::SetUpdateRate.

§ world

gazebo::physics::WorldPtr world
protectedinherited

Pointer to the world.


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