IF_RobotMotion - TransformCoordinate (Methode)

Überblick

Typ:

Methode

Verfügbar ab:

V2.3.1.0

Dieses Kapitel enthält Informationen zu folgenden Aspekten:

Aufgabe

Umwandeln einer Position aus einem Quellkoordinatensystem in eine Position in einem Zielkoordinatensystem.

Beschreibung

Mit der Methode TransformCoordinate(...) kann eine durch die kartesischen X-, Y- und Z-Koordinaten in einem vordefinierten Koordinatensystem beschriebene Position in die entsprechende Position in einem anderen Koordinatensystem umgewandelt werden.

Bei erfolgreichem Aufruf wird mit LogLevel.UserAction ein Application-Logger-Eintrag erzeugt. Er umfasst die Eingaben sowie die Ergebnisse der Umwandlung.

War die Transformation nicht erfolgreich, wird mit LogLevel.Exception ein Application-Logger-Eintrag erzeugt und eine entsprechende Fehlerzeichenkette erstellt.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_stPosition

PDL.ST_Vector3D

Die im Quellkoordinatensystem beschriebene kartesische Position wird am Eingang i_etCoordinateSystem übergeben.

i_etSourceCoordinateSystem

ET_CoordinateSystem

Quellkoordinatensystem

i_etTargetCoordinateSystem

ET_CoordinateSystem

Zielkoordinatensystem

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer Ausgang für die Diagnose.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

q_sMsg

STRING[80]

Ereignisabhängige Meldung, die zusätzliche Informationen über den Diagnosezustand gibt.

Rückgabewert

Datentyp

Beschreibung

PDL.ST_Vector3D

Im Zielkoordinatensystem beschriebene umgewandelte Position.

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert

Beschreibung

OK

Ok

0

Ok

OK

IdenticalCoordinateSystem

183

Das Koordinatensystem ist identisch.

ExecutionAborted

ExternalPositionSourceConfigured

205

Die externe Positionsquelle wurde konfiguriert.

InputParameterInvalid

CoordinateSystemInvalid

117

Das Koordinatensystem ist ungültig.

InputParameterInvalid

CoordinateSystemNotConfigured

172

Das Koordinatensystem ist nicht konfiguriert.

UnexpectedProgramBehavior

UnexpectedFeedback

13

Ein Rückgabewert war ungültig.

CoordinateSystemInvalid

Enumerationsname:

CoordinateSystemInvalid

Enumerationswert:

117

Beschreibung:

Das Koordinatensystem ist ungültig.

Problem

Ursache

Lösung

Die Umwandlung der Koordinaten war nicht erfolgreich.

Der am Eingang i_etSourceCoordinateSystem oder i_etTargetCoordinateSystem übergebene Wert ist ungültig.

An den Eingängen i_etSourceCoordinateSystem und i_etTargetCoordinateSystem muss ein Wert von ET_CoordinateSystem übergeben werden.

Nähere Informationen siehe q_sMsg.

CoordinateSystemNotConfigured

Enumerationsname:

CoordinateSystemNotConfigured

Enumerationswert:

172

Beschreibung:

Das Koordinatensystem ist nicht konfiguriert.

Problem

Ursache

Lösung

Die Umwandlung der Koordinaten war nicht erfolgreich.

Das am Eingang i_etSourceCoordinateSystem oder i_etTargetCoordinateSystem angeforderte Koordinatensystem ist nicht konfiguriert.

Bei Bedarf mit der entsprechenden Methode ein Koordinatensystem vom Typ ET_CoordinateSystem konfigurieren.

Nähere Informationen siehe q_sMsg.

ExternalPositionSourceConfigured

Enumerationsname:

ExternalPositionSourceConfigured

Enumerationswert:

205

Beschreibung:

Die externe Positionsquelle wurde konfiguriert.

Problem

Ursache

Lösung

Die Umwandlung der Koordinaten war nicht erfolgreich.

Für die Roboterkomponenten Kartesisch, Orientierung und Hilfsachsen wurde eine externe Positionsquelle konfiguriert.

Die Umwandlung der Koordinaten von einem bzw. in ein Tracking-Koordinatensystem ist nicht möglich, wenn für die Rotoberkomponenten eine externe Positionsquelle konfiguriert wurde.

Keine Koordination von einem bzw. in ein Tracking-Koordinatensystem umwandeln.

IdenticalCoordinateSystem

Enumerationsname:

IdenticalCoordinateSystem

Enumerationswert:

183

Beschreibung:

Das Koordinatensystem ist identisch.

Die Umwandlung war erfolgreich. Das Ergebnis der Umwandlung ist gleich der Eingabe.

Ok

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

Ok

Die Umwandlung war erfolgreich.

UnexpectedFeedback

Enumerationsname:

UnexpectedFeedback

Enumerationswert:

13

Beschreibung:

Ein Rückgabewert war ungültig.

Die Umwandlung der Koordinaten war nicht erfolgreich.

Die Umwandlung wurde aufgrund eines ungültigen Rückmeldewerts abgebrochen.