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

COS

COS en ProBuilder devuelve el coseno de un ángulo dado en radianes, un valor entre -1 y 1. Sintaxis, el requisito de los radianes, trampas y ejemplos resueltos.

Sintaxis

probuilder
COS(a)

Parámetros

NombreTipoDescripción
anúmeroEl ángulo en radianes. Los grados deben convertirse a radianes antes de la llamada.

Fórmula

código
COS(a) = cosine of angle a,   with a in radians,   result in [-1, 1]

COS(0) devuelve 1, COS(PI/2) devuelve 0, y COS(PI) devuelve -1. La función es periódica con período 2*PI.

Cómo funciona

COS trata su argumento como un ángulo medido en radianes, no en grados. Esta es la trampa más habitual: pasarle un valor en grados devuelve un número sin sentido. Conviértelo con a * PI / 180 primero. El resultado está acotado a [-1, 1], lo que hace al coseno útil para construir series cíclicas suaves y osciladores.

Como la salida nunca sale de [-1, 1], es una entrada segura para ACOS, la función inversa, sin acotación.

Ejemplos

Ejemplo 1, Coseno de un ángulo en grados (Indicador)

probuilder
// Convert 60 degrees to radians, then take the cosine
angleInDegrees = 60
angleInRadians = angleInDegrees * 3.14159265 / 180
cosineValue = COS(angleInRadians)
RETURN cosineValue AS "COS(60 deg)"

La conversión es esencial. COS(60) trataría 60 como radianes y devolvería un valor incorrecto; el código anterior devuelve 0.5, el coseno de 60 grados.

Ejemplo 2, Onda cíclica sobre el índice de bar (ProScreener)

probuilder
// A smooth cosine wave cycling every 20 bars
phase = BarIndex * 2 * 3.14159265 / 20
wave = COS(phase)
SCREENER[wave > 0.9](wave AS "Cosine wave")

Escalar el índice del bar a radianes produce un coseno repetitivo que alcanza su máximo una vez por ciclo.

Ejemplo 3, Filtro de entrada ponderado por coseno (ProOrder)

probuilder
// Weight a signal by a slow cosine cycle
phase = BarIndex * 2 * 3.14159265 / 50
weight = COS(phase)
IF NOT LongOnMarket AND close CROSSES OVER Average[20](close) AND weight > 0 THEN
  BUY 1 CONTRACT AT MARKET
ENDIF

El término del coseno solo permite entradas durante la mitad positiva de su ciclo, sesgando las operaciones hacia una fase de la onda.

Errores y trampas habituales

  • El ángulo debe estar en radianes. COS espera radianes. Para usar grados, multiplica por PI / 180 primero; de lo contrario el resultado no tiene sentido.
  • La salida está acotada a [-1, 1]. El coseno nunca devuelve un valor fuera de este rango, por lo que una lectura más allá de él indica un error de código aguas arriba.
  • Periódica, por lo que muchas entradas dan la misma salida. COS(a) y COS(a + 2*PI) son iguales. La función por sí sola no puede decirte de qué ciclo proviene un ángulo.
  • SIN, seno de un ángulo en radianes, el compañero del coseno.
  • TAN, tangente de un ángulo en radianes.
  • ACOS, arco coseno, la inversa de COS.
  • ASIN, arcoseno.
  • ATAN, arcotangente.
  • ABS, valor absoluto, útil para pruebas simétricas del coseno.
  • SQRT, raíz cuadrada, habitual en las identidades trigonométricas.