ArcTan2 (FPScript)
Calcule l'arctangent avec deux arguments.
Syntaxe
ArcTan2(Y, X)
La syntaxe de la fonction ArcTan2 se compose des éléments suivants :
Section |
Description |
|---|---|
Y |
Le premier argument de la fonction. Correspond à la coordonnée Y d'un point dans un système de coordonnées cartésiennes bidimensionnel. Toutes les structures de données sont autorisées. Tous les types de données réels sont autorisés. |
X |
Le deuxième argument de la fonction. Correspond à la coordonnée X d'un point dans un système de coordonnées cartésiennes bidimensionnel. Toutes les structures de données sont autorisées. Tous les types de données réels sont autorisés. |
Remarques
Le résultat a l'unité rad.
La fonction trouve l'angle φ lors de la conversion à partir de coordonnées cartésiennes (x, y) aux coordonnées polaires (r, φ).
La fonction ArcTan2(y, x) peut être définie comme suit : Si x et y sont des nombres réels avec r = sqrt(x^2 + y^2), alors ce qui suit s'applique :
x = r * cos(ArcTan2(y, x)),
y = r * sin(ArcTan2(y, x)).
Cela signifie que : (r, ArcTan2(y, x)) est le graphique des coordonnées polaires du point avec les coordonnées cartésiennes (x, y).
La fonction ArcTan2 est définie comme suit :
La plage de valeurs de ArcTan2(y, x) est l'intervalle semi-ouvert ]-PI, PI].
Si au moins un argument est une série de données ou une matrice de données, le calcul est effectué sur une base par élément et le résultat est également une série de données ou une matrice de données. Le nombre de lignes et éventuellement le nombre de colonnes des deux arguments doivent correspondre, sauf si un argument est une valeur scalaire. Dans ce cas, l'argument scalaire est élargi pour inclure le nombre de valeurs de l'argument non scalaire.
Si la fonction est appliquée à des signaux, des séries de signaux ou des courbes 3D, le résultat est à son tour un signal, une série de signaux ou une courbe 3D. La composante Y du résultat est le résultat de l'application de la fonction aux composantes Y des deux arguments. La composante X et éventuellement Z du résultat correspond favorablement à la composante X et éventuellement Z du premier argument ; sinon, il s'agit de la composante X et éventuellement Z du deuxième argument.
Visualisation de la fonction ArcTan2 avec 2 variables
Calcule la fonction ArcTan2 y = ArcTan2(z, x) à travers la plage (x, z) bidimensionnelle [-4, 4] x [-4, 4]. La visualisation dans un graphique de contour 3D donne les résultats suivants :
Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
ArcTan2(7, -5) |
Renvoie 2.191. |
Dim z = -5 + 7i |
L'appel par Phase est équivalent à ArcTan2(Imag(z), Real(z)), c'est-à-dire, dans ce cas, à ArcTan2(7, -5) |
ArcTan2(DataSeries1, DataSeries2) |
Calcule le ArcTan2() de deux séries de données de longueurs égales. Le calcul se fait par élément et le résultat est également une série de données. |
ArcTan2(Sig1, Sig2) |
Calcule le ArcTan2() de deux signaux de longueurs égales. Le calcul se fait par élément et le résultat est équivalent à Signal(ArcTan2(Sig1.Y, Sig2.Y), Sig1.X). |