README.md

map_messages

Introduction

Dieses Package enthält alle benutzerdefinierten Messages, die neben den in ROS enthaltenen Messages für das Mapping und die Navigation verwendet werden. Das Package enthält keine Node oder Librabries.

Messages

PointOfInterest

Die PointOfInterest-Message enthält alle Informationen, um einen POI zu erstellen, zu verschicken und zu speichern.

PointOfInterest.msg



int32 DEFAULT=100
int32 VICTIM=200
int32 OBJECT=300
int32 GRIPPABLE_OBJECT=400
int32 PERSON=600
int32 ROOMBA=700
int32 HAZARD_MATERIAL=800
int32 START_POSITION=900
int32 START_ORIENTATION=1000

int32 type
string name
string remarks

geometry_msgs/Pose pose

• type bezeichnet den Typ des POIs. Es kann eine der in dieser Message vorhandenen Konstanten verwendet werden.
• name bezeichnet den Namen des POIs. Dieser Name muss einzigartig sein, da die POIs über ihren Namen unterschieden werden.
• remarks: Hier können Anmerkungen reingeschrieben werden. Diese werden in der GUI angezeigt.
• pose bezeichnet die Position und Orientierung des POIS im /map-Frame.

ModifyPOI

ModifyPOI ist dafür zuständig, einen vorhandenen POI zu verändern.

ModifyPOI.msg

PointOfInterest poi
string old_name

• poi beinhaltet den POI, durch den der alte ersetzt werden soll.
• old_name bezeichnet den Namen des POIs, der verändert werden soll.

TargetUnreachable

TargetUnreachable wird von der Navigation versendet, sobald kein Pfad mehr zu einem Ziel geplant werden kann.

TargetUnreachable.msg

int8 UNKNOWN=0
int8 TILT_OCCURED=10
int8 GRAVE_TILT_OCCURED=15
int8 STALL_OCCURED=20
int8 LASER_OBSTACLE=30

int8 reason

• reason kann einen von den in dieser Message definierten Konstanten annehmen und beschreibt den Grund des Fehlers.

SaveMap

SaveMap wird versendet, wenn eine Karte gespeichert oder geladen werden soll und beinhaltet den Dateipfad zum Kartenordner.

SaveMap.msg

string filename

• filename bezeichnet den Dateipfad zum Kartenordner.

PointsOfInterest

PointsOfInterest wird verwendet, um alle aktuellen POIs zu versenden.

PointsOfInterest.msg

PointOfInterest[] pois

• pois beinhaltet einen Vektor mit allen aktuellen POIs.

StartNavigation

StartNavigation ist eine von zwei Methoden, um eine Navigation zu starten. Hier wird Der POI mitgegeben, zu dem der Roboter navigieren soll.

StartNavigation.msg

geometry_msgs/Pose goal
float32 distance_to_target
bool skip_final_turn
bool fast_planning

• goal beinhaltet den Ziel-POI
• distance_to_target: Hier kann angegeben werden, ab welcher Distanz zum Ziel die Navigation als erfolgreich abgeschlossen wird.
• skip_final_turn: Hier kann eingestellt werden, ob der Roboter sich am Ziel-POI in Richtund der POI-Orientierung ausrichten soll oder nicht.
• fast_planning: Mit dieser Option kann ein experimentelles "Schnelles Planen" eingeschaltet werden. Es werden nur Pfade geplant, die sich in einer Boundingbox zwischen Roboter und Zielposition befinden.

MapLayers

MapLayers definiert die vorhanden Kartenebenen als Konstanten und kann zudem verwendet werden, um einzelne Ebenen ein- oder auszuschalten.