atan2

Tangente inverse dans les quatre quadrants

Syntaxe

P = atan2(Y,X)

Description

P = atan2(Y,X) renvoie la tangente inverse dans les quatre quadrants (tan^-1) de Y et X qui doivent être réels. La fonction atan2 suit la convention selon laquelle atan2(x,x) renvoie 0 quand x est mathématiquement nul (égal à 0 ou -0).

Exemples

Déterminer la tangente inverse dans les quatre quadrants d’un point

Déterminez la tangente inverse dans les quatre quadrants du point y = 4, x = -3.

atan2(4,-3)

ans = 
2.2143

Convertir un nombre complexe en coordonnées polaires

Convertissez 4 + 3i en coordonnées polaires.

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

r = 
5

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

theta = 
0.6435

Le rayon r et l’angle theta sont la représentation en coordonnées polaires de 4 + 3i.

Vous pouvez également utiliser angle pour calculer theta.

theta = angle(z)

theta = 
0.6435

Convertissez r et theta sous la forme du nombre complexe d’origine.

z = r*exp(i*theta)

z = 
4.0000 + 3.0000i

Tracer la tangente inverse dans les quatre quadrants

Tracez atan2(Y,X) pour -4<Y<4 et -4<X<4.

Définissez l’intervalle de tracé.

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

Déterminez atan2(Y,X) sur cet intervalle.

P = atan2(Y,X);

Utilisez surf pour générer un graphique de surface pour la fonction. Remarquez que plot trace la discontinuité existant à Y=0 pour tous les X<0.

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

Arguments d'entrée

Y — coordonnées y

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Coordonnées y, spécifiées sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. Les entrées Y et X doivent être de tailles identiques ou compatibles (par exemple, Y est une matrice de dimension M x N et X est un scalaire ou un vecteur ligne de dimension 1 x N). Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

Types de données : single | double | table | timetable

X — coordonnées x

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

Coordonnées x, spécifiées sous forme de scalaire, de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable. Les entrées Y et X doivent être de tailles identiques ou compatibles (par exemple, Y est une matrice de dimension M x N et X est un scalaire ou un vecteur ligne de dimension 1 x N). Pour plus d’informations, consultez Tailles de tableau compatibles pour les opérations de base.

Types de données : single | double | table | timetable

En savoir plus

Tangente inverse dans les quatre quadrants

La tangente inverse dans les quatre quadrants atan2(Y,X) renvoie des valeurs dans l’intervalle fermé [–π, π] en fonction des valeurs de Y et X comme illustré sur le graphique.

En revanche, atan(Y/X) renvoie des résultats limités à l’intervalle [–π/2, π/2] qui figure à droite du diagramme.

Conformité IEEE

Pour les entrées réelles, atan2 présente quelques comportements différents de ceux recommandés par la norme IEEE^®-754.

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

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction atan2 supporte entièrement les tall arrays. Pour plus d’informations, consultez Tall array.

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Si vous utilisez atan2 avec des opérandes de type simple et double, il se peut que le code généré ne produise par le même résultat que MATLAB. Consultez Binary Element-Wise Operations with Single and Double Operands (MATLAB Coder).

Génération de code GPU
Générez du code CUDA® pour les GPU NVIDIA® avec GPU Coder™.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction atan2 supporte entièrement les GPU arrays. Pour exécuter la fonction sur un GPU, spécifiez les données en entrée en tant que gpuArray (Parallel Computing Toolbox). Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Cette fonction supporte entièrement les distributed arrays. Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2023a: Effectuer des calculs directement dans les tableaux et les timetables

La fonction atan2 peut procéder au calcul sur toutes les variables au sein d’un tableau ou d’une timetable sans indexation pour accéder à ces variables. Toutes les variables doivent avoir des types de données qui supportent les calculs. Pour plus d’informations, consultez Direct Calculations on Tables and Timetables.

Voir aussi

angle | atan | atanh | atan2d | tan