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
COS(a)Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
a | número | El ángulo en radianes. Los grados deben convertirse a radianes antes de la llamada. |
Fórmula
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)
// 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)
// 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)
// 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
ENDIFEl 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.
COSespera radianes. Para usar grados, multiplica porPI / 180primero; 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)yCOS(a + 2*PI)son iguales. La función por sí sola no puede decirte de qué ciclo proviene un ángulo.