ATAN

Sintaxis

ATAN(value)

Parámetros

Fórmula

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

El ángulo devuelto está entre -PI/2 y PI/2 radianes (-90 a 90 grados), sin alcanzar nunca los extremos. Para convertirlo a grados, multiplica por 180 / PI.

Cómo funciona

ATAN convierte una pendiente en el ángulo que la produjo. Como la tangente cubre toda la recta real, ATAN acepta cualquier entrada sin restricción de dominio. ATAN(0) devuelve 0, ATAN(1) devuelve aproximadamente 0.785 (PI/4, o 45 grados), y las magnitudes grandes se acercan a +/- PI/2 sin alcanzarlo nunca.

Un uso habitual es convertir una pendiente, como el cambio de una media móvil por bar, en un ángulo. La salida está en radianes, igual que las demás instrucciones trigonométricas, por lo que hay que aplicar 180 / PI cuando se quieren grados.

Ejemplos

Ejemplo 1, Pendiente de una media móvil como ángulo (Indicador)

// 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 convierte la pendiente por barra en un ángulo, lo que da una lectura acotada más fácil de umbralizar que una pendiente bruta que escala con el precio.

Ejemplo 2, Medias con fuerte pendiente ascendente (ProScreener)

// 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")

Porque ATAN acepta cualquier entrada, la pendiente no necesita acotarse antes de la llamada.

Ejemplo 3, Filtro de entrada por ángulo de tendencia (ProOrder)

// 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

El filtro de ángulo exige una media realmente ascendente, no solo un cruce sobre una línea plana.

Errores y trampas habituales

• El resultado está en radianes. La salida va de -PI/2 a PI/2 y nunca alcanza esos límites. Multiplica por 180 / PI si necesitas grados.
• Inversa de TAN, no 1 / TAN. ATAN deshace la tangente. No es la recíproca de TAN.
• El ángulo depende de la escala. El ángulo desde ATAN(slope) depende de las unidades de la pendiente. Una pendiente de precio en un índice y en un par de forex se traducen en ángulos muy distintos, por lo que un umbral de ángulo absoluto no es comparable entre instrumentos.

Instrucciones relacionadas

• ACOS, arco coseno, la inversa de COS.
• ASIN, arcoseno, la inversa de SIN.
• TAN, tangente de un ángulo en radianes, la función ATAN se invierte.
• SIN, seno de un ángulo en radianes.
• COS, coseno de un ángulo en radianes.
• ABS, valor absoluto, útil para pruebas de ángulo simétricas.
• LinearRegressionSlope, pendiente de una línea ajustada, una entrada natural para ATAN.