Pebble Tuning Guide
The Pebble Planner is a simple local planner that is designed to follow the global plan closely. Advantages of Pebble Planner include fewer configurable parameters and less oscillating motions.

How it works

Pebble planner takes the global plan, decimates it to space out the poses as “pebbles”, then tries to reach them one by one.
It does this by rotating towards the next pebble, then accelerating until max velocity is reached.

Setting up

Filepath: catkin_ws/movel_ai/config/movel/config/
File to modify: base_local_planner_params.yaml
Same steps as setting up for TEB Local Planner. In the file, uncomment the section PebbleLocalPlanner to set your local planner to use Pebble.
Filepath: catkin_ws/movel_ai/config/velocity_setter/config/
File to modify: velocity_setter.yaml
Change the param local_planner: "PebbleLocalPlanner".
Make sure you changed the params in both files or else error may be thrown.

Overview of parameters

base_local_planner_params
1
PebbleLocalPlanner:
2
d_min: 0.30
3
robot_frame: base_link
4
map_frame: map
5
xy_goal_tolerance: 0.15
6
yaw_goal_tolerance: 0.3925
7
kp_linear: 1.0
8
ki_linear: 0.0
9
kd_linear: 0.0
10
kp_angular: 1.0
11
ki_angular: 0.0
12
kd_angular: 0.1
13
max_vel_x: 0.3
14
max_vel_theta: 0.785
15
acc_lim_x: 0.5
16
acc_lim_theta: 0.785
17
allow_reverse: true
18
th_turn: 1.0472 #1.0472 : 60 deg, how far the robot faces from the waypoint before suppressing linear motion
19
local_obstacle_avoidance: true # whether to let the local planner do obsav. If false, rely on the global planner, and planning frequency must not be zero
20
N_lookahead: 3 # how many multiples of d_min to look ahead when eval'ing obstacles
Copied!
Compared to TEB, pebble planner has fewer configurable params.

Configurable Parameters

Can be generally classified as Probably Important, Optional and Can Be Ignored.

Probably Important

d_min - Min distance of the next pose, to qualify as a pebble. If you feel the robot is oscillating too much, increasing this value helps.
allow_reverse - Determines whether the robot can move backwards or not. Set this value to false if you don't want your robot to be moving backwards. Recommended if your robot doesn't have sensors at the back.
acc_lim_theta - Limits the angular rotation. Pebble planner will rotate the robot towards the next pebble, then accelerates towards it (till max speed). Planned path may be straighter if angular acceleration is lowered.

Optional

xy_goal_tolerance - Tolerable distance away from the intended goal.
yaw_goal_tolerance - Angular tolerance between where you want the robot to face and where it actually faces.
acc_lim_x - Limits how fast the robot speeds up to the next pebble. Robots need time to think and stop when it sees an obstacle. Robots may have less time to react if it is previously speeding.
local_obstacle_avoidance - Whether you want Pebble Planner to handle obstacle avoidance or not. Else, obstacle avoidance will be handled by global planner.
N_lookahead - How many pebbles to look ahead when evaluating obstacles.

Can Be Ignored

max_vel_x, max_vel_theta - These values will be set by the UI depending on what values you give there. Can ignore if you are using the UI.
(kp, ki, kd values) - Probably just configurations for differential drive.