cras_topic_tools

Nodes and nodeletes for safe and efficient manipulation with topics. Mostly supplementing what is missing from topic_tools and nodelet_topic_tools.

Support and Build Status

This package is supported on Melodic and Noetic until their End of Life (and maybe later). It is occasionally tested with non-default GCC versions like Melodic+GCC8 or Noetic+GCC11.

Development versions:

Release jobs Melodic :

Release jobs Noetic :

Provided Nodes and Nodelets

Here is an overview of the provided nodes and nodelets. See their API docs for details. Most of these nodes/nodelets are message-type-agnostic, but they may differ between messages that have or do not have a std_msgs/Header header field.

• change_header: Allows modifying headers of messages (frame ID, timestamp).
• count_messages: Count the number of received messages and make it available as a ROS parameter.
• filter: (only node, no nodelet) Filter messages on a topic based on a Python expression.
• mux_replay: (only node, no nodelet) Control a mux with a recording of its ~selected topic as if it were live.
• priority_mux: Inspired by twist_mux, provides a hierarchical way of switching output topics. Works for all message types and for multiple output topics.
• relay: Simple relay with the possibility of lazy subscription.
• repeat: Increase the frequency of a topic (with various trigger modes etc.).
• throttle_messages: Throttle down frequency of a topic - to an exact value, not using the imprecise algorithm from topic_tools throttle.

A few convenience libraries for working with generic topics are also provided:

• shape_shifter: Easily get the buffer of header of a ShapeShifter message.
• lazy_subscriber: Base class for all lazy subscribers.
• generic_lazy_pub_sub: Base implementation of a generic pair of publisher-subscriber of a type not known at compile type.

Changelog for package cras_topic_tools

2.0.10 (2022-11-24)

2.0.9 (2022-11-24)

2.0.8 (2022-11-24)

2.0.7 (2022-11-24)

2.0.6 (2022-11-24)

2.0.5 (2022-10-23)

2.0.4 (2022-10-14)

2.0.3 (2022-10-07)

• Lower test_repeat thresholds even more, OSRF buildfarm is really bad at this
• cras_py_common: Extended functionality to get closer to cras_cpp_common.
• Improved readmes and added more badges to them.
• Contributors: Martin Pecka

2.0.2 (2022-08-29)

• Added option to change_header to apply current ROS time to stamp.
• De-flake throttle test and enable catkin_lint when it has chance to run correctly.
• Satisfy more pedantic Noetic linter.
• Added website links.
• Add linters and licenses.
• Fixed dependency.
• Added linters.
• Fix catkin_lint, re-enable testing.
• Improved comments in nodelet.xml.
• De-flake and speed up throttle test.
• De-flake and speed up repeater test.
• De-flake and speed up relay test.
• De-flake and speed up filter test.
• De-flake and speed up change_header test.
• Avoid threading errors when stopping nodes created by node_from_nodelet.
• Fix compilation on GCC 7.
• Contributors: Martin Pecka

2.0.1 (2022-08-26)

• Moved hack_frame_id from cras_py_common to cras_topic_tools.
• Moved launch files.
• Merged cras_nodelet_topic_tools with cras_topic_tools, moved repeater and joy_repeater from cras_cpp_common to cras_topic_tools.

1.0.0

• Add option to publish only on timer event.
• Protected mux_replay against looping.
• Added mux_replay
• Added filter node. Added ~reset_timer_on_msg to repeat.
• Added topic repeater.
• Contributors: Martin Pecka