Skip to content
Snippets Groups Projects
README.md 6.78 KiB
Newer Older
# 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