CSimplePointsMap.h

Go to the documentation of this file.

/* +------------------------------------------------------------------------+
   |                     Mobile Robot Programming Toolkit (MRPT)            |
   |                          https://www.mrpt.org/                         |
   |                                                                        |
   | Copyright (c) 2005-2019, Individual contributors, see AUTHORS file     |
   | See: https://www.mrpt.org/Authors - All rights reserved.               |
   | Released under BSD License. See: https://www.mrpt.org/License          |
   +------------------------------------------------------------------------+ */
#pragma once

#include <mrpt/maps/CPointsMap.h>
#include <mrpt/math/CMatrixF.h>
#include <mrpt/obs/obs_frwds.h>
#include <mrpt/serialization/CSerializable.h>

namespace mrpt
{
namespace maps
{
/** A cloud of points in 2D or 3D, which can be built from a sequence of laser
 * scans.
 *    This class only stores the coordinates (x,y,z) of each point.
 *
 *  See mrpt::maps::CPointsMap and derived classes for other point cloud
 * classes.
 *
 * \sa CMetricMap, CWeightedPointsMap, CPoint,
 * mrpt::serialization::CSerializable \ingroup mrpt_maps_grp
 */
class CSimplePointsMap : public CPointsMap
{
    DEFINE_SERIALIZABLE(CSimplePointsMap)

   public:
    /** Default constructor */
    CSimplePointsMap();
    CSimplePointsMap(const CPointsMap& o) : CSimplePointsMap()
    {
        CPointsMap::operator=(o);
    }
    CSimplePointsMap operator=(const CPointsMap& o)
    {
        CPointsMap::operator=(o);
        return *this;
    }

    // --------------------------------------------
    /** @name Pure virtual interfaces to be implemented by any class derived
       from CPointsMap
        @{ */
    void reserve(size_t newLength) override;  // See base class docs
    void resize(size_t newLength) override;  // See base class docs
    void setSize(size_t newLength) override;  // See base class docs
    /** The virtual method for \a insertPoint() *without* calling
     * mark_as_modified()   */
    void insertPointFast(float x, float y, float z = 0) override;
    /** Get all the data fields for one point as a vector: [X Y Z]
     *  Unlike getPointAllFields(), this method does not check for index out of
     * bounds
     * \sa getPointAllFields, setPointAllFields, setPointAllFieldsFast
     */
    void getPointAllFieldsFast(
        const size_t index, std::vector<float>& point_data) const override
    {
        point_data.resize(3);
        point_data[0] = m_x[index];
        point_data[1] = m_y[index];
        point_data[2] = m_z[index];
    }
    /** Set all the data fields for one point as a vector: [X Y Z]
     *  Unlike setPointAllFields(), this method does not check for index out of
     * bounds
     * \sa setPointAllFields, getPointAllFields, getPointAllFieldsFast
     */
    void setPointAllFieldsFast(
        const size_t index, const std::vector<float>& point_data) override
    {
        ASSERTDEB_(point_data.size() == 3);
        m_x[index] = point_data[0];
        m_y[index] = point_data[1];
        m_z[index] = point_data[2];
    }

    // See CPointsMap::loadFromRangeScan()
    void loadFromRangeScan(
        const mrpt::obs::CObservation2DRangeScan& rangeScan,
        const mrpt::poses::CPose3D* robotPose = nullptr) override;
    // See CPointsMap::loadFromRangeScan()
    void loadFromRangeScan(
        const mrpt::obs::CObservation3DRangeScan& rangeScan,
        const mrpt::poses::CPose3D* robotPose = nullptr) override;

   protected:
    void impl_copyFrom(const CPointsMap& obj) override;
    void addFrom_classSpecific(
        const CPointsMap& anotherMap, const size_t nPreviousPoints) override
    {
        MRPT_UNUSED_PARAM(anotherMap);
        MRPT_UNUSED_PARAM(nPreviousPoints);
        // No extra data.
    }

    // Friend methods:
    template <class Derived>
    friend struct detail::loadFromRangeImpl;
    template <class Derived>
    friend struct detail::pointmap_traits;

   public:
    /** @} */

    // See base docs
    const mrpt::maps::CSimplePointsMap* getAsSimplePointsMap() const override
    {
        return this;
    }

   protected:
    /** Clear the map, erasing all the points.
     */
    void internal_clear() override;

    /** @name PLY Import virtual methods to implement in base classes
        @{ */
    /** In a base class, reserve memory to prepare subsequent calls to
     * PLY_import_set_vertex */
    void PLY_import_set_vertex_count(const size_t N) override;
    /** @} */

    MAP_DEFINITION_START(CSimplePointsMap)
    /** Observations insertion options */
    mrpt::maps::CPointsMap::TInsertionOptions insertionOpts;
    /** Probabilistic observation likelihood options */
    mrpt::maps::CPointsMap::TLikelihoodOptions likelihoodOpts;
    /** Rendering as 3D object options */
    mrpt::maps::CPointsMap::TRenderOptions renderOpts;
    MAP_DEFINITION_END(CSimplePointsMap)
};  // End of class def.
}  // namespace maps

namespace opengl
{
/** Specialization mrpt::opengl::PointCloudAdapter<mrpt::maps::CSimplePointsMap>
 * \ingroup mrpt_adapters_grp*/
template <>
class PointCloudAdapter<mrpt::maps::CSimplePointsMap>
{
   private:
    mrpt::maps::CSimplePointsMap& m_obj;

   public:
    /** The type of each point XYZ coordinates */
    using coords_t = float;
    /** Has any color RGB info? */
    static constexpr bool HAS_RGB = false;
    /** Has native RGB info (as floats)? */
    static constexpr bool HAS_RGBf = false;
    /** Has native RGB info (as uint8_t)? */
    static constexpr bool HAS_RGBu8 = false;

    /** Constructor (accept a const ref for convenience) */
    inline PointCloudAdapter(const mrpt::maps::CSimplePointsMap& obj)
        : m_obj(*const_cast<mrpt::maps::CSimplePointsMap*>(&obj))
    {
    }
    /** Get number of points */
    inline size_t size() const { return m_obj.size(); }
    /** Set number of points (to uninitialized values) */
    inline void resize(const size_t N) { m_obj.resize(N); }
    /** Does nothing as of now */
    inline void setDimensions(const size_t& height, const size_t& width) {}
    /** Get XYZ coordinates of i'th point */
    template <typename T>
    inline void getPointXYZ(const size_t idx, T& x, T& y, T& z) const
    {
        m_obj.getPointFast(idx, x, y, z);
    }
    /** Set XYZ coordinates of i'th point */
    inline void setPointXYZ(
        const size_t idx, const coords_t x, const coords_t y, const coords_t z)
    {
        m_obj.setPointFast(idx, x, y, z);
    }

    /** Set XYZ coordinates of i'th point */
    inline void setInvalidPoint(const size_t idx)
    {
        THROW_EXCEPTION("mrpt::maps::CSimplePointsMap needs to be dense");
    }
};  // end of PointCloudAdapter<mrpt::maps::CPointsMap>
}  // namespace opengl

}  // namespace mrpt