ATAN2

Syntaxe

Paramètres

Description

Cette fonction trigonométrique retourne la valeur du calcul du quadrant et de l'angle de l'«ArcTangente».

Remarques

• Calcul de l'arctangente à deux paramètres : Contrairement à atan, la fonction atan2 prend deux paramètres : la coordonnée verticale (opposée) et la coordonnée horizontale (adjacente). Elle calcule l'angle en radians entre l'axe des x et la ligne passant par l'origine et le point (x, y).
• Gestion des quadrants : La fonction atan2 tient compte des signes des deux paramètres pour déterminer le quadrant correct de l'angle. Ainsi, elle renvoie un résultat précis même lorsque les coordonnées sont négatives, ce qui n'est pas possible avec atan.
• Retourne des angles entre -π et π : Le résultat de atan2 est un angle en radians compris entre -π et π (soit entre environ -3.14 et 3.14). Cela inclut les quatre quadrants du cercle trigonométrique, permettant une description complète des directions.
• Applications dans les coordonnées polaires : atan2 est fréquemment utilisée pour convertir des coordonnées cartésiennes (x, y) en coordonnées polaires (r, Θ), où r est la distance à l'origine et Θ est l'angle obtenu avec atan2.
• Prise en charge des cas particuliers : La fonction gère des cas spécifiques comme atan2(0, 0) (retournant 0), et les cas où l'un des paramètre est zéro. Par exemple, atan2(1, 0) retourne π/2, indiquant un angle droit.
• Utilisation en robotique et en simulations : Dans des domaines comme la robotique, les simulations physiques ou les jeux vidéo, atan2 est souvent utilisée pour déterminer les orientations ou les trajectoires en fonction des coordonnées d'un objet.
• Problèmes potentiels avec les valeurs infinies : Si l'un des paramètres est une valeur infinie (INF), atan2 peut retourner des résultats extrêmes (comme ±π/2 ou ±π). Ces cas doivent être gérés avec précaution dans le code pour éviter des comportements inattendus.
• Différence essentielle avec atan : Alors que atan calcule l'arctangente uniquement à partir d'une tangente (un rapport unique), atan2 fournit une solution plus complète en prenant en compte deux dimensions. Cela élimine toute ambiguïté dans le calcul de l'angle, en particulier pour des valeurs négatives.

Exemple

Voici un exemple permet d'afficher 5 coordonnées associés à l'ArcTangente :

on obtiendra le résultat suivant :

Voir également

Langage de programmation - C - Fonction atan2
Langage de programmation - Perl - Fonction atan2

Références

PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 371