Calcula la arcotangente con dos argumentos.
Sintaxis
ArcTan2(Y, X)
La sintaxis de la función ArcTan2 consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
Y |
El primer argumento de la función. Corresponde a la coordenada Y de un punto en el sistema de coordenadas cartesianas bidimensional. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos reales. |
X |
El segundo argumento de la función. Corresponde a la coordenada X de un punto en el sistema de coordenadas cartesianas bidimensional. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos reales. |
Notas
El resultado tiene la unidad rad.
La función determina el ángulo φ convirtiendo coordenadas cartesianas (x, y) en coordenadas polares (r, φ).
La función ArcTan2(y, x) puede definirse del siguiente modo: Si x e y son números reales con r = sqrt(x^2 + y^2), entonces se cumple:
x = r * cos(ArcTan2(y, x)),
y = r * sin(ArcTan2(y, x)).
Es decir (r, ArcTan2(y, x)) es la representación en coordenadas polares del punto con las coordenadas cartesianas (x, y).
La función ArcTan2 se define del siguiente modo:
El rango de valores de ArcTan2(y, x) es, por tanto, el intervalo semiabierto ]-PI, PI].
Si al menos un argumento es una serie de datos o una matriz de datos, el cálculo se realiza elemento a elemento y el resultado vuelve a ser una serie de datos o una matriz de datos. El número de filas y, si procede, de columnas de ambos argumentos debe coincidir, a menos que uno de los argumentos sea un valor escalar. Un argumento escalar se multiplica por el número de valores del argumento no escalar.
Si la función se aplica a señales, series de señales o curvas espaciales, el resultado vuelve a ser una señal, serie de señales o curva espacial. El componente Y del resultado se obtiene aplicando la función a los componentes Y de los dos argumentos. El componente X y, en su caso, Z del resultado corresponden preferentemente al componente X y, en su caso, Z del primer argumento, o bien al componente X y, en su caso, Z del segundo argumento.
Visualización de la función ArcTan2 con 2 variables
Calcula la función ArcTan2 y = ArcTan2(z, x) sobre el rango (x, z) bidimensional [-4, 4] x [-4, 4]. La visualización en un diagrama de contorno 3D proporciona:
Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
ArcTan2(7, -5) |
Devuelve 2.191. |
Dim z = -5 + 7i |
La llamada de Phase(z) es equivalente a ArcTan2(Imag(z), Real(z)), es decir, en este caso a ArcTan2(7, -5) |
ArcTan2(DataSeries1, DataSeries2) |
Calcula el ArcTan2() de dos series de datos de igual longitud. El cálculo se realiza elemento por elemento y el resultado vuelve a ser una serie de datos. |
ArcTan2(Sig1, Sig2) |
Calcula el ArcTan2() de dos señales de igual longitud. El cálculo se realiza elemento por elemento y el resultado equivale a Signal(ArcTan2(Sig1.Y, Sig2.Y), Sig1.X). |