Skip to content

API Reference

Reference documentation generated from the docstrings and type stubs of each module.

Modules Overview

High-Level API

Module Description
tesseract_robotics.planning Robot, MotionProgram, TaskComposer, plan_freespace/plan_ompl/plan_cartesian

Core Modules

Module Description
tesseract_robotics.common Common types (Isometry3d, etc.)
tesseract_robotics.geometry Geometric primitives
tesseract_robotics.scene_graph Links, joints, scene graph
tesseract_robotics.environment Environment, commands
tesseract_robotics.collision Collision managers, contacts
tesseract_robotics.kinematics Kinematic groups, solvers

Planning Modules

Module Description
tesseract_robotics.command_language Waypoints, instructions
tesseract_robotics.motion_planners Base planner types
tesseract_robotics.motion_planners_ompl OMPL planner
tesseract_robotics.motion_planners_trajopt TrajOpt planner
tesseract_robotics.motion_planners_descartes Descartes planner
tesseract_robotics.motion_planners_simple Simple interpolation
tesseract_robotics.task_composer Task composition
tesseract_robotics.task_composer_planning Profiles of the planning nodes (contact check, fixes, upsampling)
tesseract_robotics.time_parameterization TOTG, ISP, constant TCP speed, Ruckig
tesseract_robotics.motion_planners_trajopt_ifopt TrajOpt-Ifopt planner and profiles

Tooling

Module Description
tesseract_robotics.viewer Browser viewer for environments and trajectories
tesseract_robotics.emitters Controller program emitters (RAPID, KRL, JBI, LS, URScript)
tesseract_robotics.build_identity Upstream sources a wheel was built from

Low-Level SQP Modules

Module Description
tesseract_robotics.trajopt_ifopt Variables, constraints, costs (Var, Node, collision, Cartesian)
tesseract_robotics.trajopt_sqp QP problem and SQP solver (TrajOptQPProblem, TrustRegionSQPSolver, OSQP)

Import Patterns

Python
from tesseract_robotics.planning import (
    Robot,
    MotionProgram,
    JointTarget,
    plan_freespace,
    TaskComposer,
)

locator = GeneralResourceLocator(paths=[get_tesseract_resource_path()])  # the tesseract-robotics-nanobind-support wheel
robot = Robot.from_tesseract_support("abb_irb2400", locator)
program = (
    MotionProgram("manipulator", tcp_frame="tool0", working_frame="base_link")
    .move_to(JointTarget([0, 0, 0, 0, 0, 0]))
    .move_to(JointTarget([0.5, 0, 0, 0, 0, 0]))
)
result = plan_freespace(robot, program)

# Or reuse a composer (amortizes plugin loading):
composer = TaskComposer.from_config(warmup=True)
result = composer.plan(robot, program, pipeline="TrajOptPipeline")

Direct Module Access

Python
from tesseract_robotics.environment import Environment
from tesseract_robotics.scene_graph import Link, Joint
from tesseract_robotics.geometry import Box, Sphere

SQP API

Python
from tesseract_robotics.trajopt_ifopt import Bounds, CartPosConstraint, createNodesVariables
from tesseract_robotics.trajopt_sqp import TrajOptQPProblem, TrustRegionSQPSolver, OSQPEigenSolver

Type Conventions

C++ Type Python Type
Eigen::Isometry3d common.Isometry3d
Eigen::VectorXd numpy.ndarray
Eigen::MatrixXd numpy.ndarray
std::vector<std::string> list[str]
std::shared_ptr<T> Python object (ref counted)
std::optional<T> T or None

Memory Management

Objects are reference-counted via nanobind/pybind. Generally:

  • Objects returned by functions are owned by Python
  • Objects stored in containers maintain references
  • No manual memory management needed

Vector Members

C++ std::vector members return copies. Use explicit methods:

Python
from tesseract_robotics.scene_graph import Link, Visual

link, visual = Link("part"), Visual()

# Wrong (silent no-op)
link.visual.append(visual)
assert len(link.visual) == 0

# Correct
link.addVisual(visual)
assert len(link.visual) == 1