|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |
Launch files
Messages
Services
Plugins
Recent questions tagged mola_metric_maps at Robotics Stack Exchange
|
mola_metric_maps package from mola repomola mola_bridge_ros2 mola_demos mola_input_lidar_bin_dataset mola_input_rawlog mola_input_rosbag2 mola_input_video mola_kernel mola_launcher mola_metric_maps mola_msgs mola_pose_list mola_relocalization mola_traj_tools mola_viz mola_viz_imgui mola_yaml |
ROS Distro
|
Package Summary
| Version | 3.5.0 |
| License | GPLv3 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/MOLAorg/mola.git |
| VCS Type | git |
| VCS Version | develop |
| Last Updated | 2026-11-15 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Jose-Luis Blanco-Claraco
Authors
mola_metric_maps
Advanced metric map classes for LiDAR odometry and SLAM, built on the
generic mrpt::maps::CMetricMap interface. All maps are serializable,
visualizable, and integrate with the mp2p_icp
registration library.
Map classes
Production-quality maps
| Class | Header | Description |
|---|---|---|
mola::HashedVoxelPointCloud |
HashedVoxelPointCloud.h |
Flat sparse hash map of cubic voxels. Up to 32 points per voxel stored without heap allocation (fixed array SSO). Backend: tsl::robin_map. Implements NearestNeighborsCapable. |
mola::SparseVoxelPointCloud |
SparseVoxelPointCloud.h |
Two-level voxel map: sparse outer blocks + 32³ inner FixedDenseGrid3D. Tracks per-voxel point means; supports voxel-mean ICP matching. Implements NearestNeighborsCapable. The primary workhorse map in MOLA LO/SLAM. |
mola::NDT |
NDT.h |
Normal Distributions Transform map (Magnusson 2007). Fits a Gaussian per voxel; planar voxels expose NearestPlaneCapable, non-planar ones expose NearestNeighborsCapable. Enables automatic point-to-point vs. point-to-plane pairing selection. |
mola::KeyframePointCloudMap |
KeyframePointCloudMap.h |
Keyframe-based map: each keyframe holds a local point cloud plus a SE(3) pose. Supports map corrections without re-inserting points (just update poses). Implements IcpPrepareCapable, NearestPointWithCovCapable, and MetricMapMergeCapable. |
Experimental / work-in-progress maps
| Class | Header | Status |
|---|---|---|
mola::SparseTreesPointCloud |
SparseTreesPointCloud.h |
Coarse 3D grid of independent CSimplePointsMap sub-maps, each with its own KD-tree. Functionally complete but not benchmarked against the hash-based alternatives for typical SLAM workloads. |
mola::OccGrid |
OccGrid.h |
Wraps mrpt::maps::COccupancyGridMap2D with a super-resolution likelihood cache. The cache infrastructure is in place but likelihood population is not yet implemented (// TODO). Not used in any production pipeline. |
Utility / internal classes
| Class | Header | Description |
|---|---|---|
mola::index3d_t<T> |
index3d_t.h |
Discrete 3D integer index. Works as key in std::map and std::unordered_map / tsl::robin_map via the index3d_hash functor, which implements the Teschner et al. (2003) spatial hash. |
mola::FixedDenseGrid3D<T,N,C> |
FixedDenseGrid3D.h |
Dense NxNxN grid (N=2^SIDE_NUM_BITS) allocated with calloc for fast zero-init. Used as the inner block in SparseVoxelPointCloud. Requires trivially-copyable cell types. |
Build and install
Refer to the root MOLA repository.
License
Copyright (C) 2018-2026 Jose Luis Blanco jlblanco@ual.es, University of Almeria
This package is released under the GNU GPL v3 license. Companies deploying or distributing it in closed-source products, or otherwise unable to comply with the GPL v3, can obtain a commercial license (MOLA Pro), for this package alone or in combination with the complete SLAM system.
Changelog for package mola_metric_maps
3.5.0 (2026-11-15)
- Python bindings, type stubs and tests, plus a pip wheel (mola-metric-maps).
- Apply the observation sensorPose on insertion.
- Voxel-map likelihoods count unmatched points as the worst match; sigma_dist documented as the log-likelihood divisor.
- covariance_shape eigenvalue floor that survives single precision.
- Fix copies of SparseVoxelPointCloud; trySetCreationOptions() from a TCreationOptions.
- Drop the unused mola_kernel dependency.
- Contributors: Jose Luis Blanco-Claraco
3.4.0 (2026-11-01)
- IncrementalPointCloud: exact voxel-hash index, now the default (#256)
- IncrementalPointCloud: allocation-free covariances, provisional covariance reuse, optional minimum point distance (#252)
- Fix k-NN and capped radius search of HashedVoxelPointCloud and NDT; round voxel indices down (#255)
- Expose map contents via CMetricMap::asPointsMapView() (#247)
- KeyframePointCloudMap: thread-safe copies and option updates (#245)
- Do not rotate view directions twice with MRPT >= 3.6.0 (#262)
- Fix license note
- Contributors: Jose Luis Blanco-Claraco
3.3.2 (2026-10-09)
3.3.1 (2026-10-05)
- IncrementalPointCloud: optional view-direction filter (None, MaxAngle, SurfaceSide), now enabled with SurfaceSide by default
- KeyframePointCloudMap and IncrementalPointCloud share the same view-direction filter options and test
- SurfaceSide filter only trusts flat neighborhoods
- Validate the stored filter mode and drop view directions on unseen re-maps; notice base-class re-maps even after appends
- Serialization: KFM creation options v10, IPC class v2 and creation options v4
- Contributors: Jose Luis Blanco-Claraco
3.3.0 (2026-09-23)
- Port to MRPT 3.x (#220)
- Disable the inherited KDTreeCapable index on IncrementalPointCloud (#224)
- Fix a dangling reference in the keyframe-pose test (#225)
- Do not cache a covariance estimated from a thin neighborhood (#222)
- Cap the negative covariance floor at the largest eigenvalue
- Allow keeping the per-point covariance eigenvalues as found
- Contributors: Jose Luis Blanco-Claraco
3.2.1 (2026-09-15)
- TSDF: render the actual zero level set, not the voxel centers (#217)
- Merge pull request #213 from MOLAorg/feat/tsdf-uses-shared-hash Drop TSDF's private voxel hash for the shared one
- Read the voxel index through its members, not through a cast
- Merge pull request #211 from MOLAorg/feat/tsdf-local-map Add mola::TSDF, a truncated signed distance field local map
- Expose the two constants of the per-point plane regularization (#200)
- Optional diagnostic: scan-side covariance degeneracy in cov-to-cov matching (#199)
- Merge pull request #197 from MOLAorg/feat/ndt-plane-candidates NDT: report every candidate cell plane, not only the closest one
- Guard NDT::nn_visit_pt2pl_candidates() for older mp2p_icp
- Contributors: Jose Luis Blanco-Claraco
3.2.0 (2026-08-21)
- Merge pull request #195 from MOLAorg/feat/cov2cov-ambiguity-gating mola_metric_maps: adopt mp2p_icp::MatchingDistanceProfile in nn_search_cov2cov
- Merge branch 'develop' into feat/cov2cov-ambiguity-gating
- mola_metric_maps: remove the ambiguity gate from nn_search_cov2cov() Companion to the removal in mp2p_icp#89: firstToSecondDistanceMin/ firstToSecondMinRange were not yet justified by results. Drop the gate logic (and the k=2 / radius-inflated query it required) from IncrementalPointCloud and
File truncated at 100 lines see the full file
Package Dependencies
| Deps | Name |
|---|---|
| ros_environment | |
| ament_cmake_xmllint | |
| ament_cmake_gtest | |
| ament_cmake | |
| mola_test_datasets | |
| ament_lint_auto | |
| ament_lint_common | |
| mola_common | |
| mrpt_maps | |
| mrpt_viz | |
| mp2p_icp | |
| nanoflann_vendor |
System Dependencies
Dependant Packages
| Name | Deps |
|---|---|
| mola | |
| mola_lidar_odometry | |
| mola_sm_loop_closure |