Main MRPT website > C++ reference for MRPT 1.4.0
List of all members | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Private Member Functions | Private Attributes
mrpt::pbmap::Plane Class Reference

Detailed Description

A class used to store a planar feature (Plane for short).

It is described with geometric features representing the shape and relative location of the patch (area, normal vector, elongation, 3D-convex hull, etc.) and radiometric features (the most representative color).

Definition at line 48 of file Plane.h.

#include <mrpt/pbmap/Plane.h>

Inheritance diagram for mrpt::pbmap::Plane:
Inheritance graph

Public Member Functions

void * operator new (size_t size)
 
void * operator new[] (size_t size)
 
void operator delete (void *ptr) throw ()
 
void operator delete[] (void *ptr) throw ()
 
void operator delete (void *memory, void *ptr) throw ()
 
void * operator new (size_t size, const std::nothrow_t &) throw ()
 
void operator delete (void *ptr, const std::nothrow_t &) throw ()
 
 Plane ()
 
void forcePtsLayOnPlane ()
 
void calcConvexHull (pcl::PointCloud< pcl::PointXYZRGBA >::Ptr &pointCloud, std::vector< size_t > &indices=DEFAULT_VECTOR)
 ! Calculate the plane's convex hull with the monotone chain algorithm. More...
 
void calcConvexHullandParams (pcl::PointCloud< pcl::PointXYZRGBA >::Ptr &pointCloud, std::vector< size_t > &indices=DEFAULT_VECTOR)
 
float compute2DPolygonalArea ()
 Compute the area of a 2D planar polygon patch - using a given normal. More...
 
void computeMassCenterAndArea ()
 Compute the patch's convex-hull area and mass center. More...
 
void calcElongationAndPpalDir ()
 
bool isPlaneNearby (Plane &plane, const float distThreshold)
 
bool isSamePlane (Plane &plane, const float &cosAngleThreshold, const float &distThreshold, const float &proxThreshold)
 
bool isSamePlane (Eigen::Matrix4f &Rt, Plane &plane_, const float &cosAngleThreshold, const float &distThreshold, const float &proxThreshold)
 
bool hasSimilarDominantColor (Plane &plane, const float colorThreshold)
 
void mergePlane (Plane &plane)
 
void mergePlane2 (Plane &plane)
 
void transform (Eigen::Matrix4f &Rt)
 
void calcMainColor ()
 
void calcMainColor2 ()
 
void calcPlaneHistH ()
 
virtual mxArraywriteToMatlab () const
 Introduces a pure virtual method responsible for writing to a mxArray Matlab object, typically a MATLAB struct whose contents are documented in each derived class. More...
 
mrpt::utils::CObjectPtr duplicateGetSmartPtr () const
 Returns a copy of the object, indepently of its class, as a smart pointer (the newly created object will exist as long as any copy of this smart pointer). More...
 
CObject * clone () const
 Cloning interface for smart pointers. More...
 

Static Public Member Functions

static void * operator new (size_t size, void *ptr)
 

Public Attributes

unsigned id
 ! Parameters to allow the plane-based representation of the map by a graph More...
 
unsigned numObservations
 
unsigned semanticGroup
 
std::set< unsigned > nearbyPlanes
 
std::map< unsigned, unsigned > neighborPlanes
 
std::string label
 
std::string label_object
 
std::string label_context
 
Eigen::Vector3f v3center
 ! Geometric description More...
 
Eigen::Vector3f v3normal
 
float d
 
Eigen::Matrix4f information
 
float curvature
 
Eigen::Vector3f v3PpalDir
 
float elongation
 
float areaVoxels
 
float areaHull
 
bool bFullExtent
 
bool bFromStructure
 
unsigned nFramesAreaIsStable
 
Eigen::Vector3f v3colorNrgb
 ! Radiometric description More...
 
float dominantIntensity
 
bool bDominantColor
 
Eigen::Vector3f v3colorNrgbDev
 
Eigen::Vector3f v3colorC1C2C3
 
std::vector< float > hist_H
 
std::vector< double > prog_area
 
std::vector< double > prog_elongation
 
std::vector< Eigen::Vector3f > prog_C1C2C3
 
std::vector< Eigen::Vector3f > prog_Nrgb
 
std::vector< float > prog_intensity
 
std::vector< std::vector< float > > prog_hist_H
 
std::vector< int32_t > inliers
 ! Convex Hull More...
 
pcl::PointCloud< pcl::PointXYZRGBA >::Ptr polygonContourPtr
 
pcl::PointCloud< pcl::PointXYZRGBA >::Ptr outerPolygonPtr
 
pcl::PointCloud< pcl::PointXYZRGBA >::Ptr planePointCloudPtr
 

Static Public Attributes

static const mrpt::utils::TRuntimeClassId classCObject
 
RTTI stuff
static const mrpt::utils::TRuntimeClassId classCSerializable
 

Protected Member Functions

CSerializable virtual methods
void writeToStream (mrpt::utils::CStream &out, int *getVersion) const
 Introduces a pure virtual method responsible for writing to a CStream. More...
 
void readFromStream (mrpt::utils::CStream &in, int version)
 Introduces a pure virtual method responsible for loading from a CStream This can not be used directly be users, instead use "stream >> object;" for reading it from a stream or "stream >> object_ptr;" if the class is unknown apriori. More...
 

Private Member Functions

void getPlaneNrgb ()
 
void getPlaneC1C2C3 ()
 

Private Attributes

std::vector< float > r
 
std::vector< float > g
 
std::vector< float > b
 
std::vector< float > intensity
 
std::vector< float > c1
 
std::vector< float > c2
 
std::vector< float > c3
 

RTTI stuff

typedef PlanePtr SmartPtr
 
static mrpt::utils::CLASSINIT _init_Plane
 
static mrpt::utils::TRuntimeClassId classPlane
 
static const mrpt::utils::TRuntimeClassIdclassinfo
 
static const mrpt::utils::TRuntimeClassId_GetBaseClass ()
 
virtual const mrpt::utils::TRuntimeClassIdGetRuntimeClass () const
 Returns information about the class of an object in runtime. More...
 
virtual mrpt::utils::CObjectduplicate () const
 Returns a copy of the object, indepently of its class. More...
 
static mrpt::utils::CObjectCreateObject ()
 
static PlanePtr Create ()
 

Member Typedef Documentation

typedef PlanePtr mrpt::pbmap::Plane::SmartPtr

A typedef for the associated smart pointer

Definition at line 51 of file Plane.h.

Constructor & Destructor Documentation

mrpt::pbmap::Plane::Plane ( )
inline

Definition at line 54 of file Plane.h.

Member Function Documentation

static const mrpt::utils::TRuntimeClassId* mrpt::pbmap::Plane::_GetBaseClass ( )
staticprotected
void mrpt::pbmap::Plane::calcConvexHull ( pcl::PointCloud< pcl::PointXYZRGBA >::Ptr &  pointCloud,
std::vector< size_t > &  indices = DEFAULT_VECTOR 
)

! Calculate the plane's convex hull with the monotone chain algorithm.

void mrpt::pbmap::Plane::calcConvexHullandParams ( pcl::PointCloud< pcl::PointXYZRGBA >::Ptr &  pointCloud,
std::vector< size_t > &  indices = DEFAULT_VECTOR 
)
void mrpt::pbmap::Plane::calcElongationAndPpalDir ( )

Calculate plane's elongation and principal direction

void mrpt::pbmap::Plane::calcMainColor ( )

Calculate plane's main color using "MeanShift" method

void mrpt::pbmap::Plane::calcMainColor2 ( )
void mrpt::pbmap::Plane::calcPlaneHistH ( )
CObject* mrpt::utils::CObject::clone ( ) const
inlineinherited

Cloning interface for smart pointers.

Definition at line 139 of file CObject.h.

float mrpt::pbmap::Plane::compute2DPolygonalArea ( )

Compute the area of a 2D planar polygon patch - using a given normal.

Parameters
polygonContourPtrthe point cloud (planar)
normalthe plane normal
void mrpt::pbmap::Plane::computeMassCenterAndArea ( )

Compute the patch's convex-hull area and mass center.

static PlanePtr mrpt::pbmap::Plane::Create ( )
static
static mrpt::utils::CObject* mrpt::pbmap::Plane::CreateObject ( )
static
virtual mrpt::utils::CObject* mrpt::pbmap::Plane::duplicate ( ) const
virtual

Returns a copy of the object, indepently of its class.

Implements mrpt::utils::CObject.

mrpt::utils::CObjectPtr mrpt::utils::CObject::duplicateGetSmartPtr ( ) const
inlineinherited

Returns a copy of the object, indepently of its class, as a smart pointer (the newly created object will exist as long as any copy of this smart pointer).

Definition at line 136 of file CObject.h.

void mrpt::pbmap::Plane::forcePtsLayOnPlane ( )

Force the plane inliers to lay on the plane

void mrpt::pbmap::Plane::getPlaneC1C2C3 ( )
private
void mrpt::pbmap::Plane::getPlaneNrgb ( )
private

Calculate plane's main color in normalized rgb space

virtual const mrpt::utils::TRuntimeClassId* mrpt::pbmap::Plane::GetRuntimeClass ( ) const
virtual

Returns information about the class of an object in runtime.

Reimplemented from mrpt::utils::CSerializable.

bool mrpt::pbmap::Plane::hasSimilarDominantColor ( Plane plane,
const float  colorThreshold 
)
bool mrpt::pbmap::Plane::isPlaneNearby ( Plane plane,
const float  distThreshold 
)

Returns true when the closest distance between the patches "this" and "plane" is under distThreshold.

bool mrpt::pbmap::Plane::isSamePlane ( Plane plane,
const float &  cosAngleThreshold,
const float &  distThreshold,
const float &  proxThreshold 
)

Returns true if the two input planes represent the same physical surface for some given angle and distance thresholds. If the planes are the same they are merged in this and the function returns true. Otherwise it returns false.

bool mrpt::pbmap::Plane::isSamePlane ( Eigen::Matrix4f &  Rt,
Plane plane_,
const float &  cosAngleThreshold,
const float &  distThreshold,
const float &  proxThreshold 
)
void mrpt::pbmap::Plane::mergePlane ( Plane plane)

Merge the two input patches into "updatePlane". Recalculate center, normal vector, area, inlier points (filtered), convex hull, etc.

void mrpt::pbmap::Plane::mergePlane2 ( Plane plane)
void mrpt::pbmap::Plane::operator delete ( void *  ptr,
const std::nothrow_t &   
)
throw (
)
inline

Definition at line 51 of file Plane.h.

void mrpt::pbmap::Plane::operator delete ( void *  memory,
void *  ptr 
)
throw (
)
inline

Definition at line 51 of file Plane.h.

void mrpt::pbmap::Plane::operator delete ( void *  ptr)
throw (
)
inline

Definition at line 51 of file Plane.h.

void mrpt::pbmap::Plane::operator delete[] ( void *  ptr)
throw (
)
inline

Definition at line 51 of file Plane.h.

void* mrpt::pbmap::Plane::operator new ( size_t  size,
const std::nothrow_t &   
)
throw (
)
inline

Definition at line 51 of file Plane.h.

static void* mrpt::pbmap::Plane::operator new ( size_t  size,
void *  ptr 
)
inlinestatic

Definition at line 51 of file Plane.h.

void* mrpt::pbmap::Plane::operator new ( size_t  size)
inline

Definition at line 51 of file Plane.h.

void* mrpt::pbmap::Plane::operator new[] ( size_t  size)
inline

Definition at line 51 of file Plane.h.

void mrpt::pbmap::Plane::readFromStream ( mrpt::utils::CStream in,
int  version 
)
protectedvirtual

Introduces a pure virtual method responsible for loading from a CStream This can not be used directly be users, instead use "stream >> object;" for reading it from a stream or "stream >> object_ptr;" if the class is unknown apriori.

Parameters
inThe input binary stream where the object data must read from.
versionThe version of the object stored in the stream: use this version number in your code to know how to read the incoming data.
Exceptions
std::exceptionOn any error, see CStream::ReadBuffer
See also
CStream

Implements mrpt::utils::CSerializable.

void mrpt::pbmap::Plane::transform ( Eigen::Matrix4f &  Rt)
virtual mxArray* mrpt::utils::CSerializable::writeToMatlab ( ) const
inlinevirtualinherited

Introduces a pure virtual method responsible for writing to a mxArray Matlab object, typically a MATLAB struct whose contents are documented in each derived class.

Returns
A new mxArray (caller is responsible of memory freeing) or NULL is class does not support conversion to MATLAB.

Definition at line 79 of file CSerializable.h.

References BASE_IMPEXP, DEFINE_MRPT_OBJECT_POST, mrpt::utils::ObjectToOctetVector(), mrpt::utils::ObjectToRawString(), mrpt::utils::ObjectToString(), mrpt::utils::OctetVectorToObject(), mrpt::utils::RawStringToObject(), and mrpt::utils::StringToObject().

void mrpt::pbmap::Plane::writeToStream ( mrpt::utils::CStream out,
int *  getVersion 
) const
protectedvirtual

Introduces a pure virtual method responsible for writing to a CStream.

This can not be used directly be users, instead use "stream << object;" for writing it to a stream.

Parameters
outThe output binary stream where object must be dumped.
getVersionIf NULL, the object must be dumped. If not, only the version of the object dump must be returned in this pointer. This enables the versioning of objects dumping and backward compatibility with previously stored data.
Exceptions
std::exceptionOn any error, see CStream::WriteBuffer
See also
CStream

Implements mrpt::utils::CSerializable.

Member Data Documentation

mrpt::utils::CLASSINIT mrpt::pbmap::Plane::_init_Plane
staticprotected

Definition at line 51 of file Plane.h.

float mrpt::pbmap::Plane::areaHull

Definition at line 139 of file Plane.h.

float mrpt::pbmap::Plane::areaVoxels

Definition at line 138 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::b
private

Definition at line 185 of file Plane.h.

bool mrpt::pbmap::Plane::bDominantColor

Definition at line 149 of file Plane.h.

bool mrpt::pbmap::Plane::bFromStructure

Definition at line 141 of file Plane.h.

bool mrpt::pbmap::Plane::bFullExtent

Definition at line 140 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::c1
private

Calculate plane's main color in C1C2C3 representation

Definition at line 192 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::c2
private

Definition at line 193 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::c3
private

Definition at line 194 of file Plane.h.

const mrpt::utils::TRuntimeClassId mrpt::utils::CObject::classCObject
staticinherited

Definition at line 124 of file CObject.h.

const mrpt::utils::TRuntimeClassId mrpt::utils::CSerializable::classCSerializable
staticinherited

Definition at line 42 of file CSerializable.h.

const mrpt::utils::TRuntimeClassId* mrpt::pbmap::Plane::classinfo
static

Definition at line 51 of file Plane.h.

mrpt::utils::TRuntimeClassId mrpt::pbmap::Plane::classPlane
static

Definition at line 51 of file Plane.h.

float mrpt::pbmap::Plane::curvature

Definition at line 135 of file Plane.h.

float mrpt::pbmap::Plane::d

Definition at line 133 of file Plane.h.

float mrpt::pbmap::Plane::dominantIntensity

Definition at line 148 of file Plane.h.

float mrpt::pbmap::Plane::elongation

Definition at line 137 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::g
private

Definition at line 184 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::hist_H

Definition at line 153 of file Plane.h.

unsigned mrpt::pbmap::Plane::id

! Parameters to allow the plane-based representation of the map by a graph

Definition at line 117 of file Plane.h.

Eigen::Matrix4f mrpt::pbmap::Plane::information

Definition at line 134 of file Plane.h.

std::vector<int32_t> mrpt::pbmap::Plane::inliers

! Convex Hull

Definition at line 166 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::intensity
private

Definition at line 186 of file Plane.h.

std::string mrpt::pbmap::Plane::label

Labels to store semantic attributes

Definition at line 124 of file Plane.h.

std::string mrpt::pbmap::Plane::label_context

Definition at line 126 of file Plane.h.

std::string mrpt::pbmap::Plane::label_object

Definition at line 125 of file Plane.h.

std::set<unsigned> mrpt::pbmap::Plane::nearbyPlanes

Definition at line 120 of file Plane.h.

std::map<unsigned,unsigned> mrpt::pbmap::Plane::neighborPlanes

Definition at line 121 of file Plane.h.

unsigned mrpt::pbmap::Plane::nFramesAreaIsStable

Definition at line 142 of file Plane.h.

unsigned mrpt::pbmap::Plane::numObservations

Definition at line 118 of file Plane.h.

pcl::PointCloud<pcl::PointXYZRGBA>::Ptr mrpt::pbmap::Plane::outerPolygonPtr

Definition at line 168 of file Plane.h.

pcl::PointCloud<pcl::PointXYZRGBA>::Ptr mrpt::pbmap::Plane::planePointCloudPtr

Definition at line 169 of file Plane.h.

pcl::PointCloud<pcl::PointXYZRGBA>::Ptr mrpt::pbmap::Plane::polygonContourPtr

Definition at line 167 of file Plane.h.

std::vector<double> mrpt::pbmap::Plane::prog_area

Definition at line 155 of file Plane.h.

std::vector<Eigen::Vector3f> mrpt::pbmap::Plane::prog_C1C2C3

Definition at line 157 of file Plane.h.

std::vector<double> mrpt::pbmap::Plane::prog_elongation

Definition at line 156 of file Plane.h.

std::vector<std::vector<float> > mrpt::pbmap::Plane::prog_hist_H

Definition at line 160 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::prog_intensity

Definition at line 159 of file Plane.h.

std::vector<Eigen::Vector3f> mrpt::pbmap::Plane::prog_Nrgb

Definition at line 158 of file Plane.h.

std::vector<float> mrpt::pbmap::Plane::r
private

Definition at line 183 of file Plane.h.

unsigned mrpt::pbmap::Plane::semanticGroup

Definition at line 119 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3center

! Geometric description

Definition at line 131 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3colorC1C2C3

Definition at line 152 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3colorNrgb

! Radiometric description

Definition at line 147 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3colorNrgbDev

Definition at line 150 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3normal

Definition at line 132 of file Plane.h.

Eigen::Vector3f mrpt::pbmap::Plane::v3PpalDir

Definition at line 136 of file Plane.h.




Page generated by Doxygen 1.8.11 for MRPT 1.4.0 SVN:Unversioned directory at Mon Jul 4 10:31:07 UTC 2016