English
Rejoignez-nous
Mathématiques/probuilder · probacktest · proorder · proscreener

COS

COS en ProBuilder renvoie le cosinus d'un angle donné en radians, une valeur comprise entre -1 et 1. Syntaxe, l'exigence des radians, pièges et exemples détaillés.

Syntaxe

probuilder
COS(a)

Paramètres

NomTypeDescription
anombreL'angle en radians. Les degrés doivent être convertis en radians avant l'appel.

Formule

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

COS(0) renvoie 1, COS(PI/2) renvoie 0, et COS(PI) renvoie -1. La fonction est périodique de période 2*PI.

Comment ça marche

COS traite son argument comme un angle mesuré en radians, non en degrés. C'est le piège le plus courant de tous : lui fournir une valeur en degrés renvoie un nombre dénué de sens. Convertissez avec a * PI / 180 d'abord. Le résultat est borné à [-1, 1], ce qui rend le cosinus utile pour construire des séries cycliques lisses et des oscillateurs.

Comme la sortie ne quitte jamais [-1, 1], c'est une entrée sûre pour ACOS, la fonction réciproque, sans bornage.

Exemples

Exemple 1, Cosinus d'un angle en degrés (Indicateur)

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 conversion est indispensable. COS(60) traiterait 60 comme des radians et renverrait une valeur erronée ; le code ci-dessus renvoie 0.5, le cosinus de 60 degrés.

Exemple 2, Onde cyclique sur l'indice 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")

Mettre l'indice de bar à l'échelle en radians produit un cosinus répétitif qui atteint son sommet une fois par cycle.

Exemple 3, Filtre d'entrée pondéré par le cosinus (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

Le terme cosinus n'autorise les entrées que pendant la moitié positive de son cycle, orientant les trades vers une seule phase de l'onde.

Erreurs et pièges courants

  • L'angle doit être en radians. COS attend des radians. Pour utiliser des degrés, multipliez par PI / 180 d'abord, sinon le résultat n'a aucun sens.
  • La sortie est bornée à [-1, 1]. Le cosinus ne renvoie jamais de valeur en dehors de cette plage, une lecture au-delà signale donc une erreur de code en amont.
  • Périodique, donc de nombreuses entrées donnent la même sortie. COS(a) et COS(a + 2*PI) sont égaux. La fonction seule ne peut pas dire de quel cycle provient un angle.
  • SIN, sinus d'un angle en radians, le compagnon du cosinus.
  • TAN, tangente d'un angle en radians.
  • ACOS, arc cosinus, l'inverse de COS.
  • ASIN, arc sinus.
  • ATAN, arc tangente.
  • ABS, valeur absolue, utile pour les tests symétriques sur le cosinus.
  • SQRT, racine carrée, courante dans les identités trigonométriques.