Repaint Inspector
- Утилиты
-
Quoc Dat Quach
Software engineer with 8 years in fintech and mobile, writing MQL4/MQL5 since 2017. I build Expert Advisors, indicators, trade and risk-management panels and utilities for MT4/MT5, and I trade forex and gold on MT5 myself. - Версия: 1.0
Repaint Inspector измеряет, перерисовывает ли индикатор, вместо того чтобы принимать это утверждение на веру. Вы прикрепляете его к графику, указываете любой пользовательский индикатор и список его параметров, и он повторно считывает буферы этого индикатора на уже закрытых барах, подсчитывая каждое значение, которое изменяется, каждое значение, которое появляется, и каждое значение, которое исчезает, а также то, насколько далеко в истории это всё ещё происходит.
Это измерительный инструмент. На графике он никогда не отправляет ордеров. В Тестере стратегий он в начале открывает и закрывает одну позицию минимального объёма, потому что автоматический тест MQL5 Market проверяет, что советник выполняет торговую операцию; об этой сделке сообщается в журнале, она не входит в измерение, и её можно отключить входным параметром. Он не использует DLL и доступ к сети и ничего не записывает на диск, кроме двух своих CSV-файлов в MQL5\Files.
Зачем он нужен: «не перерисовывает» — частое утверждение в описании индикатора, и проверить его трудно. Обычная проверка — посмотреть на график, примерно запомнить, где стояли стрелки, перезагрузить и посмотреть снова. Такая проверка пропускает два случая, которые стоят денег. Первый — значение на баре, закрывшемся некоторое время назад, меняется, пока график остаётся открытым: стрелка сдвигается на несколько пикселей или удаляется, пока ваше внимание приковано к правому краю. Второй — индикатор, который ведёт себя корректно, пока работает, а после перезагрузки публикует другую историю, и именно это происходит у пользователя при смене таймфрейма, перезапуске терминала или на новом графике. Оба случая поддаются измерению.
Как определено измерение — именно от этого зависит, имеет ли результат какой-либо смысл:
- Бар идентифицируется по времени открытия и никогда — по сдвигу, поэтому новые бары, прокрутка и подгрузка истории не могут быть приняты за изменение.
- Сравниваются только закрытые бары, со сдвигом 1 и больше. Бар, который ещё формируется, меняется по определению и ничего не говорит о перерисовке.
- Первое значение, увиденное для закрытого бара, становится эталоном. Каждое последующее считывание сравнивается с предыдущим считыванием — это сравнение засчитывает событие, — а всякий раз, когда событие засчитано, ещё и с первым считыванием — это сравнение измеряет дрейф.
- Три вида событий считаются отдельно, потому что они не одинаково плохи. Changed: значение сменилось на другое. Appeared: пустая ячейка получила значение, то есть сигнал возник на баре, который уже был закрыт. Vanished: опубликованное значение стёрто — это серьёзный вид, потому что сигнала, по которому действовал трейдер, больше нет в истории, которую увидит тот, кто прочтёт её следующим.
- Главное число — MaxShift, наибольший сдвиг, на котором когда-либо было замечено хоть одно событие. Индикатор, который перерисовывает только последний закрытый бар, — совсем не то же самое, что индикатор, переписывающий пятнадцать баров.
- Каждое событие записывается в CSV-файл со временем обнаружения, временем бара, сдвигом в момент обнаружения, буфером, видом события, старым и новым значением, разницей, дрейфом от первого считывания и флагом «после перезагрузки», так что отчёт можно пересчитать, а не принимать на веру. Второй файл содержит по одной строке на буфер со всеми счётчиками и обновляется каждые 15 секунд, пока идёт прогон.
- Проверяемый индикатор создаётся через IndicatorCreate из разобранного списка параметров, поэтому любой пользовательский индикатор можно проверить, ничего не редактируя и не перекомпилируя. Разобранный список выводится в журнал при запуске, так что ошибка в списке параметров становится видна, а не проходит молча.
- Хэндл можно освобождать и создавать заново каждые N минут, намеренно сохраняя записанную историю, — это нужно, чтобы поймать индикатор, который ведёт себя тихо, пока работает, а после перезагрузки публикует другое прошлое. Терминал пересчитывает индикатор при перезагрузке только тогда, когда ни одна другая программа не держит тот же индикатор с теми же параметрами, поэтому на время этого теста уберите этот индикатор со своих графиков.
- Проверка отбрасывается и засчитывается как пропущенная, а не как свидетельство, если хэндл ещё не существует, индикатор ещё не рассчитан, закрытых баров меньше, чем отслеживаемая глубина (при первой пригодной проверке сама глубина урезается до доступной истории, и журнал об этом сообщает), буфер не удаётся скопировать или таймсерия сдвигается между чтением времени и чтением значений.
Измерения сделаны на индикаторах, которые поставляются с терминалом, поэтому повторить их может любой. Четыре копии на четырёх графиках одного терминала, XAUUSD M1, 1 час 26 минут, отслеживалось 300 закрытых баров, одна проверка в секунду:
- Examples\ZigZag (12,5,3): 1 315 713 сравнений на буфер, 0 изменённых, 0 появившихся, 17 исчезнувших на отображаемом буфере с MaxShift 15, а на двух расчётных буферах — 3 и 10 исчезнувших. Ни одно значение не изменилось, потому что экстремум ZigZag — это максимум или минимум своего бара и дрейфовать не может; он удаляется и публикуется заново в другом месте.
- Examples\Custom Moving Average (13,0,2): 1 305 513 сравнений, ни одного события.
- Examples\Fractals: 25 событий, все Appeared, ни одного Changed, ни одного Vanished, все на сдвиге 3. Это не перерисовка, а запоздалое подтверждение, поскольку фракталу нужны ещё два бара, прежде чем его можно нарисовать; сравнений при этом было 1 303 713. Строка вердикта всё равно показывает REPAINTS, потому что инструмент сообщает то, что увидел, и оставляет вывод вам: если все события — Appeared на одном фиксированном сдвиге, это пригодный индикатор с известной задержкой; если события — Vanished на разбросанных сдвигах, то нет.
- Четвёртая копия запускала тот же ZigZag, где 0.0 считался обычным значением, а не отсутствием значения: 1 308 513 сравнений, 32 события, все Changed, тот же MaxShift 15 и наибольшая абсолютная разница 4184,088 — это цена золота, потому что каждое удаление теперь выглядит как пик, заменённый на 0.0. Та же перерисовка, только под другим названием.
Эти три прогона — ZigZag, скользящая средняя и Fractals — выполнили 4 387, 4 353 и 4 347 проверок. Тот же инструмент в Тестере стратегий сжимает день до секунд: тот же ZigZag за один торговый день XAUUSD M1, режим моделирования «1 минутные OHLC», дал 5 512 проверок, 1 651 923 сравнения, 342 исчезнувших и 3 появившихся значения на барах, которые на тот момент были закрыты, 343 различных затронутых бара и MaxShift 28.
Независимая проверка счётчиков. Независимая реализация Examples\ZigZag на Python была прогнана по исходным свечам, выгруженным из терминала, и сверена с файлами событий. Прогон на живом графике: для каждого из 17 баров, на которых отображаемый буфер потерял значение, это значение отсутствует в повторном расчёте, и для всех 17 последнее считывание инструмента совпадает с пересчитанным значением. Прогон в тестере: 343 бара с событиями, из них 341 — бары, потерявшие значение; те же две проверки, ни одного расхождения. Сходится и количество сравнений: за время прогона на живом графике открылось 87 новых баров M1, и (число проверок минус 1), умноженное на 300, минус 87 в точности воспроизводит каждое указанное количество сравнений.
Входные параметры: путь iCustom к проверяемому индикатору и его параметры списком через запятую, число отслеживаемых буферов (от 1 до 32), символ и таймфрейм, если нужно проверять их не на текущем графике, число отслеживаемых закрытых баров (по умолчанию 300), минимальное число секунд между проверками (по умолчанию 1, в тестере — модельное время), абсолютный допуск, ниже которого изменение игнорируется, переключатель, при котором 0.0 считается отсутствием значения для буферов стрелочного типа и типа ZigZag (по умолчанию включён), интервал пересоздания хэндла, необязательная остановка через N минут, переключатель CSV, имя файла и лимит строк, настройки панели (показать или скрыть, угол, отступы, размер шрифта и пять цветов) и переключатель описанной выше пробной сделки в Тестере стратегий. Каждый входной параметр описан собственным комментарием в терминале. Путь по умолчанию намеренно пуст: если ничего не заполнено, инструмент сообщает об этом в журнале и на панели и ничего не измеряет, вместо того чтобы указывать на индикатор, которого может не быть в вашем терминале.
Ограничения — без прикрас. Инструмент не может доказать отсутствие перерисовки; он может лишь не найти её за измеренный период, поэтому рядом с каждым вердиктом стоит число сравнений. Он делает выборку с интервалом проверки, поэтому значение, которое появляется и исчезает в пределах одного интервала, может быть пропущено: так случилось один раз за полтора часа, описанных выше, — две копии ZigZag, запущенные с разницей в 14 секунд, расходятся в одном баре (03:32, на двух буферах), значение которого существовало меньше одного интервала проверки, поэтому одна копия его зафиксировала, а другая нет. Он измеряет то, что индикатор публикует через свои буферы, поэтому индикатор, который рисует графические объекты вместо заполнения буферов, для него невидим. В Тестере стратегий проверяемый индикатор должен присутствовать и быть скомпилирован до начала прогона: тестер считает неудачный IndicatorCreate критической ошибкой и выгружает советник, и никакая обработка ошибок внутри инструмента этого не изменит. На живом графике тот же неверный путь не фатален: инструмент остаётся на графике и повторяет попытку каждые 30 секунд, так что входной параметр можно исправить, не удаляя инструмент.
Пробная сделка в Тестере стратегий использует минимальный объём символа, отправляется без стоп-лосса и тейк-профита, а маржа перед отправкой проверяется по свободной марже, так что при маленьком тестовом депозите в журнале появляется строка, а не отклонённый ордер. У неё собственный магический номер, затем она закрывается на одном из последующих тиков, и она не затрагивает ни один счётчик, вердикт или строку CSV измерения. Измерено на депозите тестера 1000 USD: одна позиция, две сделки, 0,06 USD издержек, а при проверке Examples\ZigZag на том же диапазоне все счётчики перерисовки совпали со сборкой, в которой торгового кода нет вовсе, вплоть до 3 404 353 сравнений, 10 исчезнувших значений и MaxShift 17.
Практические ограничения. Произведение числа баров на число буферов не может превышать 200 000 ячеек — это защита памяти; сверх этого глубина уменьшается, и в журнал пишется одна строка. Это советник, поэтому он занимает единственное место для советника на графике: одна копия на график, и не на графике, где работает ваш собственный советник, хотя копии могут одновременно работать на нескольких графиках. Запрашивайте только те буферы, которые у индикатора действительно есть, потому что несуществующий буфер проваливает каждую проверку, и после пяти строк в журнале такие сбои только засчитываются как пропущенные. Заданное вами имя CSV-файла перезаписывается при каждом запуске; автоматическое имя содержит минуту запуска. В Тестере стратегий файлы записываются в собственную папку MQL5\Files агента тестирования, а не терминала, и перерисовка, замеченная в тестере, и перерисовка, замеченная вживую, — не обязательно одно и то же: когда ответ важен, запускайте вживую. Наконец, инструмент ничего не говорит о том, стоит ли торговать по индикатору: неперерисовывающий индикатор всё равно может быть бесполезным, а некоторые перерисовывающие индикаторы используются намеренно и правильно.
