[Documentation] [TitleIndex] [WordIndex

Only released in EOL distros:  

Overview

The srs_ui_but stack contains tools used for information visualization in RVIZ and interactive manipulation with robot components.

System architecture

It consists of 4 components:

BUT display

This set contains additional displays and visualizers for RVIZ. The displays can be also used as an example code for display writing (but_example_pane, but_display) and as an example of RVIZ camera tracking and casting (but_camcast).

Other set of components are visualizers:

Distance Linear Visualizer

This tool visualizes distances between specified robot's link and the relevant closest point.

distance_linear_visualizer.png

Distance Circular Indicator

This tools shows set of circles in particular distances around specified robot's link.

distance_circular_indicator.png

COB Stretch Indicator

This tools visualizes stretch of the Care-O-bot. It also allows to show robot's bounding box

cob_stretch_indicator.png

Camera Display

Rviz display type derrived from Map Display. It awaits messages of type srs_ui_but::ButCamMsg (published by node view) with position and size of camera view polygon. It also needs topic with video stream subscribed. Video is used to draw the frames over the rectangle as its texture.

Object Manager

This tool allows to add objects stored in the srs_object_database. Objects are visualized as Object and can be moved or rotated.

Object Manager also provides service which "detects" all added objects.

object_manager.png

Data fusion

This component experiments with 3D scene and video stream fusion, used in visualization of scene around Care-O-bot. So far there's one possibility to visualize point cloud and video from camera in one 3D view implemented. It shows view frustum in front of the robot visualized with standard Markers, and also rectangular polygon inside of this view frustum dynamically textured with current video frame.

data_fusion1.png

Data fusion consists of two main parts. First is node called view. This node needs to be running to succesfully visualize data fusion as it counts both view frustum and camera view polygon position and orientation in time. The other is new display CButCamDisplay described among displays.

ROS API

...brief description of provided ROS services, published topics, etc...

Nodes

An overview of all newly created ROS nodes.

Node Name

Published Topics

Description

but_services_server

This node publishes but services.

cob_stretch_publisher

This node publishes COB's actual stretch.

view

  • /but_data_fusion/view_frustum
  • /but_data_fusion/cam_view

Counts both view frustum and camera view polygon position and orientation in time.

Services

List of all new services.

Service Name

Input

Output

Description

/but_services/get_closest_point

  • string link

This service calculates closest point between specified robot's link and actual point cloud.

/but_services/set_point_cloud_topic

  • string topic

Sets the topic from which the closest point should be calculated.

/but_services/get_added_objects

* cob_object_detection_msgs/DetectionArray object_list

"Detects" all objects added by Object Manager.

Messages

List of all newly defined messages.

Msg Name

Content

Description

ClosestPoint

  • time time_stamp
  • bool status
  • float32 distance
  • geometry_msgs/Vector3 position

Closest point data (distance and position of the closest point).

ButCamMsg

  • Header header
  • geometry_msgs/Pose pose
  • geometry_msgs/Vector3 scale

Reduced Marker message, covering all needs of CButCamDisplay.

COBStretch

  • float32 radius
  • float32 height
  • time time_stamp

Data with calculated robot's stretch.

Published topics

List of all published topics.

Topic Name

Message

Description

/but_data_fusion/view_frustum

visualization_msgs::Marker

Line list representing view frustum

/but_data_fusion/cam_view

srs_ui_but::ButCamMsg

Geometry of camera view polygon used by CButCamDisplay display in Rviz.

/but_services/cob_stretch

srs_ui_but::COBStretch

COB's stretch

SRS API

...brief description of SRS-project specific API...

Generic states

...list of all generic states...

State Name

Input

Output

Description

name

in

out

sa sadf sad

Installation

Build package:

rosmake srs_ui_but

Distance Linear Visualizer

First you need to run but_service_server:

rosrun srs_ui_but but_services_server

Then run rviz:

rosrun rviz rviz

Load plugin and add Distance Linear Visualizer display.

Distance Circular Indicator

Run rviz:

rosrun rviz rviz

Load plugin but_gui and add Distance Circular Indicator display.

COB Stretch Indicator

First you need to run simulation and cob_stretch_publisher:

rosrun srs_ui_but cob_stretch_publisher

Then run rviz:

rosrun rviz rviz

Load plugin and add COB Stretch Indicator display.

Camera Display

Run everything together with launch file:

roslaunch srs_ui_but but_data_fusion.launch

Or launch manually all needed components:

rosrun srs_ui_but view
roslaunch cob_2dnav 2dnav.launch

Run rviz:

rosrun rviz rviz

Load plugin but_gui and add CButCamDisplay display.

Object Manager

For example usage just run

roslaunch srs_ui_but object_manager_test.launch

Configuration

...optional parameters...

GUI Primitives for HRI

...component specific parameters...

Dynamic Environment Model

...component specific parameters...

Dependencies

...list of required non-standard packages, libraries, etc.

Usage

Distance Liner Visualizer

In display properties you can set these options:

Distance Circular Indicator

In display properties you can set these options:

COB Stretch Indicator

In display properties you can set these options:

Camera Display

You can optionally visualize view frustum by adding Marker display and subscribe it to /but_data_fusion/view_frustum topic.

Subscribe CButCamDisplay through Marker Topic to /but_data_fusion/cam_view. Through Image Topic you can subscribe display to any of camera topics:

There are basically three properties you can set, the rest is only informational:

Object Manager

For adding new objects use Object control panel:

object_manager_panel.png

You can set these options:

Add object

Selected the object from the combo box and click on the button Add object.

Remove object

If you want to remove some object, just select it from the combo box and click on the Remove object button.

Note:


2024-11-02 17:26