Iscriviti ora
Matematica/probuilder · probacktest · proorder · proscreener

ATAN

ATAN in ProBuilder restituisce l'arcotangente di un valore, l'angolo in radianti la cui tangente è uguale all'input. Sintassi, parametri, intervallo di output, esempi.

Sintassi

probuilder
ATAN(value)

Parametri

NomeTipoDescrizione
valuenumeroQualsiasi espressione numerica reale. A differenza di ASIN e ACOS, non c'è un intervallo di input limitato.

Formula

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

L'angolo restituito è compreso tra -PI/2 e PI/2 radianti (da -90 a 90 gradi), senza mai raggiungere gli estremi. Per convertire in gradi, moltiplica per 180 / PI.

Come funziona

ATAN riporta una pendenza all'angolo che l'ha prodotta. Poiché la tangente copre tutta la retta reale, ATAN accetta qualsiasi input senza restrizioni di dominio. ATAN(0) restituisce 0, ATAN(1) restituisce circa 0.785 (PI/4, ovvero 45 gradi), e le magnitudini elevate si avvicinano a +/- PI/2 senza mai raggiungerlo.

Un uso comune è trasformare una pendenza, come la variazione di una media mobile per bar, in un angolo. L'output è in radianti, come le altre istruzioni trigonometriche, quindi applica 180 / PI quando servono i gradi.

Esempi

Esempio 1, Pendenza di una media mobile come angolo (Indicatore)

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 converte la pendenza per barra in un angolo, fornendo una lettura limitata su cui è più facile fissare una soglia rispetto a una pendenza grezza che scala con il prezzo.

Esempio 2, Medie in forte salita (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")

Poiché ATAN accetta qualsiasi input, la pendenza non necessita di limitazione prima della chiamata.

Esempio 3, Filtro di ingresso sull'angolo di trend (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

Il filtro di angolo richiede una media realmente in salita, non semplicemente un incrocio su una linea piatta.

Errori e insidie comuni

  • Il risultato è in radianti. L'output varia da -PI/2 a PI/2 e non raggiunge mai tali limiti. Moltiplica per 180 / PI se ti servono i gradi.
  • Inverso di TAN, non 1 / TAN. ATAN annulla la tangente. Non è il reciproco di TAN.
  • L'angolo dipende dalla scala. L'angolo da ATAN(slope) dipende dalle unità della pendenza. Una pendenza di prezzo su un indice e su una coppia forex corrispondono ad angoli molto diversi, quindi una soglia angolare assoluta non è confrontabile tra strumenti.
  • ACOS, arcocoseno, l'inverso di COS.
  • ASIN, arcoseno, l'inverso di SIN.
  • TAN, tangente di un angolo in radianti, la funzione ATAN si inverte.
  • SIN, seno di un angolo in radianti.
  • COS, coseno di un angolo in radianti.
  • ABS, valore assoluto, utile per test simmetrici sugli angoli.
  • LinearRegressionSlope, pendenza di una linea interpolata, un input naturale per ATAN.