About | Support | answers.ros.org	Search:

electric fuerte groovy hydro   Documentation Status

Getting Started with Turtlesim

Start the roscore:

$ roscore

To compile and start the turtlesim:

$ rosmake turtlesim
$ rosrun turtlesim turtlesim_node

You'll see the turtlesim window:

• 

Nodes

turtlesim_node

turtlesim_node provides a simple simulator for teaching ROS concepts.

Subscribed Topics

turtleX/command_velocity (turtlesim/Velocity)

• The linear and angular command velocity for turtleX. The turtle will execute a command_velocity for 1 second then time out.

Published Topics

turtleX/pose (turtlesim/Pose)

• The x, y, theta, linear velocity, and angular velocity of turtleX.

Services

clear (std_srvs/Empty)

• Clears the turtlesim background and sets the color to the value of the background parameters.

reset (std_srvs/Empty)

• Resets the turtlesim to the start configuration and sets the background color to the value of the background.

kill (turtlesim/Kill)

• Kills a turtle by name.

spawn (turtlesim/Spawn)

• Spawns a turtle at (x, y, theta) and returns the name of the turtle. Also will take name for argument but will fail if a duplicate name.

turtleX/set_pen (turtlesim/SetPen)

• Sets the pen's color (r g b), width (width), and turns the pen on and off (off).

turtleX/teleport_absolute (turtlesim/TeleportAbsolute)

• Teleports the turtleX to (x, y, theta).

turtleX/teleport_relative (turtlesim/TeleportRelative)

• Teleports the turtleX a linear and angular distance from the turtles current position.

Parameters

~background_b (int, default: 255)

• Sets the blue channel of the background color.

~background_g (int, default: 86)

• Sets the green channel of the background color.

~background_r (int, default: 69)

• Sets the red channel of the background color.

mimic

mimic provides a simple interface for making one turtlesim mimic another.

Subscribed Topics

input (turtlesim/Velocity)

• The input topic for the mimic node. The topic must be remapped to the command_velocity topic of the desired turtle to mimic.

Published Topics

output (turtlesim/Velocity)

• The output topic for the mimic node. The topic must be remapped to the command_velocity topic of the mimicking turtle.