Skip to content

Latest commit

 

History

History
110 lines (95 loc) · 5.75 KB

Parameters.md

File metadata and controls

110 lines (95 loc) · 5.75 KB

Parameters

Planner Parameters

(config/dwa_param.yaml)

Target Parameters

  • ~<name>/TARGET_VELOCITY (double, default: 0.55 [m/s]):
    The max target velocity of robot

Simulation Parameters

  • ~<name>/PREDICT_TIME (double, default: 3.0 [s]):
    The amount of time to simulate trajectories
  • ~<name>/SIM_TIME_SAMPLES (int, default: 10):
    The number of samples to use when simulating trajectories
  • ~<name>/SIM_PERIOD (double, default: 0.1 [s]):
    The simulation time related to the dynamic window. The product of this parameter and the acceleration is the amount of movement of the dynamic window.
  • ~<name>/SIM_DIRECTION (double, default: 1.57 [rad]):
    The simulated turning angle when turning on the spot
  • ~<name>/SLOW_VELOCITY_TH (double, default: 0.1 [m/s]):
    The threshold for slow velocity. If the robot's velocity is less than this value, yawrate less than MIN_YAWRATE are not sampled.
  • ~<name>/VELOCITY_SAMPLES (int, default: 3):
    The number of samples to use when searching for the best velocity
  • ~<name>/YAWRATE_SAMPLES (int, default: 20):
    The number of samples to use when searching for the best yawrate

Cost Parameters

  • ~<name>/OBSTACLE_COST_GAIN (double, default: 1.0):
    The weighting for how large the obstacle cost should be. Multiplied by the normalized obstacle cost. When the robot is far from obstacles, the cost is low.
  • ~<name>/TO_GOAL_COST_GAIN (double, default: 0.8):
    The weighting for how large the goal cost should be. Multiplied by the normalized goal cost. When the robot is close to the goal, the cost is low.
  • ~<name>/SPEED_COST_GAIN (double, default: 0.4):
    The weighting for how large the speed cost should be. Multiplied by the normalized speed cost. When the robot is fast, the cost is low.
  • ~<name>/PATH_COST_GAIN (double, default: 0.4):
    The weighting for how large the path cost should be. Multiplied by the normalized path cost. When the robot is close to the path, the cost is low.
  • ~<name>/ANGLE_RESOLUTION (double, default: 0.087 [rad]):
    Search obstacle by this resolution
  • ~<name>/OBS_RANGE (double, default: 2.5 [m]):
    The maximum measurement distance to be considered when calculating obstacle cost

Goal Tolerance Parameters

  • ~<name>/GOAL_THRESHOLD (double, default: 0.1 [m]):
    The tolerance for the robot in position when achieving its goal
  • ~<name>/TURN_DIRECTION_THRESHOLD (double, default: 0.1 [rad]):
    The tolerance for the robot in yaw/rotation when achieving its goal

Other Parameters

  • ~<name>/ANGLE_TO_GOAL_TH (double, default: pi [rad]):
    The absolute angle to the goal that is considered as the goal direction. If the angle to the goal is less than this value, the robot turn to the goal.

Robot Parameters

(config/robot_param.yaml)

Frame Parameter

  • ~<name>/ROBOT_FRAME (string, default: base_link):
    The coordinate frame of robot

Robot Size Parameters

  • ~<name>/ROBOT_RADIUS (double, default: 0.1 [m]):
    If parameter "USE_FOOTPRINT" is set to true, this parameter is not used.
  • ~<name>/FOOTPRINT_PADDING (double, default: 0.01 [m]):
    If localmap contains padding, you should set this parameter to 0.0.

Robot Configuration Parameters

  • ~<name>/MAX_VELOCITY (double, default: 1.0 [m/s]):
    The maximum translational velocity of the robot
  • ~<name>/MIN_VELOCITY (double, default: 0.0 [m/s]):
    The minimum translational velocity of the robot
  • ~<name>/MAX_YAWRATE (double, default: 1.0 [rad/s]):
    The maximum yawrate of the robot
  • ~<name>/MIN_YAWRATE (double, default: 0.05 [rad/s]):
    The minimum yawrate of the robot
  • ~<name>/MAX_IN_PLACE_YAWRATE (double, default: 0.6 [rad/s]):
    The maximum yawrate of the robot when turning on the spot
  • ~<name>/MIN_IN_PLACE_YAWRATE (double, default: 0.3 [rad/s]):
    The minimum yawrate of the robot when turning on the spot
  • ~<name>/MAX_ACCELERATION (double, default: 0.5 [m/s^2]):
    The maximum acceleration of the robot
  • ~<name>/MAX_DECELERATION (double, default: 2.0 [m/s^2]):
    The maximum deceleration of the robot
  • ~<name>/MAX_D_YAWRATE (double, default: 3.2 [rad/s^2]):
    The maximum yawrate acceleration of the robot

Other Parameters

(launch/local_planner.launch)

Main Loop Parameter

  • ~<name>/HZ (double, default: 20 [Hz]):
    The rate of main loop

Frame Parameter

  • ~<name>/GLOBAL_FRAME (string, default: map):
    The coordinate frame of map

Topic Parameter

  • ~<name>/SUBSCRIBE_COUNT_TH (double, default: 3):
    The allowable number of control loops if topic is not reached. If the number exceeds this value, set velocity and yawrate to 0.0.

Goal Parameter

  • ~<name>/SLEEP_TIME_AFTER_FINISH (double, default: 0.5 [s]):
    The sleep time after reaching the goal. Prevent bugs that occur on other nodes by not continuously publishing the finish flag when the goal is reached.

Visualization Parameter

  • ~<name>/V_PATH_WIDTH (double, default: 0.05 [m]):
    The width of the local path visualization. The selected trajectory's width is this value. The candidate trajectories's width is 0.4 times this value. The footprint frame visualization's width is 0.2 times this value.

Option

  • ~<name>/USE_FOOTPRINT (bool, default: false):
    If footprint is used, set to true.
  • ~<name>/USE_PATH_COST (bool, default: false):
    If path cost is used, set to true.
  • ~<name>/USE_SCAN_AS_INPUT (bool, default: false):
    If scan is used instead of localmap, set to true.