开发 MT5 自定义指标:缓冲区、OnCalculate 与可靠的增量重算

开发 MT5 自定义指标:缓冲区、OnCalculate 与可靠的增量重算

从一个可以解释的值开始

有用的自定义指标在具有吸引人的颜色之前先有一份明确的计算约定。我们的示例报告当前收盘价位于最后 N 个柱的最高高点到最低低点范围内的位置。它会生成 0 到 100 之间的一个数字,或者在窗口不完整时生成空值。它不下单。这使得它适合作为单独的职责来学习计算、显示和验证。

明确写明计算约定:使用图表交易品种和时间周期,包括当前计算的 K 线,使用高点和低点而不是收盘价来建立范围,并返回 50 作为价格完全不变的窗口。收盘价超出其自身柱线的高低范围是要调查的不一致输入,而不是默默限制输出的原因。这些决定比指标名称更重要。

计算公式为 100 ×(收盘价 - 最低价)/(最高价 - 最低价)。这是一个范围位置教学示例,而不是声称重现平滑的随机指标。如果您稍后添加平滑,请对公式及其预热要求进行版本控制。

将计算与绘图约定分开

使用一个数据缓冲区和一个线图。终端拥有绑定缓冲区的大小;你的代码提供值。绑定缓冲区后,将它与循环所用输入数组都显式设为从旧到新的索引方向。那么索引 i 指的是最高价、最低价和收盘价的同一根柱线。避免将此约定与基于位置的 CopyBuffer 请求混合在一起,其中位置 0 表示当前柱。

前 N−1 个单元没有完整的窗口。将它们设为 EMPTY_VALUE 并将绘图的空值属性设置为相同的标记。零可以是有效的范围位置结果,不能兼作“未就绪”。 PLOT_DRAW_BEGIN 控制绘图起点,但显式初始化不可用的单元格也使数据协定更易于检查。

指标缓冲区索引从零开始,而诸如indicator_type1 之类的声明后缀指的是第一个图。应分别记录数据缓冲区和绘图的定义;它们的编号不能互换。

完整的教学实现

在 MetaEditor 中创建自定义指标并使用以下原创示例作为源码。该代码故意对每个重新计算的条形使用便于检查的 O(N) 扫描。这是供读者在自己的终端中检查和编译的参考实现,不代表已经编译的交付包或性能测试结论。

#property indicator_separate_window
#property indicator_buffers 1
#property indicator_plots 1
#property indicator_label1 "Range position"
#property indicator_type1 DRAW_LINE
#property indicator_color1 clrRoyalBlue
#property indicator_minimum 0
#property indicator_maximum 100
input int Period = 14;
double RangePosition[];

int OnInit()
{
   if(Period < 2) return INIT_PARAMETERS_INCORRECT;
   if(!SetIndexBuffer(0, RangePosition, INDICATOR_DATA))
      return INIT_FAILED;
   ArraySetAsSeries(RangePosition, false);
   PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, Period - 1);
   PlotIndexSetDouble(0, PLOT_EMPTY_VALUE, EMPTY_VALUE);
   IndicatorSetInteger(INDICATOR_DIGITS, 2);
   return INIT_SUCCEEDED;
}

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[])
{
   ArraySetAsSeries(high, false);
   ArraySetAsSeries(low, false);
   ArraySetAsSeries(close, false);
   bool reset = (prev_calculated <= 0 || prev_calculated > rates_total);
   if(reset) ArrayInitialize(RangePosition, EMPTY_VALUE);
   if(rates_total < Period) return 0;
   int start = reset ? Period - 1 : MathMax(Period - 1, prev_calculated - 1);
   for(int i = start; i < rates_total; ++i)
   {
      double hi = high[i], lo = low[i];
      for(int j = i - Period + 1; j < i; ++j)
      {
         hi = MathMax(hi, high[j]);
         lo = MathMin(lo, low[j]);
      }
      RangePosition[i] = (hi == lo) ? 50.0 :
                        100.0 * (close[i] - lo) / (hi - lo);
   }
   return rates_total;
}

了解四种重新计算情况

首次加载时,计算每个完整的窗口。在同一根 K 线的下一次报价更新时,重新计算最后一个柱:其最高价、最低价和收盘价都可能变化。当新的柱到达时,重新计算此前的最后一根 K 线并计算新的柱。当终端在历史记录更改后重置 prev_calculated 时,重建结果而不是信任旧前缀。 OnCalculate 参考描述了此重置行为。

返回 rates_total 告诉下一次调用处理了多少;它不会使当前柱成为已收盘 K 线。需要已收盘 K 线数据的读取端,仍应按正确的收盘时间戳选择数据。按照这个计算约定,当前 K 线尚未收盘时,最后一个绘图点随报价变化是预期行为。

不要通过仅保留缓存的最高点来进行优化,除非您还处理提供它的柱线离开窗口。单调队列可以减少工作量,但历史重置、相等高点和当前柱修订都需要显式处理。在引入更快的算法时,请保留这个简单的版本作为数值对照基准。

使用小规模数值测试样例进行验证

使用 N=3 和从旧到新排列的 K 线。令高点为 [12,13,14,15],低点为 [8,9,10,11],收盘价为 [10,12,13,11]。前两个输出为空。在索引 2 处,范围为 8 到 14,结果为 83.333333。在索引 3 处,窗口前进到范围 9 到 15,结果为 33.333333。这些是合成算术示例,而不是市场结果。

现在仅将最后收盘价从 11 更改为 14:仅应将最后输出更改为 83.333333。所有价格相等的三根价格完全相同的 K 线窗口产生 50。测试输入周期 1 并确认初始化拒绝它。测试少于三个条,并确认指标未暴露任何凭空产生的零值信号。

将同一测试样例的全量计算与增量计算进行比较。然后添加更早的 K 线并强制进行新的计算。按时间戳比较输出,考虑到更改的预热区域。视觉上平滑的线条不足以建立任何这些属性。

诊断空白或含义不清的绘图

如果没有出现任何内容,请检查初始化结果、可用 K 线、绘图类型、空值设置和Experts/Journal 日志。使用数据窗口区分通过样式隐藏的有效值和未计算的单元格。固定的 0-100 范围在这里是合适的,因为计算约定限定了这个范围;它会隐藏许多以价格计价的指标。

稍后添加 EA 读取器时,记录缓冲区 0 是数字范围位置,而不是买入/卖出信号。记录所选K 线时间戳与每个值。失败的数据复制请求必须保留缺失的观测值。这可以防止显示错误、数据准备问题和交易规则决策合并到一份模糊的“指标不起作用”报告中。

练习文件

这些 CSV 文件是合成教学数据,不是真实行情或投资结果。

本篇提供的 MQ5 示例尚未在 MT5 中编译或运行验证。

资料与延伸阅读

返回顶部

MQLume Bespoke

让想法,成为专属作品。

探索高级定制 →

有更具体的想法?聊聊高级定制。

通过站内客服或邮件告诉我们您的需求。我们一起确认开发范围和实现方案,定制服务单独报价。

100% 认真对待每一笔订单,持续跟进交付与售后。

免费下载,提供真实源码。

免费

Lizard [MQLume]

MQL5 / MT5版本 v2.21

免费的黄金突破源码项目:六个可独立选择的策略核心,配合时段过滤和灵活仓位设置。

US$149.00免费
免费

Scraper Gold [MQLume]

MQL5 / MT5版本 v3.7

免费可编辑源码,包含 EX5:四个黄金突破引擎,各自提供独立的模式、仓位、方向和退出控制。

US$95.00免费
免费

EA Black Dragon [MQLume]

MQL5 / MT5版本 v13.0

趋势入场,结合可选网格加仓、方向控制与虚拟出场。

US$30.00免费
MQLume

一起探索,也一起交流。

在你喜欢的平台,与 MQLume 保持连接。

YouTube

看看 EA 如何运行,了解回测表现、操作演示与实用教程。

前往 YouTube 观看

Telegram

与其他 EA 用户交流想法,分享使用心得,及时了解新品动态。

加入交流社区 关注官方更新

购物车

每个项目一份个人使用许可,同一商品仅加入一次。

购物车还在等它的第一位乘客。

选择 EA 或源码版,开始你的项目。

继续选购