Индикатор предназначен для лёгкого построения синтетических графиков с участим различных финансовых инструментов.  Каждый график задаётся в виде обычной математической формулы.

Например, если нужно построить график спрэда (разности) между EURUSD и GBPUSD с коэффициентами 4 и 3 соответственно, то задаём такую формулу:

И получаем график:

Это один из простейших примеров.  Индикатор позволяет строить гораздо более сложные вещи, используя в том числе разнообразные функции.

Для построения доступно до 8 графиков в одном окне.  Каждому из них в настройках индикатора задаётся своя формула.

Для написания формул используются стандартные математические операторы:

Операции сравнения выдают соответственно  1 или 0  (истина/ложь)

Приоритет операций также стандартный:    1.  ( )      2. ^      3. * /      4. + -      5. <=>

Если в формуле участвует название торгового инструмента (как в приведённом выше случае), то по умолчанию для него берутся цены закрытия свечи текущего таймфрейма.  Более расширенные возможности предоставляются с помощью функций, которые также можно неограниченно использовать в формулах:

-  ценовые функции

-  индикаторные функции МТ4 (полный набор)

-  математические функции

-  функции получения информации о символе, и прочие функции

-  а также возможность создавать свои собственные функции

Подробное описание всех функций приведено в конце.

Большинство функций поддерживают вложенные параметры, т.е. аргумент может быть задан в виде сложного выражения, в том числе с использование других функций.

В качестве примера приведу такую формулу: 

Получаем график корреляции приращений цен закрытия EURUSD и 1/USDCHF за 100 минутных баров:

Хотя данный пример можно было бы написать и гораздо проще (например пользуясь специальной функцией CorrelD).

В формулах можно ссылаться на другие формулы, указывая это в виде  F1, F2 и т.д.   Например:

При этом можно передавать им некоторые параметры (аргументы), тем самым создавая свою функцию-шаблон.  Для этого в исходной формуле  должны быть заданы шаблонные аргументы в виде значка #

Для уточнения порядка аргументов, можно их указывать в виде #1, #2  и т.д. 

Также имеется возможность привязаться к определённому бару, выбранному пользователем на графике.  Для этого предназначены функции LineOpen, LineClose, LineHigh и LineLow, LineVolume.   При их использовании появляется вертикальная красная линия на графике, задающая положение бара.  Её можно свободно двигать, выбирая нужный бар.  Для выбранного момента времени функция получает соответствующую цену (Open, Close, High или Low) по символу, заданному в функции.

Например, с помощью такой линии можно связать несколько графиков в одной точке:

Можно использовать и несколько линий. Для этого к названию функции добавляем индекс:  LineClose1, LineClose2 и т.д.   Получаем разные линии, работающие независимо друг от друга.

Все имена функций и торговых символов можно писать в любом регистре.

Пробелы между операторами/символами/функциями ставить необязательно.

Если в имени торгового символа присутствуют знаки, совпадающие с математическими, например символ GAZR-9.14, то его следует заключить в квадратные скобки:

При отсутствии требуемого символа в "Обзоре рынка" (и отсутствии истории по нему), производится попытка подгрузить историю для этого символа из соответствующего файла .hst в папке истории.  Благодая этому можно использовать "чужую" историю для построения графиков.

Если какой-то график нужно скрыть (не рисовать на экране), то его формулу можно "закомментировать" с помощью значка ' перед началом формулы:

Чтобы узнать точную формулу, по которой строится той или иной график, нужно навести мышкой на его формулу в углу окна, и во всплывающей подсказке будет указана полная формула расчёта.

Все графики синхронизируются по времени. Используемые ценовые данные тоже. При расчёте графика в каждой точке используются только прошлые или текущие цены для данной точки, т.е. индикатор не может заглядывать в будущее.

ПАРАМЕТРЫ ИНДИКАТОРА

• Shown Charts      - здесь можно вписать (через запятую или пробел) номера только тех формул, графики которых должны отображаться. Все остальные графики будут скрыты. Если ничего не указано, то отображаются все графики.

• Precision Digits    - точность отображаемых значений индикатора (количество знаков после запятой). Если задано auto, то точность определяется автоматически.

• TimeShift_minutes   - сдвижка по времени всех графиков относительно временной шкалы (в минутах)

• TimeSnap_Mode    - режим ограничения временной привязки полученных значений формулы к отображаемым барам индикатора. Может быть задано в барах ("bars"), либо в минутах ("minutes"). Если ничего не задано, то ограничения нет.  Под привязкой здесь понимается разница во времени между баром, для которого рассчитывается индикатор, и фактически рассчитанным значением формулы, которое может оказаться старее, чем данный бар.  Например если по символам, входящим в формулу, пропущены бары в данном месте, то для расчёта доступны только их прошлые (устаревшие) значения, и в итоге для данного бара можно получить только устаревшее значение формулы.  Нужно ли его рисовать на экране или оставить пропуск (разрыв графика), мы и выбираем в этом параметре.  Сам размер привязки задаётся с помощью следующего параметра.
  p.s. При этом сихронизация между всеми символами, входящими в формулу, всегда полная. Т.е. при сложении символа A с символом B складываются их значения на одном и том же баре.
• TimeSnap_Size    - максимальный размер привязки. Если временной лаг между рассчитываемым баром и полученным значением превышает данный размер, то бар не рисуется на экране.  Если задано -1, то ограничения привязки нет.

• Draw Mode   - режим отрисовки графика:
  - LINE  (линия)
  - BARS  (бары)
  - CANDLE  (свечи)
  - SECTION  (отрезки между непустыми значениями)
  - HISTOGRAM  (гистограмма) 
  - POINTS  (точки)
  - AUTO  (автоматический выбор в соответствии с выбранным режимом отображения в главном окне)
• Interpolation Timeframe  - таймфрейм для интерполяции внутрибаровых значений при построении синтетических баров (например для графика в виде баров).  По умолчанию M1.  Если такая интерполяция задействуется, то график строится лишь в пределах доступной истории по указанному таймфрейму.
  
  
• Auto Scale            - автомасштабирование графиков.  Здесь указывается номер главного графика, к размеру которого подгоняются все остальные графики. Если задано auto, то выбирается первый непустой график.  Если ничего не задано, то автомасштабирования нет.  Масштабирование производится не динамически, а только при ручном обновлении индикатора ("Обновить"), либо при инициализации индикатора.
  
  
• LabelsOnTheRight   - если TRUE, то формулы отображаются в правой части экрана, иначе в левой (по умолчанию)
  
  
• Show Bid/Ask      - если TRUE, то отображаются синтетические уровни Bid/Ask для каждого графика

• Signal_ChartNumber   - номер графика, для которого используются сигнальные значения и сигнальные линии. Можно перечислить несколько номеров (через пробел или запятую), соответственно для всех этих графиков будут работать сигналы.

• Signal_HighValue  - верхнее сигнальное значение, при достижении которого начнут подаваться звуковые сигналы и печататься сообщение в лог.
• Signal_LowValue  - нижнее сигнальное значение

• Signal_HighLine   - верхняя сигнальная линия, при достижении которой будет выдаваться сигнал и сообщение. Здесь указывается имя любой построенной на графике линии (горизонтальной или трендовой), которая и станет верхней границей.
   
• Signal_LowLine   - нижняя сигнальная линия
• Signal_CrossCharts   - номера графиков (через пробел или запятую), при пересечении которых требуется подавать сигнал.  Если указать более двух графиков, сигнал будет подаваться при пересечении любых двух их них.   Также можно указать несколько групп графиков, отделив их знаком ;   например  1,2;  6,7,8     Для каждой группы будет свой сигнал.
• Signal_Pause            - пауза между повторением одинаковых сигналов (в секундах)

• Save_ChartNumber  - номер графика, значения которого будут сохраняться в текстовый файл. Сохранение происходит только в момент полного пересчёта индикатора (при инициализации либо при ручном обновлении графика)

• Save_FileName         - имя файла, куда сохраняются значения графика

• Save_FileDelimiter   - текстовый разделитель, используемый в файле. Если ничего не задано, то используется символ табуляции.
  

ФУНКЦИИ

Здесь приведён полный перечень функций, разделённый по группам.  Описание параметров функций приведено в конце.

1. Группа ценовых функций

Получают указанный параметр бара. 

Open (symbol,  timeframe,  shift)        

Close (symbol,  timeframe,  shift)        

High (symbol,  timeframe,  shift)          

Low (symbol,  timeframe,  shift)

Volume (symbol,  timeframe,  shift)

LineOpen (symbol,  timeframe,  shift)     -  получают параметр бара для вертикальной линии

LineClose (symbol,  timeframe,  shift)

LineHigh (symbol,  timeframe,  shift)

LineLow (symbol,  timeframe,  shift)

LineVolume (symbol,  timeframe,  shift)

shift  -  это сдвижка в барах (влево) относительно текущего рассчитываемого бара

2. Группа стандартных индикаторных функций

Рассчитывают значение технических индикаторов, используемых в МТ4.  Синтаксис почти у всех совпадает с принятым в MQL4:  https://docs.mql4.com/ru/indicators

Отличия есть лишь у нескольких функций, имеющих в MQL4 параметр ma_shift, который здесь совмещён с параметром shift

ATR (symbol,  timeframe,  period,  shift)

StdDev (symbol,  timeframe,  period,  method,  applied_price,  shift)

AC (symbol,  timeframe,  shift)

AO (symbol,  timeframe,  shift)

AD (symbol,  timeframe,  applied_volume,  shift)

ADX (symbol,  timeframe,  period,  applied_price,  adx_mode,  shift)

Alligator (symbol,  timeframe,  jaw_period,  jaw_shift,  teeth_period,  teeth_shift,  lips_period,  lips_shift,  method,  applied_price,  gator_mode,  shift)

Gator (symbol,  timeframe,  jaw_period,  jaw_shift,  teeth_period,  teeth_shift,  lips_period,  lips_shift,  method,  applied_price,  gator_mode,  shift)

Bands (symbol,  timeframe,  period,  ,  applied_price,  bands_mode,  shift)

BearsPower (symbol,  timeframe,  period,  applied_price,  shift)

BullsPower (symbol,  timeframe,  period,  applied_price,  shift)

BWMFI (symbol,  timeframe,  applied_volume,  shift)

CCI (symbol,  timeframe,  period,  applied_price,  shift)

DeMarker (symbol,  timeframe,  period,  shift)

Envelopes (symbol,  timeframe,  period,  method,  applied_price,  ,  bands_mode,  shift)

Force (symbol,  timeframe,  period,  method,  applied_price,  applied_volume,  shift)

Fractals (symbol,  timeframe,  bands_mode,  shift)

Ichimoku (symbol,  timeframe,  period_tenkan,  period_kijun,  period_senkou,  ichimoku_mode,  shift)

MA (symbol,  timeframe,  period,  method,  applied_price,  shift)

MACD (symbol,  timeframe,  fast_period,  slow_period,  signal_period,  applied_price,  mode,  shift)

Momentum (symbol,  timeframe,  period,  applied_price,  shift)

MFI (symbol,  timeframe,  period,  shift)

RSI (symbol,  timeframe,  period,  applied_price,  shift)

Stochastic (symbol,  timeframe,  k_period,  d_period,  ,  method,  price_field,  mode,  shift)

OSMA (symbol,  timeframe,  fast_period,  slow_period,  signal_period,  applied_price,  shift)

OBV (symbol,  timeframe,  applied_volume,  shift)

SAR (symbol,  timeframe,  ,  ,  shift)

RVI (symbol,  timeframe,  period,  mode,  shift)

WPR (symbol,  timeframe,  period,  shift)

Maximum (symbol,  timeframe,  period,  applied_mode,  shift)     -  получает максимальную цену на заданном интервале

Minimum (symbol,  timeframe,  period,  applied_mode,  shift)      -  получает минимальную цену на заданном интервале

Следующие 10 функций дублируют функции максимума и минимума для частных случаев:

  MaxClose (symbol,  timeframe,  period,  shift)         - максимальная цена закрытия                                            

  MinClose (symbol,  timeframe,  period,  shift)          - минимальная цена закрытия

  MaxOpen (symbol,  timeframe,  period,  shift)         - максимальная цена открытия, и т.д.  

  MinOpen (symbol,  timeframe,  period,  shift)

  MaxHigh (symbol,  timeframe,  period,  shift)

  MinHigh (symbol,  timeframe,  period,  shift)

  MaxLow (symbol,  timeframe,  period,  shift)

  MinLow (symbol,  timeframe,  period,  shift)

  MaxVolume (symbol,  timeframe,  period,  shift)

  MinVolume (symbol,  timeframe,  period,  shift)

 
Примечание:   Не все индикаторные функции поддерживают вложенность аргумента  symbol (т.е. заданного в виде выражения).  Поддержка есть пока только у следующих функций  ATR,  Bands,  CCI,  Envelopes,  MA,  Momentum,  StdDev,  RSI,  Maximum,  Minimum.   В дальнейшем планируется расширить этот список.

3. Группа дополнительных индикаторных функций.

Здесь пока только функция корреляции:

Correlation (symbol1,  symbol2,  timeframe,  period,  shift),     либо можно писать сокращённо:  Correl

 рассчитывает коэффициент корреляции Пирсона между двумя символами (выражениями)  на заданном таймфрейме и периоде.  Необходимо учесть, что ценовые ряды symbol1 и symbol2 здесь используются как есть, т.е. корреляция считается по их абсолютным значениям, предполагая что они стационарны.

Для нестационарных рядов можно использовать функцию

CorrelationD (symbol1,  symbol2,  timeframe,  period,  shift),     либо можно писать сокращённо CorrelD

 которая считает корреляцию между дельтами (первыми разностями)  symbol1 и symbol2

4. Группа математических функций

Abs (a)                      - модуль значения a

Log (a,  b)                 - логарифм a по основанию b.  Если b не задано, то берётся натуральный логарифм

Log10 (a)                  - десятичный логарифм

Exp (a)                      - экспонента

Rand () или  Rnd ()   - случайная величина от 0 до 1

Round (a,  b)             - округление a до точности b (число знаков после запятой).  Если b не задано, то округляется до целого

Sign (a)                     - «знак» аргумента (-1 для отрицательного числа,  1 для положительного,  0 для 0)

Sin (a)                       - синус

Cos (a)                      - косинус

Tan (a)                      - тангенс

Max (a, b, …)             - максимальное значение из перечисленных аргументов (поддерживается до 8 аргументов)

Min (a, b, …)              - минимальное значение  из перечисленных аргументов

5. Группа функций для получения информации о символе

LotSize (symbol)        - размер лота

Tick (symbol)             - размер тика

Point (symbol)           - размер пункта

Pip (symbol)               - то же

Ask (symbol)              - цена аск

Bid (symbol)               - цена бид

Параметры функций:

В таблице приведена информация о параметрах. Их значения можно задавать как в числовом, так и в текстовом виде (при наличии)

Параметр	Значение по умолчанию	Возможные значения
symbol	0 =текущий символ основного окна)
timeframe	0 =текущий таймфрейм основного окна)	0,  M1, M5, M15, M30, H1, H4, D1, W1, MN1
shift	0
method	0	SMA =0,  EMA =1,  SMMA =2,  LWMA =3
applied_price	0	Close =0,  Open =1,   High =2,  Low =3,  Median =4, Typical =5,  Weighted =6
applied_mode	0	Open =0,  Low =1,  High =2,  Close =3,  Volume=4
applied_volume	0	Tick =0,  Real =1
mode	0	Main =0,  Signal =1
adx_mode	0	Main =0,  PlusDI =1,  MinusDI =2
bands_mode	0	Main =0,  Upper =1,  Lower =2
gator_mode	1	Jaw =1,  Teeth =2,  Lips=3
ichimoku_mode	1	Tenkan=1,  Kijun=2,  SenkouA=3,  SenkouB=4,  Chinkou=5
price_field	0	LowHigh =0,  CloseClose =1
period	100
fast_period	100
slow_period	200
signal_period	100
k_period	100
d_period	100
period_tenkan	9
period_kijun	26
period_senkou	52

И пара слов о параметре shift.   Помимо указания в параметрах функции, его также можно задать в квадратных скобках следом за функцией:

Скажите, Алексей, почему после удаления индикатора с графика, продолжается запись истории?

Как удалить процесс из памяти? 

не удалось посмотреть индикатор. кидаешь его в окно графика и ничего не происходит. как быть?

Приветствую!

Взял в аренду на месяц. При создании любого графика возникает ошибка "array out of range in 'ChartBuilder_main.mqh' (1991,7)"

и ничего не отрисовывается. Пытаюсь достучаться до автора - он пока не отвечает. Может кто-то сталкивался с такой проблемой?

Буду благодарен за помощь!

Прошу прощения за заминку с ответом. Ответил в личку.  Пока разбираюсь с ошибкой.

Добрый день!

Очень сильно тормозит в последнем билде МТ5. Проверьте, пожалуйста.

Сам нашёл и решил проблему: RefrashRate стоял слишком большой.

Hi,

I have a question with regard to creating Synthetic instrumnets. I am not getting enough history in Daily time frame although I have enough history for the symbols Iam using.

For Example: I type EURUSD + EURCAD

I can get a decent charted data all the way up to H4 Time Frame. But in Daily, I do not get enough data and in Weekly TF, it is just one or two bars.

I am attcahing a screenshot. I wait until the history is loaded by the indicator.

The same thing happens if I create a synthtic chart by MT5. But I thought the indicator will fix the problem and be better than the built-in feature of MT5.

Thanks

Hi mtharwat. Sorry for delay in response.  You have a history in synthetic chart too.  As you can see on your screenshot there is a dot plot at the left side.  And if you mean why is it a dot plot but not a candle plot, then the reason is you don't have enought history of lower timeframes to build your daily or weekly candles in this area.  Synthetic candles require a LOWER timeframe data for each symbol using in the formula.  By default this lower timeframe is M1.  But you can change it in the parameter "InterpolationTimeframe", for example H1. So the candles for synthetic chart D1 will only be built within the area where your both symbols (EURUSD and EURCAD) have H1 history.  Otherwise you will see a dot plot only which doesn't require a lower timeframe.

Зравствуйте!

Я только начал осваивать ваш индикатор. Хочу посчитать значения RSI, но мне выдаёт ошибку: Unavailable function : RSI. 

Можете помочь?

Приветствую, Иван.  Вероятно, это из-за того, что вы символ для RSI задаёте в виде формулы. Однако в текущей реализации RSI, к сожалению, может работать лишь на одиночном символе,  т.е. например RSI(EURUSD, H1, 100).   В дальнейшем я сделаю возможность её работы и с формулами.