Iscriviti ora
Matematica/probuilder · probacktest · proorder · proscreener

SIN

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

Sintassi

probuilder
SIN(a)

Parametri

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

Formula

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

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

Come funziona

SIN tratta il suo argomento come un angolo misurato in radianti. Passare direttamente un valore in gradi dà un risultato privo di senso, quindi converti prima con a * PI / 180. Il risultato resta nell'intervallo [-1, 1], il che rende il seno un elemento costruttivo naturale per serie cicliche regolari e oscillatori.

Poiché il risultato non esce mai da [-1, 1], è un input sicuro per ASIN, il suo inverso, senza limitazione.

Esempi

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

probuilder
// Convert 90 degrees to radians, then take the sine
angleInDegrees = 90
angleInRadians = angleInDegrees * 3.14159265 / 180
result = SIN(angleInRadians)
RETURN result AS "SIN(90 deg)"

La conversione è importante. SIN(90) tratterebbe 90 come radianti; il codice sopra restituisce 1, il seno di 90 gradi.

Esempio 2, Onda ciclica sull'indice di bar (ProScreener)

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

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

Esempio 3, Filtro di ingresso pesato sul seno (ProOrder)

probuilder
// Allow entries only during the rising half of a slow sine cycle
phase = BarIndex * 2 * 3.14159265 / 50
weight = SIN(phase)
IF NOT LongOnMarket AND close CROSSES OVER Average[20](close) AND weight > 0 THEN
  BUY 1 CONTRACT AT MARKET
ENDIF

Il termine seno limita gli ingressi alla metà positiva del suo ciclo, orientando le operazioni verso una fase dell'onda.

Errori e insidie comuni

  • L'angolo deve essere in radianti. SIN 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 seno 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. SIN(a) e SIN(a + 2*PI) sono uguali, quindi la funzione da sola non può dire a quale ciclo appartiene un angolo.
  • COS, coseno di un angolo in radianti, la controparte del seno.
  • TAN, tangente di un angolo in radianti.
  • ASIN, arcoseno, l'inverso di SIN.
  • ACOS, arcocoseno.
  • ATAN, arcotangente.
  • ABS, valore assoluto, utile per test simmetrici sul seno.
  • SQRT, radice quadrata, comune nelle identità trigonometriche.