mola_relocalization

C++ library with algorithms for relocalization, global localization, or pose estimation given a large initial uncertainty.

Note that particle filtering is implemented in its own repository under mrpt_navigation.

Method #1: mola::RelocalizationICP_SE2

Takes a global and a local metric map, a SE(2) ROI, and tries to match the local map in the global map by running ICP from all initial guesses defined by a regular SE(2) lattice, returning the result as a SE(3) hashed lattice.

This method is based on mp2p_icp ICP pipelines.

Method #2: mola::RelocalizationLikelihood_SE2

Takes a global metric map, an observation, and a SE(2) ROI, and evaluates the likelihood of the observation in a regular SE(2) lattice.

This is based on mrpt maps observationLikelihood() evaluation, so the main parameters that determine the way likelihood is computed must be defined on before hand within each of the metric map layers of the input reference map. At present this algorithm is useful for these sensor/map types:

• observations: pointclouds/2d_scan, reference_map: 2D gridmap
• observations: pointclouds, reference_map: pointclouds

Example result for the mola::RelocalizationLikelihood_SE2 method (from a unit test, see the code for details):

Figure: (top-left) Reference map. (bottom-left) Query map (actually, a decimated version is used internally). (top-right) Visualization of a slice of the returned likelihood field over a SE(2) ROI. The “slice” is for orientation (phi) equal to 0 (close to the actual pose transformation between the two maps). (bottom-right) The same likelihood slice, in real (x,y) coordinates (meters). The clear peak reveals, approximately, the location of the sought SE(2) transformation between the maps. Further refining is possible using ICP using this as initial guess.

Build and install

Refer to the root MOLA repository.

Docs and examples

See this package page in the documentation.

License

This package is released under the GNU GPL v3 license. Other options available upon request.

Changelog for package mola_relocalization

2.9.0 (2026-05-11)

• Merge pull request #143 from MOLAorg/bump-cmake-version bump min req cmake version to 3.22
• bump min req cmake version to 3.22
• Contributors: Jose Luis Blanco-Claraco

2.8.0 (2026-04-29)

2.7.0 (2026-04-22)

2.6.1 (2026-04-02)

2.6.0 (2026-03-12)

• Merge pull request #107 from MOLAorg/fix/viz-decay-clouds Fix/viz-decay-clouds
• fix clang-tidy warning: avoid std::endl
• Update coyright notes
• Contributors: Jose Luis Blanco-Claraco

2.5.0 (2026-02-14)

• Merge pull request #100 from MOLAorg/fix/remove-mrpt-deprecated-maps Remove use of mrpt deprecated maps
• Avoid use of deprecated mrpt::maps classes
• Contributors: Jose Luis Blanco-Claraco

2.4.0 (2025-12-28)

2.3.0 (2025-12-15)

2.2.1 (2025-11-08)

2.2.0 (2025-10-28)

2.1.0 (2025-10-20)

2.0.0 (2025-10-13)

• Remove old code that was needed to support very old MRPT versions
• Contributors: Jose Luis Blanco-Claraco

1.9.1 (2025-07-07)

1.9.0 (2025-06-06)

1.8.1 (2025-05-28)

1.8.0 (2025-05-25)

• Update copyright year
• Contributors: Jose Luis Blanco-Claraco

1.7.0 (2025-05-06)

1.6.4 (2025-04-23)

• modernize clang-format
• Contributors: Jose Luis Blanco-Claraco

1.6.3 (2025-03-15)

1.6.2 (2025-02-22)

1.6.1 (2025-02-13)

1.6.0 (2025-01-21)

1.5.1 (2024-12-29)

1.5.0 (2024-12-26)

1.4.1 (2024-12-20)

1.4.0 (2024-12-18)

1.3.0 (2024-12-11)

1.2.1 (2024-09-29)

1.2.0 (2024-09-16)

• Fix cmake warning on missing mola_test_datasets for non-test builds
• Contributors: Jose Luis Blanco-Claraco

1.1.3 (2024-08-28)

• Depend on new mrpt_lib packages (deprecate mrpt2)
• Contributors: Jose Luis Blanco-Claraco

1.1.2 (2024-08-26)

1.1.1 (2024-08-23)

File truncated at 100 lines see the full file