開發 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 或原始碼版,開始你的專案。

繼續選購