atan2

Tangente inversa a quattro quadranti

Sintassi

P = atan2(Y,X)

Descrizione

P = atan2(Y,X) restituisce la tangente inversa a quattro quadranti (tan^-1) di Y e X, che deve essere reale. La funzione atan2 segue la convenzione secondo cui atan2(x,x) restituisce 0 quando x è matematicamente zero (o 0 o -0).

Esempi

Individuazione della tangente inversa a quattro quadranti di un punto

Trovare la tangente inversa a quattro quadranti di un punto y = 4, x = -3.

atan2(4,-3)

ans = 
2.2143

Conversione di numero complesso in coordinate polari

Convertire 4 + 3i in coordinate polari.

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

r = 
5

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

theta = 
0.6435

Il raggio r e l’angolo theta sono la rappresentazione in coordinate polari di 4 + 3i.

In alternativa, utilizzare angle per calcolare theta.

theta = angle(z)

theta = 
0.6435

Riconvertire r e theta nel numero complesso originale.

z = r*exp(i*theta)

z = 
4.0000 + 3.0000i

Plottaggio di tangente inversa a quattro quadranti

Tracciare atan2(Y,X) per -4<Y<4 e -4<X<4.

Definire l'intervallo su cui tracciare il grafico.

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

Trovare atan2(Y,X) nell’intervallo.

P = atan2(Y,X);

Utilizzare surf per generare un grafico a superficie della funzione. Si noti che plot traccia la discontinuità esistente in Y=0 per tutte le X<0.

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

Argomenti di input

Y — Coordinate y

scalare | vettore | matrice | array multidimensionale | tabella | orario

Coordinate y, specificate come scalare, vettore, matrice, array multidimensionale, tabella o orario. Gli input Y e X devono avere la stessa dimensione o dimensioni compatibili (ad esempio, Y è una matrice M x N e X è uno scalare o un vettore riga di 1 x N). Per maggiori informazioni, vedere Grandezze di array compatibili per le operazioni di base.

Tipi di dati: single | double | table | timetable

X — Coordinate x

scalare | vettore | matrice | array multidimensionale | tabella | orario

Coordinate x, specificate come scalare, vettore, matrice, array multidimensionale, tabella o orario. Gli input Y e X devono avere la stessa dimensione o dimensioni compatibili (ad esempio, Y è una matrice M x N e X è uno scalare o un vettore riga di 1 x N). Per maggiori informazioni, vedere Grandezze di array compatibili per le operazioni di base.

Tipi di dati: single | double | table | timetable

Ulteriori informazioni

Tangente inversa a quattro quadranti

La tangente inversa a quattro quadranti atan2(Y,X) restituisce valori nell'intervallo chiuso [–π, π] basati sui valori di Y e X, come mostrato nel grafico.

Per contro, atan(Y/X) restituisce risultati limitati all'intervallo [-π/2, π/2], mostrato sul lato destro del diagramma.

Conformità IEEE

Per gli input reali, atan2 ha alcuni comportamenti che differiscono da quelli raccomandati dallo Standard IEEE^®-754.

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

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione atan2 supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Se si utilizza atan2 con operandi di tipo singolo e doppio, il codice generato potrebbe non produrre lo stesso risultato di MATLAB. Vedere Binary Element-Wise Operations with Single and Double Operands (MATLAB Coder).

Generazione di codice GPU
Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione atan2 supporta completamente gli array di GPU. Per eseguire la funzione su una GPU, specificare i dati di input come un gpuArray (Parallel Computing Toolbox). Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Questa funzione supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2023a: Esecuzione di calcoli direttamente su tabelle e orari

La funzione atan2 può eseguire calcoli su tutte le variabili all’interno di una tabella o di un orario senza dover eseguire indicizzazioni per accedere a tali variabili. Tutte le variabili devono avere tipi di dati che supportino il calcolo. Per maggiori informazioni, vedere Direct Calculations on Tables and Timetables.

Vedi anche

angle | atan | atanh | atan2d | tan