[Documentation] [TitleIndex] [WordIndex

  Documentation Status

Cannot load information on name: mocap_optitrack, distro: electric, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
mocap_optitrack

Package Summary

Documented

This package contains a node that translates motion capture data from an OptiTrack rig to tf transforms, poses and 2D poses. The node receives packets that are streamed by the Tracking Tools software, decodes them and broadcasts the poses of configured rigid bodies as tf transforms, poses, and/or 2D poses.

Currently, this node supports the NatNet streaming protocol v2.2

Copyright (c) 2013, Clearpath Robotics
Copyright (c) 2010, University of Bonn, Computer Science Institute VI
All rights reserved.

mocap_optitrack

Package Summary

Documented

Streaming of OptiTrack mocap data to tf

This package contains a node that translates motion capture data from an OptiTrack rig to tf transforms, poses and 2D poses. The node receives packets that are streamed by the Tracking Tools software, decodes them and broadcasts the poses of configured rigid bodies as tf transforms, poses, and/or 2D poses.

Currently, this node supports the NatNet streaming protocol v2.2

Copyright (c) 2013, Clearpath Robotics
Copyright (c) 2010, University of Bonn, Computer Science Institute VI
All rights reserved.

Cannot load information on name: mocap_optitrack, distro: hydro, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: mocap_optitrack, distro: indigo, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: mocap_optitrack, distro: jade, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: mocap_optitrack, distro: kinetic, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: mocap_optitrack, distro: lunar, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.

Installation

The easiest way to get the mocap_optitrack package in Ubuntu is using apt-get:

$ sudo apt-get install ros-fuerte-mocap-optitrack

If you'd like to contribute to the package, feel free to check it out from Github and submit pull requests.

To install Tracking Tools, see the instructions on the Natural Point website.

Configuring Tracking Tools

After installing Tracking Tools you will need to configure it for streaming of rigid bodies to the (virtual)machine running the mocap_optitrack ROS node.

  1. Open the "Streaming Properties" pane in Tracking Tools and enable the "Broadcast Frame Data" checkbox. Set the "Stream Rigid Bodies" option to "True" if it's not set already.
  2. Set "Type" to "Multicast", the ports should be left as-is.
  3. Unless the machine running Tracking Tools has multiple network interfaces, the "Local Interface" may be set as "Preferred". The "Multicast Interface" should be set to the address of the machine running the mocap_optitrack node.

streaming_properties_1.png streaming_properties_2.png

Configuring mocap_optitrack

Once motion capture data is being streamed to the mocap_optitrack node, the mapping of trackables to ROS topics must be defined. A sample configuration file called "mocap.yaml" is included with the package, you can find it in the config directory of the package.

$ roscd mocap_optitrack/config
$ vi mocap.yaml

Selecting Rigid Bodies to Publish

Since multiple robots may be tracked by the OptiTrack system, the mocap_optitrack configuration allows for publishing poses and transforms for each robot separately.

First, the robot must be set up as a trackable in Tracking Tools - see the Tracking Tools documentation for how to do this.

Next, note the Trackable ID for each trackable in Tracking Tools.

Trackable ID

The published topics for each trackable can now be configured in mocap_optitrack. Each trackable that should be published in ROS can be specified by its Trackable ID - the desired topics for the published Pose, 2D Pose and the frame_id of the transform in tf can be configured.

rigid_bodies:
    '1':
        pose: Robot_1/pose
        pose2d: Robot_1/ground_pose
        frame_id: Robot_1/base_link
    '2':
        pose: Robot_2/pose

If any of the topics is left unconfigured, nothing will be published for that datatype. E.g. for trackable "2", no pose2d or frame_id is configured so no Pose2D or TF messages will be published.

Further reading

The specifications of the NatNet streaming protocol may be downloaded from the Natural Point website


2017-09-23 12:58