Klasse zum Zeichnen des Stochastic unter Verwendung des Ringbuffers - Indikator für den MetaTrader 5

Beschreibung

Die Klasse CStochasticOnRingBuffer  wurde zur Berechnung des technischen Indikators Stochastic Oszillator (Stochastic Oszillator) mit Hilfe des Algorithmus des Ringbuffers entworfen. 

Deklaration

class CStochasticOnRingBuffer

Titel

#include <IncOnRingBuffer\CStochacticOnRingBuffer.mqh>

Die Datei der CStochasticOnRingBuffer.mqh Klasse muss in den IncOnRingBuffer Ordner kopiert werden, der in MQL5\Include\ erzeugt werden muss. Zwei Dateien mit Beispielen die von dieser Klasse verwendet werden wurden dieser Beschreibung angehängt. Die Datei mit der Klasse des Ringbuffers und die Klasse des Moving Average müssen sich auch in diesem Ordner befinden.

Klassenmethoden

//--- initialization method:
bool Init(                                 // gibt false bei Fehler zurück, bei Erfolg - true
   int            period_k    = 5,         // Periode %K
   int            period_d    = 3,         // Periode %D
   int            period_s    = 3,         // Periode der Verlangsamung von %K
   ENUM_MA_METHOD method      = MODE_SMA,  // Methode %D
   int            size_buffer = 256,       // Größe des Ringbuffers, Anzahl der gespeicherten Datena
   bool           as_series   = false      // true bei Zeitreihen, false wenn die übliche Indexierung ein Eingabedaten angewendet werden soll
   );   
//--- Methode zur Berechnung basierend auf Zeitreihen oder Indikatorenbuffers:          
int MainOnArray(                  // gibt die Anzahl der verarbeiteten Element zurück  
   const int     rates_total,     // die Größe des Arrays
   const int     prev_calculated, // verabeitete Elemente im vorherigen Aufruf
   const double &high[]           // Maximalwert Array
   const double &low[]            // Minimalwert Array
   const double &close[]          // Schlusspreis Array
   );
//--- Methode zur Berechnung basierend auf separaten Reihenelementen des Arrays           
double MainOnValue(               // rgibt den Stochastic Wert für das Mengenelement zurück
   const int    rates_total,      // die Größe des Elements
   const int    prev_calculated,  // Elemente des Arrays verarbeitet
   const int    begin,            // von wo die signifikanten Daten des Arrays beginnen
   const double high,             // Maximalwert 
   const double low,              // Minimalwert 
   const double close,            // Schlusspreis 
   const int    index             // der Elementindex
   );
//--- Zugriffsmethoden auf die Daten:
int    BarsRequired();   // Gibt notwendige Zahl von Balken zurück, die zum Zeichnen des Indikators benötigt werden
string Name();           // Gibt den Namen des Indikators zurück
string NameSignal();     // Rgibt den Namen der Indikatorsignallinie zurück
string Method();         // Gibt die Glättungsmethode in Form einer Textzeile zurück
int    PeriodK()         // Gibt die Periode von %K zurück
int    PeriodS()         // Gibt die Periode der Verlangsamung von %K zurück
int    PeriodD()         // Gibt die Periode von %D zurück
int    Size();           // Gibt die Größe des Ringbuffers zurück

Die berechneten Daten des Indikators vom Ringbuffer zu erhalten ist wie bei gewöhnlichen Arrays möglich. Zum Beispiel:

//--- Klasse mit den Methoden für die Berechnung des Stochastic Indikator:
#include <IncOnRingBuffer\CStochasticOnRingBuffer.mqh>
CStochasticOnRingBuffer st;

...

//+------------------------------------------------------------------+
//| Benutzerdefinierte Indikatoriterationsfunktion                   |
//+------------------------------------------------------------------+
int OnCalculate(const int rates_total,
                const int prev_calculated,
                const datetime& time[],
                const double& open[],
                const double& high[],
                const double& low[],
                const double& close[],
                const long& tick_volume[],
                const long& volume[],
                const int& spread[])
  {
//--- Berechnung des Indikators basierend auf Preiszeitreihen:
   st.MainOnArray(rates_total,prev_calculated,high,low,close);

...

//--- verwende Daten des "st" Ringbuffers,
//    zum Beispiel, kopiere Daten in den Indikatorbuffer:
   for(int i=start;i<rates_total && !IsStopped();i++)
     {
      MainBuffer[i]   = st[rates_total-1-i];        // die Hauptlinie des Indikators
      SignalBuffer[i] = st.signal[rates_total-1-i]; // die Signallinie des Indikators
     }

...

//--- Rückgabewert von prev_calculated für nächsten Aufruf:
   return(rates_total);
  }

Beispiele

1. Die Datei Test_Stochastic_OnArrayRB.mq5 berechnet den Indikator basierend auf Preiszeitreihen. Die Anwendung der MainOnArray() Methode wird demonstriert
2. Die Datei  Test_Stochastic_OnValueRB.mq5 demonstriert die Verwendung der MainOnValue() Methode. Zuerst wird der Stochastic Oscilator Indikator berechnet und gezeichnet. Dann werden auf Basis des Ringbuffer dieses Indikators zwei weitere Stochastic Oscilator Linien gezeichnet. 

Das Ergebnis der Arbeit des Test_Stochastic_OnArrayRB.mq5 mit der Größe des Ringbuffers von 256 Elementen

Das Ergebnis der Arbeit des Test_Stochastic_OnValueRB.mq5 mit der Größe des Ringbuffers von 256 Elementen

Bei der Programmierung wurden die Entwicklungen der MetaQuotes Software Corp., Integer und GODZILLA verwendet.