ATAN2-Baustein

Kurz-Information

NameATAN2
→POE-Typ→Funktion
KategorieIEC-Baustein, Numeric
Konform zur →IEC-Norm

(tick) 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 in 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→DatentypBeschreibung
Eingänge:Y
REAL, LREAL
(entspricht dem →allgemeinen Datentyp ANY_REAL
Y-Koordinate
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.