English
Jetzt beitreten
Mathematisch/probuilder · probacktest · proorder · proscreener

COS

COS in ProBuilder gibt den Kosinus eines in Radiant angegebenen Winkels zurück, einen Wert zwischen -1 und 1. Syntax, die Radiant-Anforderung, Stolperfallen und ausgearbeitete Beispiele.

Syntax

probuilder
COS(a)

Parameter

NameTypBeschreibung
aZahlDer Winkel im Bogenmaß. Grad müssen vor dem Aufruf in Bogenmaß umgerechnet werden.

Formel

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

COS(0) gibt 1 zurück, COS(PI/2) gibt 0 zurück, und COS(PI) liefert -1. Die Funktion ist periodisch mit der Periode 2*PI.

So funktioniert es

COS behandelt sein Argument als Winkel im Bogenmaß, nicht in Grad. Das ist die häufigste Falle: Die Übergabe eines Gradwerts liefert eine bedeutungslose Zahl. Umrechnen mit a * PI / 180 zuerst. Das Ergebnis ist auf [-1, 1] begrenzt, was den Kosinus nützlich macht, um glatte zyklische Reihen und Oszillatoren zu bauen.

Da die Ausgabe [-1, 1] nie verlässt, ist sie eine sichere Eingabe für ACOS, die Umkehrfunktion, ohne Begrenzung.

Beispiele

Beispiel 1, Kosinus eines Winkels in Grad (Indikator)

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)"

Die Umrechnung ist unerlässlich. COS(60) würde 60 als Radiant behandeln und den falschen Wert zurückgeben; der Code oben gibt 0.5 zurück, den Kosinus von 60 Grad.

Beispiel 2, Zyklische Welle über den Bar-Index (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")

Die Skalierung des bar-Index in Radiant erzeugt einen sich wiederholenden Kosinus, der einmal pro Zyklus seinen Höchstwert erreicht.

Beispiel 3, Kosinusgewichtetes Einstiegsgatter (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

Der Kosinusterm erlaubt Einstiege nur während der positiven Hälfte seines Zyklus und verschiebt damit die Trades zu einer Phase der Welle hin.

Häufige Fehler und Stolperfallen

  • Der Winkel muss im Bogenmaß angegeben werden. COS erwartet Radiant. Für Grad multiplizieren Sie mit PI / 180 zuerst, andernfalls ist das Ergebnis bedeutungslos.
  • Die Ausgabe ist auf [-1, 1] begrenzt. Der Kosinus gibt niemals einen Wert außerhalb dieses Bereichs zurück, daher deutet ein Wert darüber hinaus auf einen Programmierfehler weiter oben hin.
  • Periodisch, daher ergeben viele Eingaben dieselbe Ausgabe. COS(a) und COS(a + 2*PI) sind gleich. Die Funktion allein kann nicht sagen, aus welchem Zyklus ein Winkel stammt.
  • SIN, Sinus eines Winkels in Radiant, das Gegenstück zum Kosinus.
  • TAN, Tangens eines Winkels im Bogenmaß.
  • ACOS, Arkuskosinus, die Umkehrfunktion von COS.
  • ASIN, Arkussinus.
  • ATAN, Arkustangens.
  • ABS, Absolutwert, nützlich für symmetrische Kosinustests.
  • SQRT, Quadratwurzel, häufig in trigonometrischen Identitäten.