Skip to content

Commit

Permalink
docs: complete pf-based localization demo
Browse files Browse the repository at this point in the history
  • Loading branch information
jlblancoc committed Sep 7, 2024
1 parent 076b143 commit e1fc28e
Showing 1 changed file with 23 additions and 4 deletions.
27 changes: 23 additions & 4 deletions docs/source/localization.rst
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ pose in the environment:

|
----

2. Localization with LiDAR odometry
--------------------------------------
Expand All @@ -51,6 +52,8 @@ Write me!
|

----

3. Localization with particle filtering
----------------------------------------
To localize with a particle filter (PF) you will need:
Expand All @@ -71,11 +74,27 @@ To localize with a particle filter (PF) you will need:
================
A complete demonstration has been put together on: https://github.com/MOLAorg/mola_warehouse_pf_tutorial

.. dropdown:: Run tutorial
:open:
.. raw:: html

<div style="width: 100%; overflow: hidden;">
<video controls autoplay loop muted style="width: 512px;">
<source src="https://mrpt.github.io/videos/mola-localization-pf-demo-warehouse.mp4" type="video/mp4">
</video>
</div>

Key points of this tutorial:

- The ROS 2 `launch file <https://github.com/MOLAorg/mola_warehouse_pf_tutorial/blob/develop/launch/tutorial_launch.py>`_.
- A `custom sm2mm pipeline file <https://github.com/MOLAorg/mola_warehouse_pf_tutorial/tree/develop/sm2mm-config>`_ to create
a reference point cloud map sparse enough so localizing with a PF is not too slow.
- A `pipeline for mrpt_pointcloud_pipeline <https://github.com/MOLAorg/mola_warehouse_pf_tutorial/blob/develop/params/point-cloud-pipeline.yaml>`_
to decimate the input raw 3D scan as input to the PF.


.. dropdown:: How to run the tutorial

Clone the tutorial package (which already includes a prebuilt ``.mm``), make sure of having all dependencies,
build and run it:
Clone the tutorial package (which already includes a prebuilt ``.mm``), make sure of having all dependencies,
build and run it:

.. code-block:: bash
Expand Down

0 comments on commit e1fc28e

Please sign in to comment.