MoveIt 2 Python Library

moveit_py is a Python library for interfacing with the core functionalities of MoveIt 2. The goal of this library is to provide a simplified interface for MoveIt 2 Python users.

This Python library depends on pybind11 for generating Python bindings. The project is split into the following folders:

├── docs                 # Sphinx documentation files
├── moveit               # Python library stubs; Python functionalities built on top of bindings
├── src/moveit           # pybind11 binding code
├── test                 # Unit and integration testing

Tutorials

We are continuing to add tutorials for the MoveIt 2 Python library. Of particular note is the fact that one can interact with MoveIt interactively since Python is an interpreted language, our tutorials demonstrate this through leveraging Jupyter notebooks. For further details please consult the MoveIt 2 tutorials site.

Contribution Guidelines

Community contributions are welcome.

For detailed contribution guidelines please consult the official MoveIt contribution guidelines.

Citing the Library

If you use this library in your work please use the following citation:

@software{fagan2023moveitpy,
  author = {Fagan, Peter David},
  title = {{MoveIt 2 Python Library: A Software Library for Robotics Education and Research}},
  url = {https://github.com/ros-planning/moveit2/tree/main/moveit_py},
  year = {2023}
}

Acknowledgements

Thank you to the Google Summer of Code program for sponsoring the development of this Python library. Thank you to the MoveIt maintainers Henning Kayser (@henningkayser) and Michael Goerner (@v4hn) for their guidance as supervisors of my GSoC project. Finally thank you to the ML Collective for providing compute support for this project.

Changelog for package moveit_py

2.8.0 (2023-09-10)

• Fix moveit_py rclcpp::init() (#2223) * Fix moveit_py rclcpp::init() Rclcpp has been initialized without args which was problematic for some use cases like clock simulation. Parameters like use_sim_time:=true need to be passed to rclcpp, also NodeOptions access the global rcl state on construction. Co-authored-by: Jafar Uru