The gazebo_ros_actor_plugin package contains a plugin for Gazebo Classic (Version 11) and a ROS package that enables dynamic control of actors in Gazebo. The plugin allows you to control actors using either position or velocity commands.
Before using this package, make sure that you meet the following requirements:
- ROS 1 Noetic
- Gazebo Classic (Version 11)
- gazebo_ros_pkgs
If you want to use this package with a Docker container, follow these steps:
- Build the Docker image using
docker build -t bcr_ros-noetic_gz-11:latest . - Launch the container by running
cd docker_scriptsand./launch_container.sh. This will mount the package to/root/ros2_ws/src/. - To enter a bash session, run
./bashing_container.sh. - To stop the container, run
./stop_container.sh.
To use the gazebo_ros_actor_plugin, follow these steps:
-
Build the package using
catkin_make. -
Source
setup.bashfor the workspace containing this package. -
Edit the parameters in the
move_actor.worldfile and choose the method of subscription using thefollow_modetag corresponding to the plugin of the actoractor1. It could be either subscribing to path or velocity commands. -
Launch the
sim.launchfile by running:roslaunch gazebo_ros_actor_plugin sim.launch
To use the plugin, you need to start a publisher that sends velocity or path commands to the actor. This package includes two example publishers:
To run this publisher, enter the following command:
rosrun teleop_twist_keyboard teleop_twist_keyboard.py
Then give keyboard inputs to command linear and angular velocities. This publisher is based on the ros-noetic-teleop-twist-keyboard package.
To run this publisher, enter the following command after sourcing the workspace:
rosrun gazebo_ros_actor_plugin path_publisher.py
Note that the path_publisher.py file can be found in the /scripts directory in the package.
To work with different skins on the actor change the default_rotation parameter in the world file to adjust the actor.
The move_actor.world file contains the following parameters:
follow_mode: The mode in which the actor will follow the commands. It can be set to eitherpathorvelocity.vel_topic: The name of the topic to which velocity commands will be published. The default topic name is/cmd_vel.path_topic: The name of the topic to which path commands will be published. The default topic name is/cmd_path.animation_factor: Multiplier to base animation speed that adjusts the speed of both the actor's animation and foot swinging.linear_tolerance: Maximum allowed distance between actor and target pose during path-following.linear_velocity: Speed at which actor moves along path during path-following.angular_tolerance: Maximum allowable difference in orientation between actor's current and desired orientation during rotational alignment.angular_velocity: Speed at which actor rotates to achieve desired orientation during rotational alignment.default_rotation: Angle offset for skin collada files. It's set to 1.57 by default but should be adjusted for the skin. It can be changed by adding or subtracting pi/2 to make the actor stand upright. For "DoctorFemaleWalk" actor, the value is "0".
The gazebo_ros_actor_plugin subscribes to information from the following inbound topics:
/cmd_vel: to receive linear and angular velocity commands/cmd_path: to receive path commands
Note that the names of the topics can be overridden in the move_actor.world file present in this package's /config directory.
For more detailed information and examples, please refer to the following resources:
- Detailed Article: This article provides in-depth support and explanation of the contents of this repository.
- Demo Videos: This video playlist demonstrates Actor Plugin in action and also shows potential use case of this work, showcasing crowd behavior.
Here are some additional references that may be useful: