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

Beschreibung

Die CMomentumOnRingBuffer Klasse wurde zur Berechnung des technischen Indikators Momentum (Momentum)  mit Hilfe des Algorithmus des Ringbuffers entworfen. 

Deklaration

class CMomentumOnRingBuffer : public CArrayRing

Titel

#include <IncOnRingBuffer\CMomentumOnRingBuffer.mqh>

Die Datei der CMomentumOnRingBuffer.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 vom Ringbuffer muss auch in diesem Ordner sein.

Klassenmethoden

//--- initialization method:
bool Init(                  // gibt bei Fehler false zurück, bei Erfolg - true
   int  period      = 14,   // Periode des Momentum
   int  size_buffer = 256,  // Größe des Ringbuffers
   bool as_series   = false // true bei Zeitreihen, ansonsten false
   );
//--- Methode zur Berechnung basierend auf einer Zeitreihe oder einem Indikatorenbuffer:          
int MainOnArray(                  // gibt die Anzahl der verarbeiteten Element zurück  
   const int     rates_total,     // Größe des Array array[]
   const int     prev_calculated, // verabeitete Elemente im vorherigen Aufruf
   const double& array[],         // Array für die Eingabewerte
   );
//--- Methode zur Berechnung basierend auf separaten Reihenelementen des Arrays           
double MainOnValue(               // gibt den Wert des Momentum für das Mengenelement zurück
   const int    rates_total,      // die Größe des Arrays
   const int    prev_calculated,  // Elemente des Arrays verarbeitet
   const int    begin,            // von wo die signifikanten Daten des Arrays beginnen
   const long   value,            // Elementwert des Arrays
   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
int                 Period();       // Gibt die Periode 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 Momentum Indikators:
#include <IncOnRingBuffer\CMomentumOnRingBuffer.mqh>
CMomentumOnRingBuffer momentum;

...

//+------------------------------------------------------------------+
//| Benutzerdefinierte Indikatoriterationsfunktion                   |
//+------------------------------------------------------------------+
int OnCalculate (const int rates_total,      // the size of the array price[]
                 const int prev_calculated,  // verabeitete Elemente im vorherigen Aufruf
                 const int begin,            // von wo die signifikanten Daten des Arrays beginnen
                 const double& price[])      // Array für die Berechnung
  {
//--- Berechnung des Indikators basierend auf Preiszeitreihen:
   momentum.MainOnArray(rates_total,prev_calculated,price);

...
 
//--- verwende Daten des "Momentum" Ringbuffers,
//    zum Beispiel, kopiere Daten in den Indikatorbuffer:
   for(int i=start;i<rates_total && !IsStopped();i++)
      Momentum_Buffer[i] = momentum[rates_total-1-i]; // die Indikatorlinie

...

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

Beispiele

1. Die Test_Momentum_OnArrayRB.mq5 Datei berechnet den Indikatoren auf Basis der Preiszeitreihe. Die Anwendung der MainOnArray() Methode wird demonstriert
2. Die Test_Momentum_OnValueRB.mq5 Datei demonstriert die Verwendung der MainOnValue() Methode. Zuerst wird der Momentum Indikator berechnet und gezeichnet. Dann wird auf Basis des Ringbuffer dieses Indikators ein weiterer Momentum -Indikator gezeichnet. 

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

Das Ergebnis der Arbeit des Test_Momentum_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.