MRPT  1.9.9
CMetricMapBuilderICP.cpp
Go to the documentation of this file.
1 /* +------------------------------------------------------------------------+
2  | Mobile Robot Programming Toolkit (MRPT) |
3  | http://www.mrpt.org/ |
4  | |
5  | Copyright (c) 2005-2018, Individual contributors, see AUTHORS file |
6  | See: http://www.mrpt.org/Authors - All rights reserved. |
7  | Released under BSD License. See details in http://www.mrpt.org/License |
8  +------------------------------------------------------------------------+ */
9 
10 #include "slam-precomp.h" // Precompiled headers
11 
12 #include <mrpt/slam/CICP.h>
18 #include <mrpt/system/CTicTac.h>
20 
21 using namespace std;
22 using namespace mrpt::slam;
23 using namespace mrpt::obs;
24 using namespace mrpt::maps;
25 using namespace mrpt::poses;
26 using namespace mrpt::img;
27 using namespace mrpt::math;
28 using namespace mrpt::system;
29 
30 CMetricMapBuilderICP::CMetricMapBuilderICP()
31  : ICP_options(m_min_verbosity_level)
32 {
33  this->setLoggerName("CMetricMapBuilderICP");
34  this->initialize(CSimpleMap());
35 }
36 
37 /*---------------------------------------------------------------
38  Destructor
39  ---------------------------------------------------------------*/
41 {
42  // Asure, we have exit all critical zones:
45 
46  // Save current map to current file:
48 }
49 
50 /*---------------------------------------------------------------
51  Options
52  ---------------------------------------------------------------*/
54  mrpt::system::VerbosityLevel& parent_verbosity_level)
55  : matchAgainstTheGrid(false),
56  insertionLinDistance(1.0),
57  insertionAngDistance(DEG2RAD(30)),
58  localizationLinDistance(0.20),
59  localizationAngDistance(DEG2RAD(30)),
60  minICPgoodnessToAccept(0.40),
61  verbosity_level(parent_verbosity_level),
62  mapInitializers()
63 {
64 }
65 
68 {
69  matchAgainstTheGrid = other.matchAgainstTheGrid;
70  insertionLinDistance = other.insertionLinDistance;
71  insertionAngDistance = other.insertionAngDistance;
72  localizationLinDistance = other.localizationLinDistance;
73  localizationAngDistance = other.localizationAngDistance;
74  minICPgoodnessToAccept = other.minICPgoodnessToAccept;
75  // We can't copy a reference type
76  // verbosity_level = other.verbosity_level;
77  mapInitializers = other.mapInitializers;
78  return *this;
79 }
80 
82  const mrpt::config::CConfigFileBase& source, const std::string& section)
83 {
84  MRPT_LOAD_CONFIG_VAR(matchAgainstTheGrid, bool, source, section)
85  MRPT_LOAD_CONFIG_VAR(insertionLinDistance, double, source, section)
86  MRPT_LOAD_CONFIG_VAR_DEGREES(insertionAngDistance, source, section)
87  MRPT_LOAD_CONFIG_VAR(localizationLinDistance, double, source, section)
88  MRPT_LOAD_CONFIG_VAR_DEGREES(localizationAngDistance, source, section)
89  verbosity_level = source.read_enum<mrpt::system::VerbosityLevel>(
90  section, "verbosity_level", verbosity_level);
91 
92  MRPT_LOAD_CONFIG_VAR(minICPgoodnessToAccept, double, source, section)
93 
94  mapInitializers.loadFromConfigFile(source, section);
95 }
96 
98  std::ostream& out) const
99 {
100  out << mrpt::format(
101  "\n----------- [CMetricMapBuilderICP::TConfigParams] ------------ "
102  "\n\n");
103 
104  out << mrpt::format(
105  "insertionLinDistance = %f m\n",
106  insertionLinDistance);
107  out << mrpt::format(
108  "insertionAngDistance = %f deg\n",
109  RAD2DEG(insertionAngDistance));
110  out << mrpt::format(
111  "localizationLinDistance = %f m\n",
112  localizationLinDistance);
113  out << mrpt::format(
114  "localizationAngDistance = %f deg\n",
115  RAD2DEG(localizationAngDistance));
116  out << mrpt::format(
117  "verbosity_level = %s\n",
119  verbosity_level)
120  .c_str());
121 
122  out << mrpt::format(" Now showing 'mapsInitializers':\n");
123  mapInitializers.dumpToTextStream(out);
124 }
125 
126 /*---------------------------------------------------------------
127  processObservation
128  This is the new entry point of the algorithm (the old one
129  was processActionObservation, which now is a wrapper to
130  this method).
131  ---------------------------------------------------------------*/
133 {
134  std::lock_guard<std::mutex> lock_cs(critZoneChangingMap);
135 
136  MRPT_START
137 
138  if (metricMap.m_pointsMaps.empty() && metricMap.m_gridMaps.empty())
139  throw std::runtime_error(
140  "Neither grid maps nor points map: Have you called initialize() "
141  "after setting ICP_options.mapInitializers?");
142 
143  ASSERT_(obs);
144 
145  // Is it an odometry observation??
146  if (IS_CLASS(obs, CObservationOdometry))
147  {
148  MRPT_LOG_DEBUG("processObservation(): obs is CObservationOdometry");
150 
151  const CObservationOdometry::Ptr odo =
152  std::dynamic_pointer_cast<CObservationOdometry>(obs);
153  ASSERT_(odo->timestamp != INVALID_TIMESTAMP);
154 
155  CPose2D pose_before;
156  bool pose_before_valid = m_lastPoseEst.getLatestRobotPose(pose_before);
157 
158  // Move our estimation:
160  odo->odometry.asTPose(), odo->timestamp, odo->hasVelocities,
161  odo->velocityLocal);
162 
163  if (pose_before_valid)
164  {
165  // Accumulate movement:
166  CPose2D pose_after;
167  if (m_lastPoseEst.getLatestRobotPose(pose_after))
168  this->accumulateRobotDisplacementCounters(pose_after);
170  "processObservation(): obs is CObservationOdometry, new "
171  "post_after="
172  << pose_after);
173  }
174  } // end it's odometry
175  else
176  {
177  // Current robot pose given the timestamp of the observation (this can
178  // include a small extrapolation
179  // using the latest known robot velocities):
180  TPose2D initialEstimatedRobotPose(0, 0, 0);
181  {
182  mrpt::math::TTwist2D robotVelLocal, robotVelGlobal;
183  if (obs->timestamp != INVALID_TIMESTAMP)
184  {
186  "processObservation(): extrapolating pose from latest pose "
187  "and new observation timestamp...");
189  initialEstimatedRobotPose, robotVelLocal,
190  robotVelGlobal, obs->timestamp))
191  { // couldn't had a good extrapolation estimate... we'll have
192  // to live with the latest pose:
193  m_lastPoseEst.getLatestRobotPose(initialEstimatedRobotPose);
195  "processObservation(): new pose extrapolation failed, "
196  "using last pose as is.");
197  }
198  }
199  else
200  {
202  "processObservation(): invalid observation timestamp.");
203  m_lastPoseEst.getLatestRobotPose(initialEstimatedRobotPose);
204  }
205  }
206 
207  // To know the total path length:
208  CPose2D previousKnownRobotPose;
209  m_lastPoseEst.getLatestRobotPose(previousKnownRobotPose);
210 
211  // Increment (this may only include the effects of extrapolation with
212  // velocity...):
214  previousKnownRobotPose); // initialEstimatedRobotPose-previousKnownRobotPose);
215 
216  // We'll skip ICP-based localization for this observation only if:
217  // - We had some odometry since the last pose correction
218  // (m_there_has_been_an_odometry=true).
219  // - AND, the traversed distance is small enough:
220  const bool we_skip_ICP_pose_correction =
228 
230  "processObservation(): skipping ICP pose correction due to small "
231  "odometric displacement? : "
232  << (we_skip_ICP_pose_correction ? "YES" : "NO"));
233 
234  CICP::TReturnInfo icpReturn;
235  bool can_do_icp = false;
236 
237  // Select the map to match with ....
238  CMetricMap* matchWith = nullptr;
240  {
241  matchWith = static_cast<CMetricMap*>(metricMap.m_gridMaps[0].get());
242  MRPT_LOG_DEBUG("processObservation(): matching against gridmap.");
243  }
244  else
245  {
246  ASSERTMSG_(
247  metricMap.m_pointsMaps.size(),
248  "No points map in multi-metric map.");
249  matchWith =
250  static_cast<CMetricMap*>(metricMap.m_pointsMaps[0].get());
251  MRPT_LOG_DEBUG("processObservation(): matching against point map.");
252  }
253  ASSERT_(matchWith != nullptr);
254 
255  if (!we_skip_ICP_pose_correction)
256  {
258 
259  // --------------------------------------------------------------------------------------
260  // Any other observation:
261  // 1) If the observation generates points in a point map, do ICP
262  // 2) In any case, insert the observation if the minimum distance
263  // has been satisfaced.
264  // --------------------------------------------------------------------------------------
265  CSimplePointsMap sensedPoints;
266  sensedPoints.insertionOptions.minDistBetweenLaserPoints = 0.02f;
267  sensedPoints.insertionOptions.also_interpolate = false;
268 
269  // Create points representation of the observation:
270  // Insert only those planar range scans in the altitude of the grid
271  // map:
273  !metricMap.m_gridMaps.empty() &&
274  metricMap.m_gridMaps[0]->insertionOptions.useMapAltitude)
275  {
276  // Use grid altitude:
278  {
280  std::dynamic_pointer_cast<CObservation2DRangeScan>(obs);
281  if (std::abs(
283  ->insertionOptions.mapAltitude -
284  obsLaser->sensorPose.z()) < 0.01)
285  can_do_icp = sensedPoints.insertObservationPtr(obs);
286  }
287  }
288  else
289  {
290  // Do not use grid altitude:
291  can_do_icp = sensedPoints.insertObservationPtr(obs);
292  }
293 
294  if (IS_DERIVED(matchWith, CPointsMap) &&
295  static_cast<CPointsMap*>(matchWith)->empty())
296  can_do_icp = false; // The reference map is empty!
297 
298  if (can_do_icp)
299  {
300  // We DO HAVE points with this observation:
301  // Execute ICP over the current points map and the sensed
302  // points:
303  // ----------------------------------------------------------------------
304  CICP ICP;
305  float runningTime;
306 
307  ICP.options = ICP_params;
308 
309  CPosePDF::Ptr pestPose = ICP.Align(
310  matchWith, // Map 1
311  &sensedPoints, // Map 2
313  initialEstimatedRobotPose), // a first gross estimation
314  // of map 2 relative to map
315  // 1.
316  &runningTime, // Running time
317  &icpReturn // Returned information
318  );
319 
321  {
322  // save estimation:
323  CPosePDFGaussian pEst2D;
324  pEst2D.copyFrom(*pestPose);
325 
327  pEst2D.mean.asTPose(), obs->timestamp);
328  m_lastPoseEst_cov = pEst2D.cov;
329 
331 
332  // Debug output to console:
334  "processObservation: previousPose="
335  << previousKnownRobotPose << "-> currentPose="
336  << pEst2D.getMeanVal() << std::endl);
338  "[CMetricMapBuilderICP] Fit:%.1f%% Itr:%i In "
339  "%.02fms \n",
340  icpReturn.goodness * 100, icpReturn.nIterations,
341  1000 * runningTime));
342  }
343  else
344  {
346  "Ignoring ICP of low quality: "
347  << icpReturn.goodness * 100 << std::endl);
348  }
349 
350  // Compute the transversed length:
351  CPose2D currentKnownRobotPose;
352  m_lastPoseEst.getLatestRobotPose(currentKnownRobotPose);
353 
355  currentKnownRobotPose); // currentKnownRobotPose -
356  // previousKnownRobotPose);
357 
358  } // end we can do ICP.
359  else
360  {
362  "Cannot do ICP: empty pointmap or not suitable "
363  "gridmap...\n");
364  }
365 
366  } // else, we do ICP pose correction
367 
368  // ----------------------------------------------------------
369  // CRITERION TO DECIDE MAP UPDATE:
370  // A distance large-enough from the last update for each sensor, AND
371  // either: (i) this was a good match or (ii) this is the first time
372  // for this sensor.
373  // ----------------------------------------------------------
374  const bool firstTimeForThisSensor =
375  m_distSinceLastInsertion.find(obs->sensorLabel) ==
377  bool update =
378  firstTimeForThisSensor ||
379  ((!can_do_icp ||
381  (m_distSinceLastInsertion[obs->sensorLabel].lin >=
383  m_distSinceLastInsertion[obs->sensorLabel].ang >=
385 
386  // Used any "options.alwaysInsertByClass" ??
387  if (options.alwaysInsertByClass.contains(obs->GetRuntimeClass()))
388  update = true;
389 
390  // We need to always insert ALL the observations at the beginning until
391  // the first one
392  // that actually insert some points into the map used as a reference,
393  // since otherwise
394  // we'll not be able to do ICP against an empty map!!
395  if (matchWith && matchWith->isEmpty()) update = true;
396 
398  "update map: " << (update ? "YES" : "NO")
399  << " options.enableMapUpdating: "
400  << (options.enableMapUpdating ? "YES" : "NO"));
401 
402  if (options.enableMapUpdating && update)
403  {
404  CTicTac tictac;
405 
406  tictac.Tic();
407 
408  // Insert the observation:
409  CPose2D currentKnownRobotPose;
410  m_lastPoseEst.getLatestRobotPose(currentKnownRobotPose);
411 
412  // Create new entry:
413  m_distSinceLastInsertion[obs->sensorLabel].last_update =
414  currentKnownRobotPose;
415 
416  // Reset distance counters:
417  resetRobotDisplacementCounters(currentKnownRobotPose);
418  // m_distSinceLastInsertion[obs->sensorLabel].updatePose(currentKnownRobotPose);
419 
421  "Updating map from pose %s\n",
422  currentKnownRobotPose.asString().c_str()));
423 
424  CPose3D estimatedPose3D(currentKnownRobotPose);
425  const bool anymap_update =
426  metricMap.insertObservationPtr(obs, &estimatedPose3D);
427  if (!anymap_update)
429  "**No map was updated** after inserting an observation of "
430  "type `"
431  << obs->GetRuntimeClass()->className << "`");
432 
433  // Add to the vector of "poses"-"SFs" pairs:
434  CPosePDFGaussian posePDF(currentKnownRobotPose);
435  CPose3DPDF::Ptr pose3D =
436  CPose3DPDF::Ptr(CPose3DPDF::createFrom2D(posePDF));
437 
438  CSensoryFrame::Ptr sf = mrpt::make_aligned_shared<CSensoryFrame>();
439  sf->insert(obs);
440 
441  SF_Poses_seq.insert(pose3D, sf);
442 
444  "Map updated OK. Done in "
445  << mrpt::system::formatTimeInterval(tictac.Tac()) << std::endl);
446  }
447 
448  } // end other observation
449 
450  // Robot path history:
451  {
452  TPose2D p;
454  }
455 
456  MRPT_END
457 
458 } // end processObservation
459 
460 /*---------------------------------------------------------------
461 
462  processActionObservation
463 
464  ---------------------------------------------------------------*/
466  CActionCollection& action, CSensoryFrame& in_SF)
467 {
468  // 1) process action:
469  CActionRobotMovement2D::Ptr movEstimation =
470  action.getBestMovementEstimation();
471  if (movEstimation)
472  {
474  m_auxAccumOdometry, movEstimation->poseChange->getMeanVal());
475 
477  mrpt::make_aligned_shared<CObservationOdometry>();
478  obs->timestamp = movEstimation->timestamp;
479  obs->odometry = m_auxAccumOdometry;
480  this->processObservation(obs);
481  }
482 
483  // 2) Process observations one by one:
484  for (CSensoryFrame::iterator i = in_SF.begin(); i != in_SF.end(); ++i)
485  this->processObservation(*i);
486 }
487 
488 /*---------------------------------------------------------------
489  setCurrentMapFile
490  ---------------------------------------------------------------*/
492 {
493  // Save current map to current file:
495 
496  // Sets new current map file:
497  currentMapFile = mapFile;
498 
499  // Load map from file or create an empty one:
500  if (currentMapFile.size()) loadCurrentMapFromFile(mapFile);
501 }
502 
503 /*---------------------------------------------------------------
504  getCurrentPoseEstimation
505  ---------------------------------------------------------------*/
507 {
508  CPosePDFGaussian pdf2D;
510  pdf2D.cov = m_lastPoseEst_cov;
511 
513  mrpt::make_aligned_shared<CPose3DPDFGaussian>();
514  pdf3D->copyFrom(pdf2D);
515  return pdf3D;
516 }
517 
518 /*---------------------------------------------------------------
519  initialize
520  ---------------------------------------------------------------*/
522  const CSimpleMap& initialMap, const CPosePDF* x0)
523 {
524  MRPT_START
525 
526  // Reset vars:
527  m_estRobotPath.clear();
528  m_auxAccumOdometry = CPose2D(0, 0, 0);
529 
531  m_distSinceLastInsertion.clear();
532 
534 
535  // Init path & map:
536  std::lock_guard<std::mutex> lock_cs(critZoneChangingMap);
537 
538  // Create metric maps:
540 
541  // copy map:
542  SF_Poses_seq = initialMap;
543 
544  // Parse SFs to the hybrid map:
545  // Set options:
546  // ---------------------
547  // if (metricMap.m_pointsMaps.size())
548  //{
549  // metricMap.m_pointsMaps[0]->insertionOptions.fuseWithExisting =
550  // false;
551  // metricMap.m_pointsMaps[0]->insertionOptions.minDistBetweenLaserPoints =
552  // 0.05f;
553  // metricMap.m_pointsMaps[0]->insertionOptions.disableDeletion =
554  // true;
555  // metricMap.m_pointsMaps[0]->insertionOptions.isPlanarMap =
556  // true;
557  // metricMap.m_pointsMaps[0]->insertionOptions.matchStaticPointsOnly =
558  // true;
559  //}
560 
561  // Load estimated pose from given PDF:
563 
564  if (x0)
566  x0->getMeanVal().asTPose(), mrpt::Clock::now());
567 
568  for (size_t i = 0; i < SF_Poses_seq.size(); i++)
569  {
570  CPose3DPDF::Ptr posePDF;
572 
573  // Get the SF and its pose:
574  SF_Poses_seq.get(i, posePDF, SF);
575 
576  CPose3D estimatedPose3D;
577  posePDF->getMean(estimatedPose3D);
578 
579  // Insert observations into the map:
580  SF->insertObservationsInto(&metricMap, &estimatedPose3D);
581  }
582 
583  MRPT_LOG_INFO("loadCurrentMapFromFile() OK.\n");
584 
585  MRPT_END
586 }
587 
588 /*---------------------------------------------------------------
589  getCurrentMapPoints
590  ---------------------------------------------------------------*/
592  std::vector<float>& x, std::vector<float>& y)
593 {
594  // Critical section: We are using our global metric map
596 
597  ASSERT_(metricMap.m_pointsMaps.size() > 0);
598  metricMap.m_pointsMaps[0]->getAllPoints(x, y);
599 
600  // Exit critical zone.
602 }
603 
604 /*---------------------------------------------------------------
605  getCurrentlyBuiltMap
606  ---------------------------------------------------------------*/
608 {
609  out_map = SF_Poses_seq;
610 }
611 
613 {
614  return &metricMap;
615 }
616 
617 /*---------------------------------------------------------------
618  getCurrentlyBuiltMapSize
619  ---------------------------------------------------------------*/
621 {
622  return SF_Poses_seq.size();
623 }
624 
625 /*---------------------------------------------------------------
626  saveCurrentEstimationToImage
627  ---------------------------------------------------------------*/
629  const std::string& file, bool formatEMF_BMP)
630 {
631  MRPT_START
632 
633  CImage img;
634  const size_t nPoses = m_estRobotPath.size();
635 
636  ASSERT_(metricMap.m_gridMaps.size() > 0);
637 
638  if (!formatEMF_BMP) THROW_EXCEPTION("Not implemented yet for BMP!");
639 
640  // grid map as bitmap:
641  // ----------------------------------
642  metricMap.m_gridMaps[0]->getAsImage(img);
643 
644  // Draw paths (using vectorial plots!) over the EMF file:
645  // -------------------------------------------------
646  // float SCALE = 1000;
647  CEnhancedMetaFile EMF(file, 1000);
648 
649  EMF.drawImage(0, 0, img);
650 
651  unsigned int imgHeight = img.getHeight();
652 
653  // Path hypothesis:
654  // ----------------------------------
655  int x1, x2, y1, y2;
656 
657  // First point: (0,0)
658  x2 = metricMap.m_gridMaps[0]->x2idx(0.0f);
659  y2 = metricMap.m_gridMaps[0]->y2idx(0.0f);
660 
661  // Draw path in the bitmap:
662  for (size_t j = 0; j < nPoses; j++)
663  {
664  // For next segment
665  x1 = x2;
666  y1 = y2;
667 
668  // Coordinates -> pixels
669  x2 = metricMap.m_gridMaps[0]->x2idx(m_estRobotPath[j].x);
670  y2 = metricMap.m_gridMaps[0]->y2idx(m_estRobotPath[j].y);
671 
672  // Draw line:
673  EMF.line(
674  x1, imgHeight - 1 - y1, x2, imgHeight - 1 - y2, TColor::black());
675  }
676 
677  MRPT_END
678 }
679 
681  const CPose2D& new_pose)
682 {
684  for (auto& m : m_distSinceLastInsertion) m.second.updateDistances(new_pose);
685 }
686 
688  const CPose2D& new_pose)
689 {
690  m_distSinceLastICP.updatePose(new_pose);
691  for (auto& m : m_distSinceLastInsertion) m.second.updatePose(new_pose);
692 }
693 
695 {
696  mrpt::poses::CPose2D Ap = p - this->last_update;
697  lin = Ap.norm();
698  ang = std::abs(Ap.phi());
699 }
700 
702 {
703  this->last_update = p;
704  lin = 0;
705  ang = 0;
706 }
void saveCurrentMapToFile(const std::string &fileName, bool compressGZ=true) const
Save map (mrpt::maps::CSimpleMap) to a ".simplemap" file.
double Tac() noexcept
Stops the stopwatch.
Definition: CTicTac.cpp:90
This class represents a Windows Enhanced Meta File (EMF) for generating and saving graphics...
void loadFromConfigFile(const mrpt::config::CConfigFileBase &source, const std::string &section) override
This method load the options from a ".ini"-like file or memory-stored string list.
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)
std::deque< CObservation::Ptr >::iterator iterator
You can use CSensoryFrame::begin to get a iterator to the first element.
#define MRPT_START
Definition: exceptions.h:262
#define MRPT_LOG_DEBUG(_STRING)
Use: MRPT_LOG_DEBUG("message");
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) ...
Definition: CPose2D.cpp:418
mrpt::maps::TSetOfMetricMapInitializers mapInitializers
What maps to create (at least one points map and/or a grid map are needed).
#define min(a, b)
VerbosityLevel
Enumeration of available verbosity levels.
double RAD2DEG(const double x)
Radians to degrees.
mrpt::maps::CMultiMetricMap metricMap
The metric map representation as a points map:
ProxyFilterContainerByClass< mrpt::maps::CSimplePointsMap::Ptr, TListMaps > m_pointsMaps
STL-like proxy to access this kind of maps in maps.
#define THROW_EXCEPTION(msg)
Definition: exceptions.h:41
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...
Definition: CSimpleMap.h:33
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 ...
Definition: CICP.h:65
double DEG2RAD(const double x)
Degrees to radians.
mrpt::rtti::CListOfClasses alwaysInsertByClass
A list of observation classes (derived from mrpt::obs::CObservation) which will be always inserted in...
std::deque< mrpt::math::TPose2D > m_estRobotPath
The estimated robot path:
void leaveCriticalSection()
Leave critical section for map updating.
void drawImage(int x, int y, const mrpt::img::CImage &img) override
Draws an image as a bitmap at a given position.
virtual ~CMetricMapBuilderICP()
Destructor:
A high-performance stopwatch, with typical resolution of nanoseconds.
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.
A cloud of points in 2D or 3D, which can be built from a sequence of laser scans. ...
STL namespace.
TDATA getMeanVal() const
Returns the mean, or mathematical expectation of the probability density distribution (PDF)...
std::string formatTimeInterval(const double timeSeconds)
Returns a formated string with the given time difference (passed as the number of seconds)...
Definition: datetime.cpp:131
mrpt::maps::CSimpleMap SF_Poses_seq
The set of observations that leads to current map:
static time_point now() noexcept
Returns the current time, with the highest resolution available.
Definition: Clock.cpp:46
TConfigParams options
The options employed by the ICP align.
Definition: CICP.h:180
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...
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.
#define MRPT_LOG_WARN_STREAM(__CONTENTS)
Declares a class for storing a collection of robot actions.
void reset()
Resets all internal state.
bool matchAgainstTheGrid
(default:false) Match against the occupancy grid or the points map? The former is quicker but less pr...
mrpt::math::TPose2D asTPose() const
Definition: CPose2D.cpp:441
void updateDistances(const mrpt::poses::CPose2D &p)
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: ...
#define ASSERT_(f)
Defines an assertion mechanism.
Definition: exceptions.h:113
CICP::TConfigParams ICP_params
Options for the ICP algorithm itself.
#define IS_DERIVED(ptrObj, class_name)
Evaluates to true if a pointer to an object (derived from mrpt::rtti::CObject) is an instance of the ...
Definition: CObject.h:108
float goodness
A goodness measure for the alignment, it is a [0,1] range indicator of percentage of correspondences...
Definition: CICP.h:197
A cloud of points in 2D or 3D, which can be built from a sequence of laser scans or other sensors...
Definition: CPointsMap.h:64
This class allows loading and storing values and vectors of different types from a configuration text...
This base provides a set of functions for maths stuff.
Declares a class that represents a Probability Density function (PDF) of a 2D pose ...
TConfigParams(mrpt::system::VerbosityLevel &parent_verbosity_level)
Initializer.
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)
double norm() const
Returns the euclidean norm of vector: .
Definition: CPoseOrPoint.h:253
std::string currentMapFile
Current map file.
A helper class that can convert an enum value into its textual representation, and viceversa...
void processUpdateNewOdometry(const mrpt::math::TPose2D &newGlobalOdometry, mrpt::Clock::time_point cur_tim, bool hasVelocities=false, const mrpt::math::TTwist2D &newRobotVelLocal=mrpt::math::TTwist2D())
Updates the filter with new odometry readings.
GLint GLvoid * img
Definition: glext.h:3763
void line(int x0, int y0, int x1, int y1, const mrpt::img::TColor color, unsigned int width=1, TPenStyle penStyle=psSolid) override
Draws a line.
const mrpt::maps::CMultiMetricMap * getCurrentlyBuiltMetricMap() const override
Returns the map built so far.
void setLoggerName(const std::string &name)
Set the name of the COutputLogger instance.
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...
Definition: CSensoryFrame.h:52
ProxyFilterContainerByClass< mrpt::maps::COccupancyGridMap2D::Ptr, TListMaps > m_gridMaps
STL-like proxy to access this kind of maps in maps.
#define ASSERTMSG_(f, __ERROR_MSG)
Defines an assertion mechanism.
Definition: exceptions.h:101
void resetRobotDisplacementCounters(const mrpt::poses::CPose2D &new_pose)
size_t size() const
Returns the count of pairs (pose,sensory data)
Definition: CSimpleMap.cpp:53
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&#39;th pair, first one is index &#39;0&#39;.
Definition: CSimpleMap.cpp:56
#define MRPT_LOG_DEBUG_STREAM(__CONTENTS)
Use: MRPT_LOG_DEBUG_STREAM("Var=" << value << " foo=" << foo_var);
unsigned short nIterations
The number of executed iterations until convergence.
Definition: CICP.h:194
GLsizei const GLchar ** string
Definition: glext.h:4101
Declares a class that represents a probability density function (pdf) of a 2D pose (x...
Definition: CPosePDF.h:39
Classes for 2D/3D geometry representation, both of single values and probability density distribution...
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...
bool also_interpolate
If set to true, far points (<1m) are interpolated with samples at "minDistSqrBetweenLaserPoints" inte...
Definition: CPointsMap.h:225
#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...
#define MRPT_LOG_INFO_STREAM(__CONTENTS)
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...
bool contains(const mrpt::rtti::TRuntimeClassId *id) const
Does the list contains this class?
void dumpToTextStream(std::ostream &out) const override
This method should clearly display all the contents of the structure in textual form, sending it to a std::ostream.
bool getCurrentEstimate(mrpt::math::TPose2D &pose, mrpt::math::TTwist2D &velLocal, mrpt::math::TTwist2D &velGlobal, mrpt::Clock::time_point tim_query=mrpt::Clock::now()) const
Get the estimate for a given timestamp (defaults to now()), obtained as:
Declares a virtual base class for all metric maps storage classes.
Definition: CMetricMap.h:54
A class used to store a 2D pose, including the 2D coordinate point and a heading (phi) angle...
Definition: CPose2D.h:38
A class used to store a 3D pose (a 3D translation + a rotation in 3D).
Definition: CPose3D.h:86
void setListOfMaps(const mrpt::maps::TSetOfMetricMapInitializers *initializers)
Sets the list of internal map according to the passed list of map initializers (Current maps&#39; content...
std::string format(const char *fmt,...) MRPT_printf_format_check(1
A std::string version of C sprintf.
Definition: format.cpp:16
const double & phi() const
Get the phi angle of the 2D pose (in radians)
Definition: CPose2D.h:80
#define IS_CLASS(ptrObj, class_name)
Evaluates to true if the given pointer to an object (derived from mrpt::rtti::CObject) is of the give...
Definition: CObject.h:102
void composeFrom(const CPose2D &A, const CPose2D &B)
Makes .
Definition: CPose2D.cpp:111
#define MRPT_END
Definition: exceptions.h:266
The ICP algorithm return information.
Definition: CICP.h:190
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.
Definition: CMetricMap.cpp:109
Lightweight 2D pose.
GLsizei GLsizei GLchar * source
Definition: glext.h:4082
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 (...
GLenum GLint GLint y
Definition: glext.h:3538
#define MRPT_LOG_WARN(_STRING)
mrpt::aligned_std_map< std::string, TDist > m_distSinceLastInsertion
Indexed by sensor label.
TInsertionOptions insertionOptions
The options used when inserting observations in the map.
Definition: CPointsMap.h:257
mrpt::poses::CPose3DPDF::Ptr getCurrentPoseEstimation() const override
Returns a copy of the current best pose estimation as a pose PDF.
#define MRPT_LOAD_CONFIG_VAR_DEGREES( variableName, configFileObject, sectionNameStr)
Loads a double variable, stored as radians but entered in the INI-file as degrees.
An observation of the current (cumulative) odometry for a wheeled robot.
GLenum GLint x
Definition: glext.h:3538
void processUpdateNewPoseLocalization(const mrpt::math::TPose2D &newPose, mrpt::Clock::time_point tim)
Updates the filter with new global-coordinates localization data from a localization or SLAM source...
const_iterator end() const
Returns a constant iterator to the end of the list of observations: this is an example of usage: ...
void Tic() noexcept
Starts the stopwatch.
Definition: CTicTac.cpp:79
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.
Definition: CSimpleMap.cpp:136
virtual bool isEmpty() const =0
Returns true if the map is empty/no observation has been inserted.
GLfloat GLfloat p
Definition: glext.h:6305
unsigned int getCurrentlyBuiltMapSize() override
Returns just how many sensory-frames are stored in the currently build map.
std::mutex critZoneChangingMap
Critical zones.
#define INVALID_TIMESTAMP
Represents an invalid timestamp, where applicable.
Definition: datetime.h:43
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...
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...
A class for storing images as grayscale or RGB bitmaps.
Definition: img/CImage.h:130
float minDistBetweenLaserPoints
The minimum distance between points (in 3D): If two points are too close, one of them is not inserted...
Definition: CPointsMap.h:218
#define MRPT_LOG_INFO(_STRING)
void accumulateRobotDisplacementCounters(const mrpt::poses::CPose2D &new_pose)



Page generated by Doxygen 1.8.14 for MRPT 1.9.9 Git: 7d5e6d718 Fri Aug 24 01:51:28 2018 +0200 at lun nov 2 08:35:50 CET 2020