Skip to content

Commit 4e68dba

Browse files
clean up notebooks partially; need to update readme
1 parent 57c941d commit 4e68dba

16 files changed

+2421
-13849
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
__pycache__/
22
.vscode/
3+
.ipynb_checkpoints/

README.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,42 @@
1-
# numba_mppi
1+
# Numba implementation of Model Predictive Path Integral (MPPI) Control with Probabilistic Traction Model
2+
3+
High-level overview of the project. Mention the original MPPI algorithm, model choice, and mention the ICRA paper & IROS paper. (Expected traction can be used too, similar to WayFAST that uses the expected traction parameters based on environment.)
4+
5+
Visualization for the traction grid representation.
6+
7+
Notes on how to use nominal traction & how to include obstacles and unknown space (pass separate mask to the planner. Configure the cost in the MPPI file.)
8+
9+
Visualization for the padding technique to avoid bound checking in GPU kernel.
10+
11+
Recommanded tutorial on Numba to familiarize with GPU architecture and kernels before adapting the code.
12+
13+
If people just want to run the planner (or reproduce the benchmark results) point to different jupyter notebooks.
14+
15+
16+
17+
Mention that, for ease of maintenance, the code base includes the core functionality that enables planning over a traction distribution map.
18+
19+
20+
## Software setup
21+
22+
Configure virtual environment (numpy, numba, jupyter notebook, pandas, )
23+
24+
Check the GPU configuration by running test scripts below....
25+
26+
27+
28+
## Breakdown of the file structure and the purpose of each file.
29+
30+
Also explain the purpose of each jupyter notebook.
31+
32+
33+
## What papers to cite if the code is useful
34+
35+
36+
## License info
237

338

439

5-
## Getting started
640

741
To make it easy for you to get started with GitLab, here's a list of recommended next steps.
842

benchmark.ipynb

Lines changed: 926 additions & 412 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)