English
Rejoignez-nous
Mathématiques/probuilder · probacktest · proorder · proscreener

ATAN

ATAN en ProBuilder renvoie l'arc tangente d'une valeur, l'angle en radians dont la tangente égale l'entrée. Syntaxe, paramètres, intervalle de sortie, exemples.

Syntaxe

probuilder
ATAN(value)

Paramètres

NomTypeDescription
valuenombreToute expression numérique réelle. Contrairement à ASIN et ACOS, il n'y a pas de plage d'entrée restreinte.

Formule

code
ATAN(x) = angle in radians such that TAN(angle) = x

L'angle renvoyé est compris entre -PI/2 et PI/2 radians (-90 à 90 degrés), sans jamais atteindre les bornes. Pour convertir en degrés, multipliez par 180 / PI.

Comment ça marche

ATAN ramène une pente à l'angle qui l'a produite. Comme la tangente couvre toute la droite réelle, ATAN accepte toute entrée sans restriction de domaine. ATAN(0) renvoie 0, ATAN(1) renvoie environ 0.785 (PI/4, soit 45 degrés), et les grandes magnitudes approchent sans jamais atteindre +/- PI/2.

Un usage courant consiste à convertir une pente, par exemple la variation d'une moyenne mobile par bar, en angle. La sortie est en radians, comme les autres instructions trigonométriques, appliquez donc 180 / PI si vous voulez des degrés.

Exemples

Exemple 1, Pente d'une moyenne mobile en angle (Indicateur)

probuilder
// Angle of the 20-period average measured over one bar
ma = Average[20](close)
slope = ma - ma[1]
angleDeg = ATAN(slope) * 180 / 3.14159265
RETURN angleDeg AS "MA angle (deg)"

ATAN convertit la pente par bar en un angle, ce qui donne une lecture bornée, plus facile à seuiller qu'une pente brute qui varie avec le prix.

Exemple 2, Moyennes en forte hausse (ProScreener)

probuilder
// Instruments whose 50-period average is angled sharply upward
ma = Average[50](close)
ang = ATAN(ma - ma[1])
SCREENER[ang > 0.02](ang AS "Slope angle")

Parce que ATAN accepte n'importe quelle entrée, la pente n'a pas besoin d'être bornée avant l'appel.

Exemple 3, Filtre d'entrée sur l'angle de tendance (ProOrder)

probuilder
// Enter long only when the trend angle is positive enough
ma = Average[30](close)
theta = ATAN(ma - ma[1])
IF NOT LongOnMarket AND close CROSSES OVER ma AND theta > 0.01 THEN
  BUY 1 CONTRACT AT MARKET
ENDIF

Le filtre d'angle exige une moyenne réellement haussière, et pas seulement un croisement sur une ligne plate.

Erreurs et pièges courants

  • Le résultat est en radians. La sortie va de -PI/2 à PI/2 sans jamais atteindre ces limites. Multipliez par 180 / PI s'il vous faut des degrés.
  • Inverse de TAN, pas 1 / TAN. ATAN annule la tangente. Ce n'est pas l'inverse de TAN.
  • L'angle dépend de l'échelle. L'angle depuis ATAN(slope) dépend des unités de la pente. Une pente de prix sur un indice et sur une paire forex correspondent à des angles très différents, si bien qu'un seuil d'angle absolu n'est pas comparable d'un instrument à l'autre.
  • ACOS, arc cosinus, l'inverse de COS.
  • ASIN, arc sinus, l'inverse de SIN.
  • TAN, tangente d'un angle en radians, la fonction ATAN s'inverse.
  • SIN, sinus d'un angle en radians.
  • COS, cosinus d'un angle en radians.
  • ABS, valeur absolue, utile pour les tests d'angle symétriques.
  • LinearRegressionSlope, pente d'une droite ajustée, une entrée naturelle pour ATAN.