Langage de programmation - Perl - Référence de procédures et fonctions

ATAN2	ArcTangente à
Perl	POSIX

Syntaxe

sub POSIX::atan2($Y,$X);

Paramètres

Nom	Description
$Y	Ce paramètre permet d'indiquer la coordonnée Y
$X	Ce paramètre permet d'indiquer la coordonnée X

Retour

Valeur	Description
-PI à PI	Les valeurs retournées sont de format radians entre -π et π.

Description

Cette fonction trigonométrique retourne l'«Arc Tangente» de Y/X.

Remarques

Calcule l'arc tangente en tenant compte du quadrant : POSIX::atan2($Y, $X) retourne l'angle (en radians) correspondant au rapport Y/X, mais contrairement à atan, elle prend en compte les signes de $Y et $X pour déterminer le quadrant exact de l'angle. Cela évite l'ambiguïté liée à la division seule.
Valeur de retour entre -π et +π : Le résultat de atan2 est une valeur en radians comprise dans l'intervalle [-π, +π], soit environ de -3,14 à +3,14. Cette plage couvre un cercle complet, permettant de représenter toute orientation angulaire dans un plan cartésien.
Utilisée pour obtenir l'angle d'un vecteur en 2D : atan2 est particulièrement utile pour calculer l'angle formé par un vecteur (X, Y) par rapport à l'axe des abscisses, ce qui est essentiel en géométrie, robotique, informatique graphique, et systèmes de navigation.
Gestion des cas où $X est nul : Lorsque la coordonnée $X est égale à zéro, la fonction gère ce cas sans générer d'erreur, en retournant ±π/2 selon le signe de $Y. Cela évite les divisions par zéro et garantit un comportement stable dans toutes les configurations.
Disponible via le module POSIX : Pour utiliser atan2 en Perl, il faut importer la fonction via :


use POSIX qw(atan2);

Cela permet d'accéder aux fonctions trigonométriques standards conformes à la norme POSIX.

Plus fiable que la simple division pour les angles : Calculer un angle à partir d'un simple atan(Y/X) peut entraîner des erreurs d'interprétation des quadrants, car atan ne peut pas distinguer entre (-Y, -X) et (Y, X). atan2 corrige cette limitation en tenant compte des signes des deux paramètres.
Très utilisée dans les calculs vectoriels et les animations : Dans les applications graphiques ou physiques, atan2 sert à calculer l'orientation d'objets mobiles, à ajuster des rotations, ou à déterminer des angles entre points, grâce à sa précision et sa robustesse.
Souvent combinée avec des conversions d'unités : Comme pour les autres fonctions trigonométriques, le résultat de atan2 est en radians. Il est donc fréquent de convertir cette valeur en degrés pour un affichage plus compréhensible, via la formule :


my $degrees = $radians * 180 / 3.141592653589793;

Exemple

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


#!/usr/bin/perl

     

use strict;

use Math::Trig; 

use POSIX;

 

for (my $I = 1; $I <= 5; $I++) {

   my $X = -5.0; 

   my $Y = 5.0;

   print "ArcTangente pour les coordonnées (X=" . ($X + $I) . ", Y=" .  ($Y + $I) . ") = ". (POSIX::atan2($Y + $I, $X + $I) * 180 / pi) . " degrées"."\n";

}

on obtiendra le résultat suivant :

ArcTangente pour les coordonnées (X=-4, Y=6) = 123.69006752598 degrées ArcTangente pour les coordonnées (X=-3, Y=7) = 113.198590513648 degrées ArcTangente pour les coordonnées (X=-2, Y=8) = 104.036243467927 degrées ArcTangente pour les coordonnées (X=-1, Y=9) = 96.3401917459099 degrées ArcTangente pour les coordonnées (X=0, Y=10) = 90 degrées

Voir également

Langage de programmation - Perl - Référence de procédures et fonctions - atan2
Langage de programmation - C pour Linux - Référence de procédures et fonctions - atan2

Dernière mise à jour : Dimanche, le 18 octobre 2015

Section courante

A propos

Section administrative du site

ATAN2

Perl