English
Únete hoy
Matemáticas/probuilder · probacktest · proorder · proscreener

ACOS

ACOS en ProBuilder devuelve el arco coseno de un valor, el ángulo en radianes cuyo coseno es igual a la entrada. Rango de entrada, sintaxis, parámetros y ejemplos.

Sintaxis

probuilder
ACOS(value)

Parámetros

NombreTipoDescripción
valuenúmeroUn valor entre -1 y 1 inclusive. Las entradas fuera de este rango no son válidas porque ningún ángulo real tiene un coseno más allá de esos límites.

Fórmula

código
ACOS(x) = angle in radians such that COS(angle) = x,   -1 <= x <= 1

El ángulo devuelto está entre 0 y PI radianes (0 a 180 grados). Para convertir el resultado a grados, multiplica por 180 / PI.

Cómo funciona

ACOS invierte la relación del coseno: dada una razón, devuelve el ángulo que la produjo. Como el coseno nunca sale del rango de -1 a 1, la entrada debe permanecer dentro de esa banda. ACOS(1) devuelve 0, ACOS(0) devuelve aproximadamente 1.5708 (PI/2), y ACOS(-1) devuelve PI.

La salida está en radianes, de forma coherente con COS, SIN y TAN, que todas esperan la entrada en radianes. Si un cálculo posterior trabaja en grados, aplica la conversión 180 / PI después de la llamada.

Ejemplos

Ejemplo 1, Ángulo a partir de un ratio normalizado (Indicador)

probuilder
// Recover an angle in degrees from a cosine ratio
ratio = 0.5
angleRad = ACOS(ratio)
angleDeg = angleRad * 180 / 3.14159265
RETURN angleDeg AS "Angle (deg)"

ACOS(0.5) devuelve unos 1.047 radianes, que la conversión transforma en 60 grados.

Ejemplo 2, Proteger el rango de entrada (ProScreener)

probuilder
// Only compute the angle where the ratio is a valid cosine
x = (close - Lowest[20](low)) / (Highest[20](high) - Lowest[20](low))
valid = x >= -1 AND x <= 1
angle = ACOS(MIN(1, MAX(-1, x)))
SCREENER[valid](angle AS "ACOS")

Acotar x con MIN y MAX mantiene la entrada dentro de [-1, 1] para que ACOS nunca ve un valor fuera de rango.

Ejemplo 3, Filtro basado en el ángulo (ProOrder)

probuilder
// Convert a bounded oscillator reading into an angle and gate entries by it
osc = (close - Average[20](close)) / (2 * STD[20](close))
osc = MIN(1, MAX(-1, osc))
theta = ACOS(osc)
IF NOT LongOnMarket AND theta < 1 THEN
  BUY 1 CONTRACT AT MARKET
ENDIF

La limitación garantiza una entrada válida, y ACOS proyecta la lectura acotada en un ángulo usado como umbral.

Errores y trampas habituales

  • La entrada debe mantenerse en [-1, 1]. Un argumento por debajo de -1 o por encima de 1 no es un coseno válido y genera un error. Acótalo con MIN(1, MAX(-1, x)) cuando el valor puede salirse del rango.
  • El resultado está en radianes. La salida va de 0 a PI. Multiplica por 180 / PI si necesitas grados.
  • Inversa de COS, no 1 / COS. ACOS deshace el coseno. No es el recíproco de COS.
  • ASIN, arcoseno, la inversa de SIN.
  • ATAN, arco tangente, la inversa de TAN.
  • COS, coseno de un ángulo en radianes, la función ACOS se invierte.
  • SIN, seno de un ángulo en radianes.
  • TAN, tangente de un ángulo en radianes.
  • ABS, valor absoluto, útil al preparar entradas.
  • SQRT, raíz cuadrada, habitual junto a las razones trigonométricas.