Kurz-Information

Name	`ATAN2`
→POE-Typ	→Funktion
Kategorie	IEC-Baustein, Numeric
Konform zur →IEC-Norm	keine Einschränkungen
Grafische Schnittstelle
Verfügbar ab	Version 1.18.0 (für logi.CAD 3) – Anfangsvariante: Eingänge `IN1` und `IN2` Version 1.58.0 (für logi.CAD 3) – Erweiterung: Namen der Eingänge auf `Y` und `X` geändert Version 3.1.0 (für Bibliothek `Standard`) – Für Eingänge vom Datentyp `REAL` wird die optimierte `float` - Variante der C-Runtime verwendet. Im Vergleich zu früheren Versionen können i n den Grenzwertbereichen des Bausteins (geringfügig) andere Ergebnisse geliefert werden.

Funktionalität

Die Winkelfunktion arctan wird aufgerufen: Der Baustein berechnet den Arkustangens mit 2 Parametern. Im Gegensatz zum ATAN-Baustein beachtet dieser Baustein die Vorzeichen beider Parameter und bestimmt so den Quadranten des Ergebnisses.

Der Ergebniswert des Bausteins ist der Winkel in der kartesischen Ebene zwischen der X-Achse und einem vom Ursprung (0,0) zum Punkt (X,Y) zeigenden Vektor. Der Baustein liefert das Ergebnis im Bogenmaß im Bereich von -PI bis +PI (inklusive). Für Winkel entgegen dem Uhrzeigersinn ergeben sich positive Winkel (obere Halbebene, Y > 0), für Winkel im Uhrzeigersinn negative Winkel (untere Halbebene, Y < 0).

Eingänge, Ergebniswert

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`Y`	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)	Y-Koordinate
Eingänge:	`X`	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)	X-Koordinate
Ergebniswert:	–	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Beispiel für Verwendung im ST-Editor

PROGRAM Test
   VAR
      result : REAL;
   END_VAR
   result := ATAN2(Y := 1000.0, X := 50.0);    (* The variable 'result' evaluates to '1.520838'. *)
END_PROGRAM

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.