class mrpt::obs::CObservationRange¶

Declares a class derived from “CObservation” that encapsules a single range measurement, and associated parameters.

This can be used for example to store measurements from infrared proximity sensors (IR) or ultrasonic sensors (sonars).

See also:

#include <mrpt/obs/CObservationRange.h>

class CObservationRange: public mrpt::obs::CObservation
{
public:
    // typedefs

    typedef std::deque<TMeasurement> TMeasurementList;
    typedef std::deque<TMeasurement>::const_iterator const_iterator;
    typedef std::deque<TMeasurement>::iterator iterator;

    // structs

    struct TMeasurement;

    //
fields

    float minSensorDistance {0};
    float maxSensorDistance {5};
    float sensorConeApperture = mrpt::d2f(20.0_deg);
    TMeasurementList sensedData;

    //
methods

    iterator begin();
    iterator end();
    const_iterator begin() const;
    const_iterator end() const;
    virtual void getSensorPose(mrpt::poses::CPose3D& out_sensorPose) const;
    virtual void setSensorPose(const mrpt::poses::CPose3D& newSensorPose);
    virtual void getDescriptionAsText(std::ostream& o) const;
};

Inherited Members¶

public:
    //
fields

    mrpt::system::TTimeStamp timestamp {mrpt::system::now()};
    std::string sensorLabel;

    //
methods

    mrpt::system::TTimeStamp getTimeStamp() const;
    virtual mrpt::system::TTimeStamp getOriginalReceivedTimeStamp() const;
    virtual void load() const;
    virtual void unload();

    template <class METRICMAP>
    bool insertObservationInto(
        METRICMAP* theMap,
        const mrpt::poses::CPose3D* robotPose = nullptr
        ) const;

    virtual void getSensorPose(mrpt::poses::CPose3D& out_sensorPose) const = 0;
    void getSensorPose(mrpt::math::TPose3D& out_sensorPose) const;
    virtual void setSensorPose(const mrpt::poses::CPose3D& newSensorPose) = 0;
    void setSensorPose(const mrpt::math::TPose3D& newSensorPose);
    virtual void getDescriptionAsText(std::ostream& o) const;
    std::string getDescriptionAsTextValue() const;

Fields¶

float minSensorDistance {0}

The data members.

float sensorConeApperture = mrpt::d2f(20.0_deg)

Cone aperture of each ultrasonic beam, in radians.

TMeasurementList sensedData

All the measurements.

Methods¶

virtual void getSensorPose(mrpt::poses::CPose3D& out_sensorPose) const

A general method to retrieve the sensor pose on the robot.

Note that most sensors will return a full (6D) CPose3D, but see the derived classes for more details or special cases.