atan2

Tangente inversa de cuatro cuadrantes

Sintaxis

P = atan2(Y,X)

Descripción

P = atan2(Y,X) devuelve la tangente inversa de cuatro cuadrantes (tan^-1) de Y y X, que debe ser real. La función atan2 sigue la convención de que atan2(x,x) devuelve 0 cuando x es matemáticamente cero (0 o bien -0).

Ejemplos

Encontrar la tangente inversa de cuatro cuadrantes de un punto

Encuentre la tangente inversa de cuatro cuadrantes del punto y = 4, x = -3.

atan2(4,-3)

ans = 
2.2143

Convertir un número complejo a coordenadas polares

Convierta 4 + 3i a coordenadas polares.

z = 4 + 3i;
r = abs(z)

r = 
5

theta = atan2(imag(z),real(z))

theta = 
0.6435

El radio r y el ángulo theta son la representación de coordenadas polares de 4 + 3i.

De forma alternativa, utilice angle para calcular theta.

theta = angle(z)

theta = 
0.6435

Vuelva a convertir r y theta al número complejo original.

z = r*exp(i*theta)

z = 
4.0000 + 3.0000i

Representar una tangente inversa de cuatro cuadrantes

Represente atan2(Y,X) para -4<Y<4 y -4<X<4.

Defina el intervalo sobre el que representar.

[X,Y] = meshgrid(-4:0.1:4,-4:0.1:4);

Encuentre atan2(Y,X) en el intervalo.

P = atan2(Y,X);

Utilice surf para generar una gráfica de superficie de la función. Tenga en cuenta que plot representa la discontinuidad que existe en Y=0 para todo X<0.

surf(X,Y,P);
view(45,45);

Argumentos de entrada

Y — Coordenadas y

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Coordenadas y, especificadas como escalar, vector, matriz, arreglo multidimensional, tabla u horario. Las entradas Y y X deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, Y es una matriz M por N y X es un escalar o un vector fila 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

Tipos de datos: single | double | table | timetable

X — Coordenadas x

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Coordenadas x, especificadas como escalar, vector, matriz, arreglo multidimensional, tabla u horario. Las entradas Y y X deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, Y es una matriz M por N y X es un escalar o un vector fila 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

Tipos de datos: single | double | table | timetable

Más acerca de

Tangente inversa de cuatro cuadrantes

La tangente inversa de cuatro cuadrantes, atan2(Y,X), devuelve valores en el intervalo cerrado [–π, π] basados en los valores de Y y X, como se muestra en la gráfica.

Por el contrario, atan(Y/X) devuelve resultados que se limitan al intervalo [–π/2, π/2], como se muestra en el lado derecho del diagrama.

Cumplimiento con IEEE

En las entradas reales, atan2 tiene comportamientos que difieren de los recomendados en el estándar IEEE^®-754.

	MATLAB®	IEEE
atan2(0,-0)	0	pi
atan2(-0,-0)	0	-pi

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función atan2 es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Si utiliza atan2 con operandos de tipo simple y de tipo doble, es posible que el código generado no produzca el mismo resultado que MATLAB. Consulte Binary Element-Wise Operations with Single and Double Operands (MATLAB Coder).

Generación de código de GPU
Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función atan2 es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2023a: Realizar cálculos directamente en tablas y horarios

La función atan2 puede realizar cálculos sobre todas las variables de una tabla u horario sin indexar para acceder a dichas variables. Todas las variables deben tener tipos de datos que admitan el cálculo. Para obtener más información, consulte Direct Calculations on Tables and Timetables.

Consulte también

angle | atan | atanh | atan2d | tan