Sensordynamik¶
Das Dynamik-Modul rc_dynamics liefert Schätzungen des Sensorzustands, der die Pose (Position und Orientierung), Lineargeschwindigkeit, Linearbeschleunigung und Drehrate des Sensors umfasst. Mit diesem Modul lassen sich Datenströme für die verschiedenen Submodule starten, stoppen und verwalten:
- Visuelle Odometrie (
rc_stereovisodo
) - schätzt die Kamerabewegung anhand der Bewegung von charakteristischen Bildpunkten im linken Kamerabild.
- Visuelle Odometrie (
- Stereo-INS (
rc_stereo_ins
) - kombiniert die per visueller Odometrie ermittelten Werte mit den Daten der integrierten inertialen Messeinheit (IMU), um auf dieser Grundlage akkurate und hochfrequente Echtzeit-Zustandsschätzungen bereitzustellen.
- Stereo-INS (
Bemerkung
Die gleichzeitige Nutzung des Dynamik-Moduls und des Stereo-Matching kann zu verringerter Genauigkeit der Bewegungsschätzung führen. Der Abschnitt Visuelle Odometrie erklärt, wie dies vermieden werden kann.
Koordinatensysteme für die Zustandsschätzung¶
Das Weltkoordinatensystem für die Zustandsschätzung definiert sich wie folgt: Die Z-Achse des Koordinatensystems zeigt nach oben und ist am Gravitationsvektor ausgerichtet. Die X-Achse liegt orthogonal zur Z-Achse und zeigt in die Blickrichtung des rc_visard zum Zeitpunkt, zu dem die Zustandsschätzung beginnt. Der Ursprung des Weltkoordinatensystems befindet sich am Ursprung des IMU-Koordinatensystems des rc_visard in dem Augenblick, in dem die Zustandsschätzung aktiviert wird.
Wird die Zustandsschätzung aktiviert, wenn die Blickrichtung des rc_visard parallel zum Gravitationsvektor liegt (mit einem Toleranzbereich von 10 Grad), dann ist die Y-Achse des Weltkoordinatensystems entweder an der positiven oder negativen X-Achse des IMU-Koordinatensystems ausgerichtet. In diesem Fall ist die Anfangsausrichtung des Weltkoordinatensystems nicht mehr kontinuierlich. Es ist also besondere Vorsicht geboten, wenn die Zustandsschätzung mit dieser Orientierung beginnt.
Die Transformation zwischen dem IMU-Koordinatensystem und dem Kamera/Sensor-Koordinatensystem wird ebenfalls geschätzt und über die rc_dynamics-Schnittstelle im Echtzeit-Dynamik-Datenstrom bereitgestellt (siehe Schnittstellen).
Warnung
Das Stereo-INS-Modul führt während der Initialisierung eine Selbstkalibrierung der IMU durch. Deswegen darf sich der rc_visard während des Startens des Stereo-INS-Moduls nicht bewegen und muss ausreichend viel Textur sehen können.
Verfügbare Zustandsschätzungen¶
Der rc_visard bietet über die rc_dynamics-Schnittstelle sieben verschiedene Arten an Datenströmen mit zeitgestempelten Zustandsschätzungen an (siehe Die rc_dynamics-Schnittstelle):
Name | Frequenz | Quelle | Beschreibung |
---|---|---|---|
pose | 25 Hz | Best Effort | genaueste Schätzung der Pose des Kamerakoordinatensystems, aber leicht zeitverzögert |
pose_ins | 25 Hz | Stereo-INS | genaueste Schätzung der Pose des Kamerakoordinatensystems, aber leicht zeitverzögert |
pose_rt | 200 Hz | Best Effort | Pose des Kamerakoordinatensystems |
pose_rt_ins | 200 Hz | Stereo-INS | Pose des Kamerakoordinatensystems |
dynamics | 200 Hz | Best Effort | Pose, Geschwindigkeit und Beschleunigung im IMU-Koordinatensystem |
dynamics_ins | 200 Hz | Stereo-INS | Pose, Geschwindigkeit und Beschleunigung im IMU-Koordinatensystem |
imu | 200 Hz | Stereo-INS | IMU-Rohdaten |
Best Effort bedeutet hier für den Fall, dass das SLAM-Modul läuft, dass der Datenstrom per Loop-Closure korrigierte Schätzungen umfasst, bzw. dass er dem vom Stereo-INS bereitgestellten Datenstrom entspricht, wenn SLAM nicht läuft.
Kameraposen-Datenströme (pose
und pose_ins
)¶
Die Kameraposen-Datenströme heißen pose
und pose_ins
und sie werden mit einer Frequenz von 25 Hz mit Zeitstempeln bereitgestellt, die den Bildzeitstempeln entsprechen. pose
bietet eine Best-Effort-Schätzung, für die SLAM und Stereo-INS kombiniert werden, wenn das SLAM-Modul läuft. Läuft das SLAM-Modul nicht, sind beide Datenströme gleichwertig. Die Posen werden in Weltkoordinaten angegeben und beziehen sich auf den Ursprung des Kamerakoordinatensystems (siehe Koordinatensysteme für die Zustandsschätzung). Die Datenströme umfassen genaueste Schätzungen, für die alle verfügbaren Daten des rc_visard berücksichtigt werden. Sie können für Modellierungsanwendungen eingesetzt werden, bei denen Kamerabilder, Tiefenbilder oder Punktwolken mit höchster Genauigkeit aneinander ausgerichtet werden müssen. Um die größtmögliche Genauigkeit sicherzustellen, verzögert sich die Ausgabe dieser Datenströme, bis die zugehörigen Messwerte aus der visuellen Odometrie verfügbar sind.
Echtzeit-Datenströme der Kamerapose (pose_rt
und pose_rt_ins
)¶
Die Echtzeit-Datenströme der Kamerapose heißen pose_rt
und pose_rt_ins
und sie werden mit der IMU-Frequenz von 200 Hz bereitgestellt. pose_rt
bietet eine Best-Effort-Schätzung, für die SLAM und Stereo-INS kombiniert werden, wenn das SLAM-Modul läuft. Läuft das SLAM-Modul nicht, sind beide Datenströme gleichwertig. Die Posen werden in Weltkoordinaten angegeben und beziehen sich auf den Ursprung des Koordinatensystems der rc_visard-Kamera (siehe Koordinatensysteme für die Zustandsschätzung). Die in diesen Datenströmen enthaltenen Werte entsprechen den Werten in den Echtzeit-Dynamik-Datenströmen, geben aber die Pose im Sensor/Kamera-Koordinatensystem statt im IMU-Koordinatensystem an.
Echtzeit-Dynamik-Datenströme (dynamics
und dynamics_ins
)¶
Die beiden Echtzeit-Dynamik-Datenströme heißen dynamics
und dynamics_ins
und sie werden mit der IMU-Frequenz von 200 Hz bereitgestellt. dynamics
bietet eine Best-Effort-Schätzung, für die SLAM and Stereo-INS kombiniert werden, wenn das SLAM-Modul läuft. Läuft das SLAM-Modul nicht, sind beide Datenströme gleichwertig. Die Schätzungen können für die Echtzeitregelung eines Roboters verwendet werden. Da die Werte in Echtzeit bereitgestellt werden und die Berechnung der visuellen Odometrie eine gewisse Bearbeitungszeit erfordert, ist die letzte Odometrieschätzung möglicherweise nicht enthalten. Daher sind diese Schätzungen im Allgemeinen etwas weniger genau als die nicht in Echtzeit bereitgestellten Kameraposen-Datenströme (siehe oben). Dennoch sind es zu diesem Zeitpunkt die bestmöglichen Schätzungen. Die bereitgestellten Dynamik-Datenströme enthalten folgende Werte zum rc_visard:
- Translation \(\mathbf{p} = (x, y, z)^T\) in \(m\),
- Rotation \(\mathbf{q} = (q_x, q_y, q_z, q_w)^T\) als Einheitsquaternion,
- Lineargeschwindigkeit \(\mathbf{v} = (v_x, v_y, v_z)^T\) in \(\frac{m}{s}\),
- Winkelgeschwindigkeit \(\mathbf{\omega} = (\omega_x, \omega_y, \omega_z)^T\) in \(\frac{rad}{s}\),
- gravitationskompensierte Linearbeschleunigung \(\mathbf{a} = (a_x, a_y, a_z)^T\) in \(\frac{m}{s^2}\) und
- Transformation zwischen Kamera- und IMU-Koordinatensystem als Pose mit Frame-Namen und Parent-Frame-Namen.
Der Datenstrom enthält für jede Datenkomponente zusätzlich den Namen des Koordinatensystems, in dem die Werte angegeben sind. Translations-, Rotations- und Lineargeschwindigkeiten werden im Weltkoordinatensystem, Winkelgeschwindigkeiten und Winkelbeschleunigungen im IMU-Koordinatensystem angegeben (siehe Koordinatensysteme für die Zustandsschätzung). Alle Werte beziehen sich auf den Ursprung des IMU-Koordinatensystems. Dies bedeutet beispielsweise, dass die Lineargeschwindigkeit der Geschwindigkeit des IMU-Koordinatenursprungs im Weltkoordinatensystem entspricht.
Schließlich enthält der Datenstrom den Statusindikator possible_jump
, der auf TRUE gesetzt ist, wann immer das optional erhältliche SLAM-Modul (siehe SLAM) die Zustandsschätzung nach einem Schleifenschluss (Loop Closure) korrigiert. Die Zustandsschätzung kann in diesem Fall einen Sprung machen, was beachtet werden sollte, wenn die Werte in einem Regelkreis verwendet werden. Wenn SLAM nicht läuft, bleibt der Statusindikator possible_jump
auf FALSE und kann ignoriert werden.
IMU-Datenstrom (imu
)¶
Der IMU-Datenstrom heißt imu
und wird mit der IMU-Frequenz von 200 Hz bereitgestellt. Er umfasst die Beschleunigungen in X-, Y- und Z-Richtung sowie die Winkelgeschwindigkeiten um diese drei Achsen. Diese Werte sind kalibriert, aber nicht bias- und gravitationskompensiert, und werden im IMU-Koordinatensystem angegeben. Die Transformation zwischen dem IMU-Koordinatensystem und dem Sensorkoordinatensystem wird im Echtzeit-Dynamik-Datenstrom bereitgestellt.
Statuswerte¶
Diese Modul meldet folgende Statuswerte:
Name | Beschreibung |
---|---|
state |
Der aktuelle Zustand des Sensordynamik-Moduls |
Services¶
Das Sensordynamik-Modul bietet folgende Services zum Starten der Dynamik-/Bewegungsschätzung. Alle Services geben einen numerischen Code des eingetretenen Zustands zurück. Die Bedeutung der zurückgegebenen Zustandscodes und deren Namen werden in Tab. 13 angegeben.
Zustandsname | Beschreibung |
---|---|
IDLE | Das Dynamikmodul ist bereit aber inaktiv |
WAITING_FOR_INS | Es wird auf Daten des Stereo-INS-Moduls gewartet |
WAITING_FOR_INS_AND_SLAM | Es wird auf Daten des Stereo-INS- und des SLAM-Moduls gewartet |
RUNNING | Das Stereo-INS-Modul läuft |
WAITING_FOR_SLAM | Es wird auf den Start des SLAM-Moduls gewartet (Stereo-INS läuft) |
RUNNING_WITH_SLAM | Die Module Stereo-INS und SLAM laufen |
STOPPING | Übergangszustand von Kommandos, die zu (oder durch) IDLE gehen |
FATAL | Ein schwerwiegender Fehler ist aufgetreten (im Stereo-INS- oder SLAM-Modul) |
start
¶
startet das Stereo-INS-Modul. Der Status geht von
IDLE
überWAITING_FOR_INS
zuRUNNING
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "start", "response": { "accepted": "bool", "current_state": "string" } }
start_slam
¶
startet SLAM und – falls es noch nicht läuft – das Stereo-INS-Modul. Ausgehend von
IDLE
geht der Zustand überWAITING_FOR_INS_AND_SLAM
undWAITING_FOR_SLAM
zuRUNNING_WITH_SLAM
. AusRUNNING
geht er überWAITING_FOR_SLAM
zuRUNNING_WITH_SLAM
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "start", "response": { "accepted": "bool", "current_state": "string" } }
stop
¶
stoppt das Stereo-INS-Modul und – falls es läuft – das SLAM-Modul. Die Trajektorienschätzung des SLAM-Moduls (bis zum Zeitpunkt des Stoppens) ist weiterhin verfügbar. Ausgehend von
RUNNING
oderRUNNING_WITH_SLAM
geht der Zustand überSTOPPING
zuIDLE
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "stop", "response": { "accepted": "bool", "current_state": "string" } }
stop_slam
¶
stoppt das SLAM-Modul. Das Stereo-INS-Modul läuft weiter. Die Trajektorienschätzung des SLAM-Moduls (bis zum Zeitpunkt des Stoppens) ist weiterhin verfügbar. Der Zustand geht von
RUNNING_WITH_SLAM
zuIDLE
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "stop", "response": { "accepted": "bool", "current_state": "string" } }
restart
¶
startet die Stereo-INS neu. Äquivalent zu aufeinanderfolgendem
stop
undstart
.Aus dem Zustand
RUNNING
oderRUNNING_WITH_SLAM
: Übergang überSTOPPING
,IDLE
undWAITING_FOR_INS
zuRUNNING
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "restart", "response": { "accepted": "bool", "current_state": "string" } }
restart_slam
¶
startet neu in den SLAM-Modus. Äquivalent zu aufeinanderfolgendem
stop
undstart_slam
.Aus dem Zustand
RUNNING
oderRUNNING_WITH_SLAM
: Übergang über die ZuständeSTOPPING
,IDLE
,WAITING_FOR_INS_AND_SLAM
undWAITING_FOR_SLAM
zuRUNNING_WITH_SLAM
.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "restart_slam", "response": { "accepted": "bool", "current_state": "string" } }
Das folgende Diagramm zeigt die wichtigsten Zustände und Übergänge. Zwischenzustände und der Fehlerzustand FATAL
sind aus Gründen der Übersichtlichkeit nicht aufgeführt.
Die Services sollten schnell reagieren. Deswegen ist bei Services, die eine Zustandsänderung verursachen, der Rückgabewert current_state
im Allgemeinen der erste neue (Zwischen-)Zustand, in den gewechselt wurde, und nicht der finale Zustand. Zum Beispiel gibt der start
Service als current_state
WAITING_FOR_INS
und nicht RUNNING
zurück. Falls der Zustandsübergang nicht innerhalb von 0.1 Sekunden vonstatten geht, wird der aktuelle Zustand zurückgegeben. In Tab. 13 ist die Bedeutung der zurückgegebenen Zustandscodes aufgeführt.
Bemerkung
Der Zustand FATAL
kann nur durch den Aufruf des stop
Services verlassen werden. Dieser Service geht in den Zustand IDLE
. Die Services restart
und restart_slam
nutzen intern auch stop
und funktionieren daher ebenso. Die Services start
und start_slam
funktionieren nur, wenn der aktuelle Zustand IDLE
ist, und haben keinen Effekt, wenn der Zustand FATAL
ist.
Bemerkung
Das Sensordynamik-Modul lässt sich auch über die Seite Dynamik der Web GUI starten und stoppen.
get_cam2imu_transform
¶
gibt die Transformation zwischen Kamera- und IMU-Koordinatensystem zurück. Diese entspricht der
cam2imu_transform
der Dynamics-Nachricht.Dieser Service hat keine Argumente.
Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "get_cam2imu_transform", "response": { "name": "string", "parent": "string", "pose": { "pose": { "orientation": { "w": "float64", "x": "float64", "y": "float64", "z": "float64" }, "position": { "x": "float64", "y": "float64", "z": "float64" } }, "timestamp": { "nsec": "int32", "sec": "int32" } }, "return_code": { "message": "string", "value": "int16" } } }