32 CMetricMapBuilderICP::CMetricMapBuilderICP()
33 : ICP_options(m_min_verbosity_level)
35 this->setLoggerName(
"CMetricMapBuilderICP");
56 mrpt::utils::VerbosityLevel& parent_verbosity_level)
57 : matchAgainstTheGrid(false),
58 insertionLinDistance(1.0),
59 insertionAngDistance(
DEG2RAD(30)),
60 localizationLinDistance(0.20),
61 localizationAngDistance(
DEG2RAD(30)),
62 minICPgoodnessToAccept(0.40),
63 verbosity_level(parent_verbosity_level),
91 verbosity_level =
source.read_enum<mrpt::utils::VerbosityLevel>(
92 section,
"verbosity_level", verbosity_level);
96 mapInitializers.loadFromConfigFile(
source, section);
102 "\n----------- [CMetricMapBuilderICP::TConfigParams] ------------ " 106 "insertionLinDistance = %f m\n",
107 insertionLinDistance);
109 "insertionAngDistance = %f deg\n",
110 RAD2DEG(insertionAngDistance));
112 "localizationLinDistance = %f m\n",
113 localizationLinDistance);
115 "localizationAngDistance = %f deg\n",
116 RAD2DEG(localizationAngDistance));
118 "verbosity_level = %s\n",
123 out.
printf(
" Now showing 'mapsInitializers':\n");
124 mapInitializers.dumpToTextStream(out);
140 throw std::runtime_error(
141 "Neither grid maps nor points map: Have you called initialize() " 142 "after setting ICP_options.mapInitializers?");
149 MRPT_LOG_DEBUG(
"processObservation(): obs is CObservationOdometry");
161 odo->odometry, odo->timestamp, odo->hasVelocities,
164 if (pose_before_valid)
171 "processObservation(): obs is CObservationOdometry, new " 181 TPose2D initialEstimatedRobotPose(0, 0, 0);
187 "processObservation(): extrapolating pose from latest pose " 188 "and new observation timestamp...");
190 initialEstimatedRobotPose, robotVelLocal,
191 robotVelGlobal, obs->timestamp))
196 "processObservation(): new pose extrapolation failed, " 197 "using last pose as is.");
203 "processObservation(): invalid observation timestamp.");
209 CPose2D previousKnownRobotPose;
215 previousKnownRobotPose);
221 const bool we_skip_ICP_pose_correction =
231 "processObservation(): skipping ICP pose correction due to small " 232 "odometric displacement? : " 233 << (we_skip_ICP_pose_correction ?
"YES" :
"NO"));
236 bool can_do_icp =
false;
243 MRPT_LOG_DEBUG(
"processObservation(): matching against gridmap.");
249 "No points map in multi-metric map.")
252 MRPT_LOG_DEBUG(
"processObservation(): matching against point map.");
256 if (!we_skip_ICP_pose_correction)
284 ->insertionOptions.mapAltitude -
285 obsLaser->sensorPose.z()) < 0.01)
296 static_cast<CPointsMap*>(matchWith)->
empty())
314 initialEstimatedRobotPose),
335 "processObservation: previousPose=" 336 << previousKnownRobotPose <<
"-> currentPose=" 340 "[CMetricMapBuilderICP] Fit:%.1f%% Itr:%i In " 343 1000 * runningTime));
348 "Ignoring ICP of low quality: " 349 << icpReturn.
goodness * 100 << std::endl);
357 currentKnownRobotPose);
364 "Cannot do ICP: empty pointmap or not suitable " 376 const bool firstTimeForThisSensor =
380 firstTimeForThisSensor ||
397 if (matchWith && matchWith->
isEmpty()) update =
true;
400 "update map: " << (update ?
"YES" :
"NO")
401 <<
" options.enableMapUpdating: " 416 currentKnownRobotPose;
424 "Updating map from pose %s\n",
425 currentKnownRobotPose.
asString().c_str()));
427 CPose3D estimatedPose3D(currentKnownRobotPose);
428 const bool anymap_update =
432 "**No map was updated** after inserting an observation of " 434 << obs->GetRuntimeClass()->className <<
"`");
447 "Map updated OK. Done in " 480 mrpt::make_aligned_shared<CObservationOdometry>();
481 obs->timestamp = movEstimation->timestamp;
516 mrpt::make_aligned_shared<CPose3DPDFGaussian>();
517 pdf3D->copyFrom(pdf2D);
580 posePDF->getMean(estimatedPose3D);
583 SF->insertObservationsInto(&
metricMap, &estimatedPose3D);
595 std::vector<float>&
x, std::vector<float>&
y)
654 unsigned int imgHeight =
img.getHeight();
665 for (
size_t j = 0; j < nPoses; j++)
676 EMF.
line(x1, imgHeight - 1 - y1, x2, imgHeight - 1 - y2, TColor::black());
691 it->second.updateDistances(new_pose);
703 it->second.updatePose(new_pose);
710 ang = std::abs(Ap.
phi());
715 this->last_update =
p;
void saveCurrentMapToFile(const std::string &fileName, bool compressGZ=true) const
Save map (mrpt::maps::CSimpleMap) to a ".simplemap" file.
void copyFrom(const CPosePDF &o) override
Copy operator, translating if necesary (for example, between particles and gaussian representations) ...
EIGEN_STRONG_INLINE bool empty() const
double localizationAngDistance
Minimum robot angular (rad, deg when loaded from the .ini) displacement for a new observation to be u...
void updatePose(const mrpt::poses::CPose2D &p)
Classes for serialization, sockets, ini-file manipulation, streams, list of properties-values, timewatch, extensions to STL.
CPose2D mean
The mean value.
void asString(std::string &s) const
Returns a human-readable textual representation of the object (eg: "[x y yaw]", yaw in degrees) ...
mrpt::maps::TSetOfMetricMapInitializers mapInitializers
What maps to create (at least one points map and/or a grid map are needed).
mrpt::maps::CMultiMetricMap metricMap
The metric map representation as a points map:
std::string format(const char *fmt,...) MRPT_printf_format_check(1
A std::string version of C sprintf.
void dumpToTextStream(mrpt::utils::CStream &out) const override
This method should clearly display all the contents of the structure in textual form, sending it to a CStream.
ProxyFilterContainerByClass< mrpt::maps::CSimplePointsMap::Ptr, TListMaps > m_pointsMaps
STL-like proxy to access this kind of maps in maps.
mrpt::poses::CPose2D m_auxAccumOdometry
double minICPgoodnessToAccept
Minimum ICP goodness (0,1) to accept the resulting corrected position (default: 0.40)
void getCurrentMapPoints(std::vector< float > &x, std::vector< float > &y)
Returns the 2D points of current local map.
This class stores a sequence of <Probabilistic Pose,SensoryFrame> pairs, thus a "metric map" can be t...
std::shared_ptr< CPose3DPDFGaussian > Ptr
A class for storing images as grayscale or RGB bitmaps.
mrpt::poses::CPosePDF::Ptr Align(const mrpt::maps::CMetricMap *m1, const mrpt::maps::CMetricMap *m2, const mrpt::poses::CPose2D &grossEst, float *runningTime=nullptr, void *info=nullptr)
The method for aligning a pair of metric maps, aligning only 2D + orientation.
Several implementations of ICP (Iterative closest point) algorithms for aligning two point maps or a ...
#define THROW_EXCEPTION(msg)
bool contains(const mrpt::utils::TRuntimeClassId *id) const
Does the list contains this class?
TDATA getMeanVal() const
Returns the mean, or mathematical expectation of the probability density distribution (PDF)...
std::deque< mrpt::math::TPose2D > m_estRobotPath
The estimated robot path:
void leaveCriticalSection()
Leave critical section for map updating.
virtual ~CMetricMapBuilderICP()
Destructor:
bool getLatestRobotPose(mrpt::math::TPose2D &pose) const
Get the latest known robot pose, either from odometry or localization.
bool enableMapUpdating
Enable map updating, default is true.
mrpt::system::TTimeStamp now()
A shortcut for system::getCurrentTime.
A cloud of points in 2D or 3D, which can be built from a sequence of laser scans. ...
std::string formatTimeInterval(const double timeSeconds)
Returns a formated string with the given time difference (passed as the number of seconds)...
std::shared_ptr< CObservation2DRangeScan > Ptr
mrpt::maps::CSimpleMap SF_Poses_seq
The set of observations that leads to current map:
TConfigParams options
The options employed by the ICP align.
void Tic()
Starts the stopwatch.
TConfigParams ICP_options
Options for the ICP-SLAM application.
double insertionAngDistance
Minimum robot angular (rad, deg when loaded from the .ini) displacement for a new observation to be i...
Helper types for STL containers with Eigen memory allocators.
void initialize(const mrpt::maps::CSimpleMap &initialMap=mrpt::maps::CSimpleMap(), const mrpt::poses::CPosePDF *x0=nullptr) override
Initialize the method, starting with a known location PDF "x0"(if supplied, set to nullptr to left un...
mrpt::math::CMatrixDouble33 cov
The 3x3 covariance matrix.
Declares a class for storing a collection of robot actions.
void reset()
Resets all internal state.
std::shared_ptr< CObservationOdometry > Ptr
bool matchAgainstTheGrid
(default:false) Match against the occupancy grid or the points map? The former is quicker but less pr...
void updateDistances(const mrpt::poses::CPose2D &p)
This class allows loading and storing values and vectors of different types from a configuration text...
void enterCriticalSection()
Enter critical section for map updating.
2D twist: 2D velocity vector (vx,vy) + planar angular velocity (omega)
const_iterator begin() const
Returns a constant iterator to the first observation: this is an example of usage: ...
CICP::TConfigParams ICP_params
Options for the ICP algorithm itself.
#define IS_DERIVED(ptrObj, class_name)
Evaluates to true if the given pointer to an object (derived from mrpt::utils::CSerializable) is an i...
float goodness
A goodness measure for the alignment, it is a [0,1] range indicator of percentage of correspondences...
This base class is used to provide a unified interface to files,memory buffers,..Please see the deriv...
A cloud of points in 2D or 3D, which can be built from a sequence of laser scans or other sensors...
This base provides a set of functions for maths stuff.
std::shared_ptr< CPosePDF > Ptr
Declares a class that represents a Probability Density function (PDF) of a 2D pose ...
std::shared_ptr< CActionRobotMovement2D > Ptr
CActionRobotMovement2D::Ptr getBestMovementEstimation() const
Returns the best pose increment estimator in the collection, based on the determinant of its pose cha...
TConfigParams & operator=(const TConfigParams &other)
void processUpdateNewPoseLocalization(const mrpt::math::TPose2D &newPose, mrpt::system::TTimeStamp tim)
Updates the filter with new global-coordinates localization data from a localization or SLAM source...
double norm() const
Returns the euclidean norm of vector: .
#define MRPT_LOG_WARN(_STRING)
std::string currentMapFile
Current map file.
A helper class that can convert an enum value into its textual representation, and viceversa...
TConfigParams(mrpt::utils::VerbosityLevel &parent_verbosity_level)
Initializer.
#define MRPT_LOG_INFO(_STRING)
const mrpt::maps::CMultiMetricMap * getCurrentlyBuiltMetricMap() const override
Returns the map built so far.
This class implements a high-performance stopwatch.
mrpt::utils::CListOfClasses alwaysInsertByClass
A list of observation classes (derived from mrpt::obs::CObservation) which will be always inserted in...
std::shared_ptr< CPose3DPDF > Ptr
This namespace contains representation of robot actions and observations.
Declares a class for storing a "sensory frame", a set of "observations" taken by the robot approximat...
std::string format(const char *fmt,...) MRPT_printf_format_check(1
A std::string version of C sprintf.
std::shared_ptr< CSensoryFrame > Ptr
ProxyFilterContainerByClass< mrpt::maps::COccupancyGridMap2D::Ptr, TListMaps > m_gridMaps
STL-like proxy to access this kind of maps in maps.
#define MRPT_LOG_WARN_STREAM(__CONTENTS)
#define MRPT_LOG_DEBUG(_STRING)
void resetRobotDisplacementCounters(const mrpt::poses::CPose2D &new_pose)
size_t size() const
Returns the count of pairs (pose,sensory data)
std::shared_ptr< CObservation > Ptr
void loadCurrentMapFromFile(const std::string &fileName)
Load map (mrpt::maps::CSimpleMap) from a ".simplemap" file.
void get(size_t index, mrpt::poses::CPose3DPDF::Ptr &out_posePDF, mrpt::obs::CSensoryFrame::Ptr &out_SF) const
Access to the i'th pair, first one is index '0'.
unsigned short nIterations
The number of executed iterations until convergence.
GLsizei const GLchar ** string
Declares a class that represents a probability density function (pdf) of a 2D pose (x...
Classes for 2D/3D geometry representation, both of single values and probability density distribution...
#define INVALID_TIMESTAMP
Represents an invalid timestamp, where applicable.
void setCurrentMapFile(const char *mapFile)
Sets the "current map file", thus that map will be loaded if it exists or a new one will be created i...
mrpt::aligned_containers< std::string, TDist >::map_t m_distSinceLastInsertion
Indexed by sensor label.
void processUpdateNewOdometry(const mrpt::math::TPose2D &newGlobalOdometry, mrpt::system::TTimeStamp cur_tim, bool hasVelocities=false, const mrpt::math::TTwist2D &newRobotVelLocal=mrpt::math::TTwist2D())
Updates the filter with new odometry readings.
bool also_interpolate
If set to true, far points (<1m) are interpolated with samples at "minDistSqrBetweenLaserPoints" inte...
mrpt::poses::CRobot2DPoseEstimator m_lastPoseEst
The pose estimation by the alignment algorithm (ICP).
A "CObservation"-derived class that represents a 2D range scan measurement (typically from a laser sc...
#define MRPT_LOG_INFO_STREAM(__CONTENTS)
Declares a virtual base class for all metric maps storage classes.
A class used to store a 2D pose, including the 2D coordinate point and a heading (phi) angle...
A class used to store a 3D pose (a 3D translation + a rotation in 3D).
void setListOfMaps(const mrpt::maps::TSetOfMetricMapInitializers *initializers)
Sets the list of internal map according to the passed list of map initializers (Current maps' content...
bool getCurrentEstimate(mrpt::math::TPose2D &pose, mrpt::math::TTwist2D &velLocal, mrpt::math::TTwist2D &velGlobal, mrpt::system::TTimeStamp tim_query=mrpt::system::now()) const
Get the estimate for a given timestamp (defaults to now()), obtained as:
const double & phi() const
Get the phi angle of the 2D pose (in radians)
#define IS_CLASS(ptrObj, class_name)
Evaluates to true if the given pointer to an object (derived from mrpt::utils::CSerializable) is of t...
void composeFrom(const CPose2D &A, const CPose2D &B)
Makes .
The ICP algorithm return information.
bool insertObservationPtr(const mrpt::obs::CObservation::Ptr &obs, const mrpt::poses::CPose3D *robotPose=NULL)
A wrapper for smart pointers, just calls the non-smart pointer version.
double Tac()
Stops the stopwatch.
GLsizei GLsizei GLchar * source
void processObservation(const mrpt::obs::CObservation::Ptr &obs)
The main method of this class: Process one odometry or sensor observation.
void getCurrentlyBuiltMap(mrpt::maps::CSimpleMap &out_map) const override
Fills "out_map" with the set of "poses"-"sensory-frames", thus the so far built map.
mrpt::math::CMatrixDouble33 m_lastPoseEst_cov
Last pose estimation (covariance)
double localizationLinDistance
Minimum robot linear (m) displacement for a new observation to be used to do ICP-based localization (...
Algorithm configuration params.
TInsertionOptions insertionOptions
The options used when inserting observations in the map.
mrpt::poses::CPose3DPDF::Ptr getCurrentPoseEstimation() const override
Returns a copy of the current best pose estimation as a pose PDF.
std::deque< CObservation::Ptr >::iterator iterator
You can use CSensoryFrame::begin to get a iterator to the first element.
#define MRPT_LOAD_CONFIG_VAR_DEGREES( variableName, configFileObject, sectionNameStr)
Loads a double variable, stored as radians but entered in the INI-file as degrees.
bool m_there_has_been_an_odometry
An observation of the current (cumulative) odometry for a wheeled robot.
#define MRPT_LOAD_CONFIG_VAR( variableName, variableType, configFileObject, sectionNameStr)
An useful macro for loading variables stored in a INI-like file under a key with the same name that t...
const_iterator end() const
Returns a constant iterator to the end of the list of observations: this is an example of usage: ...
This class stores any customizable set of metric maps.
void insert(const mrpt::poses::CPose3DPDF *in_posePDF, const mrpt::obs::CSensoryFrame &in_SF)
Add a new pair to the sequence.
void loadFromConfigFile(const mrpt::utils::CConfigFileBase &source, const std::string §ion) override
This method load the options from a ".ini"-like file or memory-stored string list.
#define MRPT_LOG_DEBUG_STREAM(__CONTENTS)
#define ASSERTMSG_(f, __ERROR_MSG)
virtual bool isEmpty() const =0
Returns true if the map is empty/no observation has been inserted.
unsigned int getCurrentlyBuiltMapSize() override
Returns just how many sensory-frames are stored in the currently build map.
std::mutex critZoneChangingMap
Critical zones.
void processActionObservation(mrpt::obs::CActionCollection &action, mrpt::obs::CSensoryFrame &in_SF) override
Appends a new action and observations to update this map: See the description of the class at the top...
double insertionLinDistance
Minimum robot linear (m) displacement for a new observation to be inserted in the map...
virtual int printf(const char *fmt,...) MRPT_printf_format_check(2
Writes a string to the stream in a textual form.
void saveCurrentEstimationToImage(const std::string &file, bool formatEMF_BMP=true) override
A useful method for debugging: the current map (and/or poses) estimation is dumped to an image file...
float minDistBetweenLaserPoints
The minimum distance between points (in 3D): If two points are too close, one of them is not inserted...
void accumulateRobotDisplacementCounters(const mrpt::poses::CPose2D &new_pose)
Traveled distances from last map update / ICP-based localization.