No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.

ergodic_exploration package from ergodic_exploration repo

ergodic_exploration

Package Summary

Tags No category tags.
Version 1.0.0
License BSD-3
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/bostoncleek/ergodic_exploration.git
VCS Type git
VCS Version noetic-devel
Last Updated 2021-01-01
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Robot agnostic information theoretic exploration strategy

Additional Links

No additional links.

Maintainers

  • bostoncleek

Authors

  • bostoncleek

Ergodic Exploration

GitHub release Maintenance PR Open Source Love png2

Motivation

Currently there are no exploration packages for ROS Noetic. The ROS packages that currently exist perform only frontier exploration. The goal of this project is to provide a robot agnostic information theoretic exploration strategy for known and unknown environments.

This package requires a user specified target distribution representing the expected information gain. The target distribution is represented as a Gaussian or multiple Gaussians.

As an alternative, mutual information can be used as the target distribution. Checkout the feature/sportdeath_mi branch. That branch is experimental because the mutual information implementation has not been verified yet.

This package was developed at Northwestern University during the Master of Science in Robotics program.

Table of Contents

Exploration

Ergodic Control

Ergodicity is defined as the fraction of time spent sampling an area should be equal to a metric quantifying the density information in that area. The ergodic metric is the difference between the probability density functions representing the spatial distribution and the statistical representation of the time-averaged trajectory [1]. The objective function includes the ergodic metric and the control cost.

The ergodic controller performs receding horizon trajectory optimization in real time. The real time performance is achieved by integrating the co-state backwards in time [2].

In both the target information density and the mutual information demonstrations below, rtabmap_ros was used for localization and mapping using a Velodyne lidar. Odometry was performed using wheel encoders.

Target Information Density

Two targets representing the information density are modeled as Gaussians are shown in yellow. The optimized trajectory from the erogdic controller is show in red. The trajectory oscillates from side to side but this behavior is expected. The predicted trajectory from the dynamic window approach is shown in blue.

See the full video in real time.

The resulting path from the exploration stack is shown in blue and the small white lines represent local loop closures. The robot was observed visiting each target several times and exploring the corridor to the left of the targets.

Mutual Information

In the case of the occupancy grid, mutual information is the expected information gain at each grid cell. The feature/sportdeath_mi branch computes it using the Fast Continuous Mutual Information (FCMI) algorithm presented in [3]. This is accomplished by simulating a 360 degree range finder.

Below, the robot explores the atrium using mutual information as the target distribution shown in the upper left. The dark areas represent more mutual information. After the robot has fully explored the space, the mutual information is zero.

See the full video in real time.

The occupancy grid and mutual information map are on the left and right respectively. The robot's path is shown in blue and the small white lines represent local loop closures.

Exploration Stack

The ergodic controller cannot guarantee a collision free trajectory. The dynamic window approach is used as the local planner. The next twist from ergodic controller is propagated forward for a short time to detect collisions. If there is a collision, the dynamic window approach is used. The dynamic window approach forward propagates a constant twist for a short time and disregards it if there is a collision.

In the case where the ergodic control results in a collision, the dynamic window approach uses the optimized trajectory as a reference. The dynamic window approach finds a twist that will produce a trajectory most similar to the reference that is collision free. Similarity between the optimized trajectory and the dynamic window approach trajectory is defined as the distance between the robot's position and the absolute difference in heading at each time step. The twist produced by the dynamic window approach is followed for a number of steps to ensure the robot is away from obstacles.

It is possible that the twist from the dynamic window approach can cause a collision in a dynamic environment. In this case the dynamic window approach will search the velocity space for the most similar collision free twist to the previous twist given by the dynamic window approach. Similarity is defined as the inner product of the twist. If the dynamic window approach fails, a flag is set for the ergodic controller to replan. The ergodic controller is sensitive to the pose of the robot and is capable of optimizing a different trajectory. This strategy prevents the robot from getting stuck.

Collision Detection

To detect obstacle cells in the occupancy grid, Bresenham's circle algorithm is used. The robot's base is modeled as a circle. If there are obstacles within a threshold of the robot's bounding radius, the robot is considered to be in a collision state.

Below, the robot was given a control signal to drive forward. This control sends the robot on a collision course with two obstacles. The dynamic window approach finds a twist capable of maneuvering the robot around each obstacle.

Getting Started

Dependencies

This package was built and tested using Armadillo 10.1.1. You will need to install Armadillo.

Workspace

Create a catkin workspace or clone in an existing workspace.

mkdir -p ~/exploration_ws/src
cd ~/exploration_ws/src
git clone https://github.com/bostoncleek/ergodic_exploration.git

cd ~/exploration_ws
catkin init
catkin build -DCMAKE_BUID_TYPE=Release
source devel/setup.bash

Launch

Example exploration configurations for an omni directional and a differential drive robot are provided.

Spawn either an omni directional or a differential drive robot in Gazebo and start your favorite SLAM package. Use the example launch file to start the exploration node. Be sure to set the holonomic argument to false if using a differential drive robot.

roslaunch ergodic_exploration exploration.launch

Nodes

The nodes provided are explore_omni and explore_cart. The only difference between them is the motion model. Both use an occupancy grid for collision detection and provide a body twist as the control output.

Subscribed Topics

Published Topics

Parameters

The following parameters are set to 0 for the cart because of the holonomic constraint: max_vel_y, min_vel_y, acc_lim_y, and vy_samples. You only need to provide the control weights for the x-velocity and rotational velocity components.

General

  • map_frame_id (string, default: "map"): map frame id
  • base_frame_id (string, default: "base_link"): base link frame id
  • frequency (double, default: 10.0): control loop frequency (Hz)
  • val_dt (double, default: 0.1): control validation time step for collision detection (s)
  • val_horizon (double, default: 0.5): control validation horizon for collision detection (s)
  • max_vel_x (double, default: 1.0): max x velcocity (m/s)
  • max_vel_y (double, default: 1.0): max y velcocity (m/s)
  • max_rot_vel (double, default: 1.0): max ratotional velcocity (rad/s)
  • min_vel_x (double, default: -1.0): min x velcocity (m/s)
  • min_vel_y (double, default: -1.0): min y velcocity (m/s)
  • min_rot_vel (double, default: -1.0): min ratotional velcocity (rad/s)
  • acc_lim_x (double, default: 1.0): x acceleration limit (m/s^2)
  • acc_lim_y (double, default: 1.0): y acceleration limit (m/s^2)
  • acc_lim_th (double, default: 1.0): rotational acceleration limit (rad/s^2)

Collision Parameters

  • boundary_radius (double, default: 0.7): bounding radius around robot (m)
  • search_radius (double, default: 1.0): max search radius for collision detection (m)
  • obstacle_threshold (double, default: 0.2): obstacles within radius from boundary are cosidered collisions (m)
  • occupied_threshold (double, default: 0.8): occupancy grid cell probability to be considered an obstacle [0 1]

Ergodic Control Parameters

  • ec_dt (double, default: 0.1): time step used in ergodic control integration (s)
  • ec_horizon (double, default: 2.0): ergodic control horizon (s)
  • target_resolution (double, default: 0.1): target grid resolution (m)
  • expl_weight (double, default: 1.0): ergodic exploration weight influences how ergodic the exploration is
  • num_basis (unsigned int, default: 10): number of basis functions used in composes the trajectory and spatial fourier coefficients
  • buffer_size (unsigned int, default: 1e6): total number of past states stored in memory
  • batch_size (unsigned int, default: 100): number of past states randomly sampled in each ergodic control loop and is used to compose the trajectory fourier coefficients
  • control_weights (double array[], default: [1, 1, 1]): weights on twist [vx vy w] used by the ergodic controller

Dynamic Window Parameters

  • dwa_dt (double, default: 0.1): time step used in dynamic window integration (s)
  • dwa_horizon (double, default: 1.0): dynamic window control horizon (s)
  • acc_dt (double, default: 0.2): time step when the acceleration limits are applied (s)
  • vx_samples (unsigned int, default: 3): number of x velcocity samples
  • vy_samples (unsigned int, default: 8): number of y velcocity samples
  • vth_samples (unsigned int, default: 5): number of rotational velcocity samples
  • means (double array[], default: none): target x and y means (m)
  • sigmas (double array[], default: none): target x and y standard deviations (m)

Required tf Transforms

  • map -> base_link : usually provided in combination by odometry and SLAM systems

Future Improvements

  • Model robot's base as a polygon for collision detection.
  • Use a distance field for detecting obstacle cells. Bresenham's algorithm is fast but can alias. It is also redundant to preform Bresenham's when searching the velocity space in the dynamic window approach. The twists are propagated forward for a short time, therefore the redundancy stems from ray tracing circles multiple times within the same vicinity.
  • Implement the fast shannon mutual information algorithm. Provide a node capable of using this with any motion model.

Citing Ergodic Exploration

@software{ergodicexploration2020github,
  author = {Boston Cleek and Matt Elwin},
  title = {ErgodicExploration: Robot agnostic information theoretic exploration},
  url = {https://github.com/bostoncleek/ergodic_exploration},
  version = {0.0.1},
  year = {2020},
}

Credits

[1] L. M. Miller and T. D. Murphey, “Trajectory optimization for continuous ergodic exploration,” in American Control Conference, 2013, pp. 4196–4201. PDF

[2] Decentralized ergodic control: Distribution-driven sensing and exploration for multi-agent systems I. Abraham and T. D. Murphey IEEE Robotics and Automation Letters, vol. 3, no. 4, pp. 2987–2994, 2018. PDF, Video

[3] An Efficient and Continuous Approach to Information-Theoretic Exploration T Henderson, V Sze, S Karaman 2020 IEEE International Conference on Robotics and Automation (ICRA), 8566-8572, 2020. PDF, Video

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/exploration.launch
      • load_map [default: false] — load map using map server
      • holonomic [default: true] — true if robot is omni directional
      • map [default: $(find ergodic_exploration)/maps/maze.yaml]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ergodic_exploration at answers.ros.org

No version for distro melodic. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.