zyjiao4728 / tesseract

Light Weight Environment for ROS

Tesseract

The planning framework (Tesseract) was designed to be lightweight, limiting the number of dependencies, mainly only using standard library like, eigen, boost, orocos and to the packages below. The core packages are ROS agnostic and have full python support.

Tesseract Core Packages

• tesseract – This is the main class that manages the major component Environment, Forward Kinematics, Inverse Kinematics and loading from various data.
• tesseract_collision – This package contains privides a common interface for collision checking prividing several implementation of a Bullet collision library and FCL collision library. It includes both continuous and discrete collision checking for convex-convex, convex-concave and concave-concave shapes.
• tesseract_common – This package contains common functionality needed by the majority of the packages.
• tesseract_environment – This package contains the Tesseract Environment which provides functionality to add,remove,move and modify links and joint. It also manages adding object to the contact managers and provides the ability.
• tesseract_geometry – This package contains geometry types used by Tesseract including primitive shapes, mesh, convex hull mesh, octomap and signed distance field.
• tesseract_kinematics – This package contains a common interface for Forward and Inverse kinematics for Chain, Tree's and Graphs including implementation using KDL and OPW Kinematics.
• tesseract_motion_planners – This package contains a common interface for Motion Planners and includes implementation for OMPL, TrajOpt and Descartes.
• tesseract_scene_graph – This package contains the scene graph which is the data structure used to manage the connectivity of objects in the environment. It inherits from boost graph and provides addition functionality for adding,removing and modifying Links and Joints along with search implementation.
• tesseract_support – This package contains support data used for unit tests and examples throughout Tesseract.
• tesseract_visualization – This package contains visualization utilities and libraries.

Tesseract ROS Packages

• tesseract_examples – This package contains examples using tesseract and tesseract_ros for motion planning and collision checking.
• tesseract_plugins – This contains plugins for collision and kinematics which are automatically loaded by the monitors.
• tesseract_rosutils – This package contains the utilities like converting from ROS message types to native Tesseract types and the reverse.
• tesseract_msgs – This package contains the ROS message types used by Tesseract ROS.
• tesseract_rviz – This package contains the ROS visualization plugins for Rviz to visualize Tesseract. All of the features have been composed in libraries to enable to the ability to create custom displays quickly.
• tesseract_monitoring – This package contains different types of environment monitors. It currently contains a contact monitor and environment monitor. The contact monitor will monitor the active environment state and publish contact information. This is useful if the robot is being controlled outside of ROS, but you want to make sure it does not collide with objects in the environment. The second is the environment monitor, which is the main environment which facilitates requests to add, remove, disable and enable collision objects, while publishing its current state to keep other ROS nodes updated with the latest environment.

TODO's

.. Warning:: These packages are under heavy development and are subject to change.

See issue #66

Clone Repository

This repository contains submodules so use the --recursive flag as shown below.

git clone --recursive

Building Tests

Must pass the -DENABLE_TESTS=ON to cmake when wanting to build tests.

.. NOTE: If you are building using catkin tools, use catkin build --force-cmake -DENABLE_TESTS=ON.

Build Branch Sphinx Documentation

cd gh_pages
sphinx-build . output

Now open gh_pages/output/index.rst and remove output directory before commiting changes.