/pybullet_planning

A suite of utility functions to facilitate robotic planning related research on the pybullet physics simulation engine.

Primary LanguagePythonMIT LicenseMIT

pybullet_planning

Documentation Status Github Actions Integration Status Coveralls License MIT pybullet version

pybullet_planning is a suite of utility functions to facilitate robotic planning related research on the pybullet physics simulation engine. Planning research made easy.

Main features

  • easy-to-use functions to connect with pybullet, tailored for task and motion planning research
  • built-in implementations of standard motion planners, including PRM, RRT, biRRT, A* etc.

Getting Started

pybullet_planning can be installed using pip:

pip install pybullet_planning

Note

On Windows, you may need to install Microsoft Visual C++ 14.0, if pybullet installation fails.

Once the installation is completed, you can verify your setup. Start Python from the command prompt and run the following:

>>> import pybullet_planning as pp

First Steps

Examples can be found at the unit tests. You will be need to install pytest to run these tests (pip install pytest).

Then, individual tests can be run by using their pytest markers by:

pytest -s -m collision_fn --viewer
pytest -s -m motion_planning_2D --viewer

Additional pytest-free examples can be found at pybullet_planning_tutorials.

Contributing

Check the Contributor's Guide for more details.

PyBullet Resources

Credits

Caelan Reed Garrett. PyBullet Planning. https://pypi.org/project/pybullet-planning/. 2020.

This package was initiated and maintained by Caelan Garrett @caelan and other contributors.

History

This repo is a stable and documented fork of Caelan's pybullet-planning (previously called ss-pybullet) and motion-planners. New features will continue to be introduced first through these separate repos, and integrated into the current package later.