Blame examples/slam/pose_graph_2d/README.md

Packit ea1746
Pose Graph 2D
Packit ea1746
----------------
Packit ea1746
Packit ea1746
The Simultaneous Localization and Mapping (SLAM) problem consists of building a
Packit ea1746
map of an unknown environment while simultaneously localizing against this
Packit ea1746
map. The main difficulty of this problem stems from not having any additional
Packit ea1746
external aiding information such as GPS. SLAM has been considered one of the
Packit ea1746
fundamental challenges of robotics. A pose graph optimization problem is one
Packit ea1746
example of a SLAM problem.
Packit ea1746
Packit ea1746
This package defines the necessary Ceres cost functions needed to model the
Packit ea1746
2-dimensional pose graph optimization problem as well as a binary to build and
Packit ea1746
solve the problem. The cost functions are shown for instruction purposes and can
Packit ea1746
be speed up by using analytical derivatives which take longer to implement.
Packit ea1746
Packit ea1746
Running
Packit ea1746
-----------
Packit ea1746
This package includes an executable `pose_graph_2d` that will read a problem
Packit ea1746
definition file. This executable can work with any 2D problem definition that
Packit ea1746
uses the g2o format. It would be relatively straightforward to implement a new
Packit ea1746
reader for a different format such as TORO or others. `pose_graph_2d` will print
Packit ea1746
the Ceres solver full summary and then output to disk the original and optimized
Packit ea1746
poses (`poses_original.txt` and `poses_optimized.txt`, respectively) of the
Packit ea1746
robot in the following format:
Packit ea1746
Packit ea1746
```
Packit ea1746
pose_id x y yaw_radians
Packit ea1746
pose_id x y yaw_radians
Packit ea1746
pose_id x y yaw_radians
Packit ea1746
...
Packit ea1746
```
Packit ea1746
Packit ea1746
where `pose_id` is the corresponding integer ID from the file definition. Note,
Packit ea1746
the file will be sorted in ascending order for the `pose_id`.
Packit ea1746
Packit ea1746
The executable `pose_graph_2d` expects the first argument to be the path to the
Packit ea1746
problem definition. To run the executable,
Packit ea1746
Packit ea1746
```
Packit ea1746
/path/to/bin/pose_graph_2d /path/to/dataset/dataset.g2o
Packit ea1746
```
Packit ea1746
Packit ea1746
A python script is provided to visualize the resulting output files.
Packit ea1746
```
Packit ea1746
/path/to/repo/examples/slam/pose_graph_2d/plot_results.py --optimized_poses ./poses_optimized.txt --initial_poses ./poses_original.txt
Packit ea1746
```