homer_navigation repository

Repository Summary

Checkout URI https://gitlab.uni-koblenz.de/robbie/homer_navigation.git
VCS Type git
VCS Version 0.1.85
Last Updated 2019-07-01
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Package Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
homer_navigation 0.1.85

README

homer_navigation

Introduction

Das Package "homer_navigation" mit seiner gleichnamigen Node ist für die Navigation des Roboters zuständig. Es hält stets die aktuelle Karte des Roboters vor, die auf Topic /map empfangen wurde und berechnet anhand von dieser Karte einen Pfad vom Roboter zu einem gegebenen Zielpunkt. Dafür verwendet die Navigation die sogenannte Pfad-Transformation - eine Kombination aus Distanz-Transformation und Hindernistransformation -, in Verbindung mit A-Stern, um einen optimalen Pfad zu finden. Das Verhältnis zwischen Distanz- und Hindernis-Transformation kann über einen Parameter angepasst werden. Nach der Pfadberechnung ist das Package außerdem dafür zuständig den Roboter diesen Pfad zum Ziel abfahren zu lassen.

Topics

Publisher

  • /homer_navigation/target_reached (std_msgs/String): Wenn der Roboter sein Ziel erreicht hat, wird eine Message über dieses Topic veschickt.
  • /homer_navigation/target_unreachable (mapnav_msgs/TargetUnreachable): Über dieses Topic wird mitgeteilt, wenn der Roboter sein Ziel nicht erreichen kann und die Navigation abgebrochen wurde. Ein Statuscode wird mitgeliefert (siehe Package map_messages).
  • /homer_navigation/path (nav_msgs/Path): Hierüber wird der aktuelle Pfad zur Visualisierung an die GUI geschickt.
  • /robot_platform/cmd_vel (geometry_msgs/Twist): Über dieses Topic werden die aktuellen Fahrbefehle zum Roboter geschickt.
  • /ptu/set_pan_tilt (ptu/SetPanTilt): Über dieses Topic wird die PTU nach navigation auf 0, 0 gefahren.
  • /ptu/center_world_point (ptu/CenterWorldPoint): Über dieses Topic wird die PTU auf den nächsten Wegpunkt centriert.

Subscriber

  • /map (nav_msgs/OccupancyGrid): Die jeweils aktuelle Map wird empfangen, um sie für die Pfadplanung und Hindernisvermeidung während der Navigation zu verwenden.
  • /pose (geometry_msgs/PoseStamped): Die aktuelle Pose des Roboters wird als Startpunkt der Pfadplanung verwendet.
  • /scan (sensor_msgs/LaserScan): Der aktuelle LaserScan wird zur Hindernisvermeidung verwendet.
  • /front_scan (sensor_msgs/LaserScan): Der aktuelle LaserScan wird zur Hindernisvermeidung verwendet.
  • /homer_navigation/start_navigation (mapnav_msgs/StartNavigation): Startet die Pfadplanung und anschließend die Navigation zur mitgelieferten Zielpose.
  • /move_base_simple/goal (geometry_msgs/PoseStamped): Started die Pfadplanung und anschließende Navigation zur Zielpose.
  • /homer_navigation/stop_navigation (std_msgs/Empty): Stoppt die aktuelle Navigation.
  • /homer_navigation/navigate_to_POI (mapnav_msgs/NavigateToPOI): Startet die Pfadplanung und anschließend die Navigation zum POI mit angegebenen Namen. Der entsprechende POI wird anschließend vom map_manager erfragt.
  • /homer_navigation/unknown_threshold (std_msgs/Int8): Über dieses Topic kann der Schwellwert verändert werden, ab dem ein Zellwahrscheinlichkeit als belegt und damit unbefahrbar markiert wird. Standard ist 50 (%).
  • /homer_navigation/refresh_params (std_msgs/Empty): Über dieses Topic lassen sich die Parameter neu auslesen.
  • /homer_navigation/max_depth_move_distance (std_msgs/Float32): Über dieses Topic lässt sich die Hindernissdistance der Tiefendaten übermitteln.

Launch Files

  • homer_navigation.launch: Startet die Navigation und lädt alle Navigations-Paramter in den Parameterserver.

Parameter

homer_navigation

  • /homer_navigation/safe_path_weight: 1.2 # factor weight for safer path in relation to shortest path
  • /homer_navigation/waypoint_sampling_threshold: 1.5 # factor of how dense the path waypoints are sampled regarding the obstacle_distance of the last or next waypoint
  • /homer_navigation/frontier_safeness_factor: 1.4 # factor of min_allowed_obstacle_distance to an obstacle of a cell which is considered safe

cost calculation parameters

  • /homer_navigation/allowed_obstacle_distance/min: 0.3 # m robot must stay further away than this from obstacles
  • /homer_navigation/allowed_obstacle_distance/max: 5.0 # m not used at the moment
  • /homer_navigation/safe_obstacle_distance/min: 0.7 # m if possible robot should move further away than this from obstacles
  • /homer_navigation/safe_obstacle_distance/max: 1.5 # m further away than this from obstacles doesn't give a lesser cost addition

collision Avoidance parameters

  • /homer_navigation/collision_distance: 0.3 # m distance to obstacle from robotFront in which the obstacle avoidance will be executed
  • /homer_navigation/collision_distance_near_target: 0.2 # m distance to obstacle from robotFront where obstacle avoidance won't be executed when near the target
  • /homer_navigation/backward_collision_distance: 0.5 # m distance behind robot in which the robot won't back up into while doing collision avoidance
  • /homer_navigation/min_y: 0.27 # m half robot width for max_move_distance calculation
  • /homer_navigation/min_x: 0.3 # m distance from base_link to robot front for max_move_distance calculation

check path on map update

  • /homer_navigation/check_path: true # bool toggles if the calculated path will be checked for obstacles while navigating
  • /homer_navigation/check_path_max_distance: 2 # m maximal distance from robot position in which the path is being checked for obstacles

speed parameters

  • /homer_navigation/min_turn_angle: 0.15 # rad values lower than this angle will let the navigation assume reaching the designated position
  • /homer_navigation/max_turn_speed: 0.6 # rad/s max turn velocity the navigation can send
  • /homer_navigation/min_turn_speed: 0.3 # rad/s min turn speed for Final Turn so the Robot doesn't stop turning
  • /homer_navigation/max_drive_angle: 0.6 # rad threshold for driving and turning - if above that value only turn

  • /homer_navigation/max_move_speed: 0.4 # m/s max move speed the navigation can send

caution factors values near 0 mean high caution values greater values mean less caution

if any factor equals 0 the robot can't follow paths !!

  • /homer_navigation/map_speed_factor: 1.2 # factor for the max speed calculation of the obstacleDistancemap
  • /homer_navigation/waypoint_speed_factor: 1.2 # factor for the max speed calculation with the distance to the next waypoint
  • /homer_navigation/obstacle_speed_factor: 1.0 # factor for the max speed calculation with the last laser may movement distance

  • /homer_navigation/callback_error_duration: 0.3 # s max duration between pose and laser callbacks before error handling is executed

  • /homer_navigation/use_ptu: false# bool toggles if the ptu is being used to look at the next Waypoint during navigation

CONTRIBUTING

No CONTRIBUTING.md found.