If you use this software, please cite the associated Master Thesis on ResearchGate.
It is also a good reference on the design choices of this software package.
This repository contains three dynamic path planners (replanners):
- FD* - Field D*
- MS-DFM - Multistencil Dynamic Fast Marching
- MFD* - Marching Field D* (AKA Shifted-Grid 8-connected Fast Marching)
This repository contains a generic implementation of the Field D* algorithm, originally proposed by Dave Ferguson and Anthony Stentz.
The "Level 0" algorithm implements the basic D* Lite implementation of the original paper.
The "Level 1" algorithm keeps backpointers from each node to the edge minimizing the cost, and use them to reduce the replanning load. Whenever a node is overconsistent, it recomputes only the quadrants of the neighbors affected by lowering G to RHS. Refer to "initial optimizations" version of the original Field D* paper for more details.
When the robot moves and updates the map, keys are recalculated w.r.t. the new position (if heuristic is used) and the minimum traversability of the map at the current state. This is a novel approach, different to heuristics suggested in various other works.
The interpolation algorithm has been redesigned to fix a suboptimal minimization of the traversal cost by the origianl authors. More detail in <THESIS CHAP 2>.
This repository contains a generic implementation of Dynamic Fast Marching, originally proposed by Clement Petres et al..
The algorithm has been tuned to leverage both orthogonal and diagonal neighbors of a cell, adding a "diagonal stencil". This technique was inspired by this paper.
This repository contains a variant of Field D* with pruned codepaths to comply with the general solution of the Eikonal Equation on a mesh.
The idea comes from the observation of the conceptual similarity of Shifted-Grid Fast Marching with Field D*. This change of perspective allows to reinterpret it as a simpler subset of Field D*.
The path extractors feature a custom path extraction technique, inspired by (Michael W. Otte and Greg Grudic).
The repository holds implementations for the 3 planners, as long as a support library and a path extraction algorithm.
Relevant files are in folders FieldDStar, DynamicFastMarching, ShiftedGridFastMarching, PathExtraction and ProjectToolkit.
The Tests/Planners folder also host demo applications that work in conjunction with the run_test.py comparative benchmark.
Alternative sources and CMakeLists for a basic RTEMS build have an extension prefix *.rtems.*
To build the demo and run tests:
cd Tests
chmod +x run_test.sh
./run_test.sh
The test files can be found in Tests/Tests.
The logs and the results can be found in Tests/Results after a successful run of the above commands.
- opencv-python
- Pillow
- setuptools