使用环形缓冲区绘制ER的类 - MetaTrader 5脚本

描述

CEROnRingBuffer 类使用环形缓冲区算法自适应移动平均(Adaptive Moving Average, AMA) 中使用的技术指标效率比率(ER). 

声明

class CEROnRingBuffer : public CArrayRing

标题

#include <IncOnRingBuffer\CEROnRingBuffer.mqh>

CEROnRingBuffer.mqh 类文件必须放置在 IncOnRingBuffer 文件夹下, 该文件夹需要在 MQL5\Include\ 目录下创建. 在描述部分附加了使用本类的两个例子文件. 环形缓冲区的类文件也必须在此文件夹下.

类方法

//--- initialization method:
bool Init(                                  // 如果失败返回false, 如果成功返回true
   int            period        = 34,       // 计算ER的周期数  
   int            size_buffer   = 256,      // 环形缓冲区的大小, 存储数据的数量
   bool           as_series     = false     // 如果是时间序列则为true, 如果是输入数据通常的索引方式则为false
   );

//--- 基于时间序列或指标缓冲区的计算的方法:          
int MainOnArray(                  // 返回处理过的元素数量  
   const int     rates_total,     // 数组 array[] 的大小
   const int     prev_calculated, // 前一次调用处理的元素数量
   const double &array[]          // 输入数值的数组
   );

//--- //--- 基于数组的独立序列元素计算的方法           
double MainOnValue(              // 返回集合元素的 ER 数值
   const int    rates_total,     // 数组的大小
   const int    prev_calculated, // 处理过的数组元素数量
   const int    begin,           // 数组元素起点
   const double value,           // 数组中的元素数
   const int    index            // 元素索引
    );

//--- 访问数据的方法:
int    BarsRequired();   // 返回绘制指标所需的柱数
string Name()            // 返回指标名称
int    Period()          // 返回 ER 计算周期数
int    Size();           // 返回环形缓冲区大小

以通常数组的方式从环形缓冲区取得计算的指标值. 例子:

//--- 用于计算ER指标方法的类:
#include <IncOnRingBuffer\CEROnRingBuffer.mqh>
CEROnRingBuffer er;

...

//+------------------------------------------------------------------+
//| Custom indicator iteration function                              |
//+------------------------------------------------------------------+
int OnCalculate(const int    rates_total, 
                const int    prev_calculated, 
                const int    begin, 
                const double &price[]) 
  {
//--- 基于价格时间序列的计算:
   er.MainOnArray(rates_total,prev_calculated,price);

...

//--- 使用来自环形缓冲区 "er" 的数据,
//    例如把数据复制到指标缓冲区:
   for(int i=start;i<rates_total;i++)
     {
      ER_Buffer[i]   = er[rates_total-1-i];          // indicator line
     }
//--- 返回 prev_calculated 值用于下次调用:
   return(rates_total);
  }

例子

1. Test_ER_OnArrayRB.mq5 文件基于价格时间序列计算指标. 演示了 MainOnArray() 方法的应用
2. Test_ER_OnValueRB.mq5 演示了 MainOnValue() 方法的使用. 首先计算和绘制 ER 指标. 然后基于指标的环形缓冲区绘制另外一条 ER 线. 

Test_ER_OnArrayRB.mq5 使用256个元素大小的环形缓冲区的运行结果

Test_ER_OnValueRB.mq5 使用256个元素大小的环形缓冲区的运行结果

在MetaQuotes 软件公司.开发过程中, 使用了Integer 和 GODZILLA的部分代码.