English
Iscriviti ora
Matematica/probuilder · probacktest · proorder · proscreener

COS

COS in ProBuilder restituisce il coseno di un angolo espresso in radianti, un valore tra -1 e 1. Sintassi, il requisito dei radianti, insidie ed esempi svolti.

Sintassi

probuilder
COS(a)

Parametri

NomeTipoDescrizione
anumeroL'angolo in radianti. I gradi devono essere convertiti in radianti prima della chiamata.

Formula

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

COS(0) restituisce 1, COS(PI/2) restituisce 0, e COS(PI) restituisce -1. La funzione è periodica con periodo 2*PI.

Come funziona

COS tratta il suo argomento come un angolo misurato in radianti, non in gradi. Questa è la trappola di gran lunga più comune: passargli un valore in gradi restituisce un numero senza significato. Converti con a * PI / 180 prima. Il risultato è limitato all'intervallo [-1, 1], il che rende il coseno utile per costruire serie cicliche regolari e oscillatori.

Poiché l'output non esce mai da [-1, 1], è un input sicuro per ACOS, la funzione inversa, senza limitazione dell'intervallo.

Esempi

Esempio 1, Coseno di un angolo in gradi (Indicatore)

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 conversione è essenziale. COS(60) tratterebbe 60 come radianti e restituirebbe il valore sbagliato; il codice sopra restituisce 0.5, il coseno di 60 gradi.

Esempio 2, Onda ciclica sull'indice di 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")

Scalare l'indice della bar in radianti produce un coseno ripetitivo che raggiunge il picco una volta per ciclo.

Esempio 3, Filtro di ingresso ponderato sul 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

Il termine coseno consente ingressi solo durante la metà positiva del suo ciclo, orientando le operazioni verso una fase dell'onda.

Errori e insidie comuni

  • L'angolo deve essere in radianti. COS richiede i radianti. Per usare i gradi, moltiplica per PI / 180 prima, altrimenti il risultato è privo di significato.
  • L'output è limitato a [-1, 1]. Il coseno non restituisce mai un valore fuori da questo intervallo, quindi una lettura oltre tale intervallo segnala un errore di codice a monte.
  • È periodica, quindi molti input danno lo stesso output. COS(a) e COS(a + 2*PI) sono uguali. La funzione da sola non può dirti da quale ciclo provenga un angolo.
  • SIN, seno di un angolo in radianti, la controparte del coseno.
  • TAN, tangente di un angolo in radianti.
  • ACOS, arcocoseno, l'inverso di COS.
  • ASIN, arcoseno.
  • ATAN, arcotangente.
  • ABS, valore assoluto, utile per test simmetrici sul coseno.
  • SQRT, radice quadrata, comune nelle identità trigonometriche.