OS_Engine_team Блог компании Os_Engine

26 августа 2024, 11:13

Робот-пример «Чарт в окне параметров» CustomChartInParamWindowSample.

В окно параметров OsEngine можно выводить не только параметры, но и другие элементы, включая таблицы и чарты.

Данный пример робота служит демонстрацией реализации кастомного чарта в окне параметров.

В нем показано:

Динамический график: График обновляется в реальном времени по мере поступления новых данных.
Взаимодействие с пользователем: Пользователь может изменять масштаб графика и получать значения в конкретных точках.
Настраиваемые параметры: Возможность выбора метода расчета спреда и максимальное количество точек на графике.

1. Как это выглядит.

Заходим в тестер и запускаем нашего робота, открываем окно параметров.

1. Вкладка настроек «Prime»:

В ней находятся настройка режима вычисления спреда и параметр, отвечающий за количество отображаемых данных на чарте.

2. Вкладка настроек «Chart Spread»:

Здесь у нас находится сам чарт.

2. Где найти робота в проекте?

Ссылка на робота GitHub: https://github.com/AlexWan/OsEngine/blob/master/project/OsEngine

3. Разбор робота.

Строки 1-12:

Импортируются необходимые пространства имен:

Строки 24-27:

Определяется пространство имен OsEngine.Robots.TechSamples для организации кода и класс CustomChartInParamWindowSample наследует от BotPanel:

Строки 29-41:

Этот блок отвечает за набор переменных робота:

Строки 45-49:

Инициализируется панель бота:

Cоздаются две простые вкладки, сохраняется ссылка на вкладку в _tab0 и _tab1 для дальнейшего использования.

Строка 51-53:

Создание параметров робота:

Строки 55-64:

Создание вкладки и самого чарта для нее:

Создание вкладки и настройка ее размеров.

Строки73-81:

Переопределение методов GetNameStrategyType и ShowIndividualSettingsDialog.

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

Строки 86-118:

Запускаем фоновый поток для периодической проверки и обновления графика:

Метод StartPaintChart.

Периодически обновляет график на основе данных из двух источников (tab0 и tab1).

1. Инициализирует счетчики countCandlesTab0 и countCandlesTab1 для отслеживания количества обработанных свечей для каждого источника данных.
2. В бесконечном цикле выполняет следующие действия:

Ожидает одну секунду (Thread.Sleep(1000)).
Проверяет доступность данных для обоих источников (_tab0.Securiti != null и _tab1.Securiti != null).
Проверяет наличие новых свечей в обоих источниках (_tab0.CandlesFinishedOnly.Count и _tab1.CandlesFinishedOnly.Count).
Если количество свечей увеличилось для обоих источников, обновляет счетчики и вызывает метод LoadValueOnChart().

3. Обработка ошибок:

Метод заключен в блок try-catch для обработки исключений, возникающих во время выполнения. В случае ошибки выводится сообщение пользователю.

Строки 123-172:

Создаем чарт и подписываемся на все необходимые события:

Метод CreateChart:

1. Проверка потока:

Метод проверяет, вызывается ли он в правильном потоке (UI-потоке). Если нет, то вызывает себя рекурсивно из UI-потока, чтобы обеспечить правильную работу графического интерфейса.

2. Создание контейнера и графика:

Создается элемент WindowsFormsHost, который позволяет размещать элементы Windows Forms в приложениях WPF.
Создается объект Chart — это основной элемент для построения графиков в .NET.
График добавляется в качестве дочернего элемента к WindowsFormsHost.

3. Очистка существующих элементов:

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

4. Создание области графика:

Создается новая область графика ChartArea с именем «ChartAreaSpread».
Настраиваются различные свойства области, такие как:
- Включение возможности выделения области по оси X.
- Установка типа оси Y на вторичную.
- Настройка размеров и положения области.
- Установка цвета фона и меток осей.

5. Добавление области графика:

Созданная область добавляется в коллекцию областей графика.

6. Настройка внешнего вида графика:

Настраивается цвет и толщина курсора по оси X.
Устанавливается прозрачный фон для графика и областей.
Настраивается цвет меток осей X и Y.

7. Подписка на события:

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

8. Обработка ошибок:

Метод заключен в блок try-catch для обработки исключений, возникающих во время выполнения. В случае ошибки выводится сообщение пользователю.

Строки 174-178:

Создаем хранилище для нашего спреда и переменную, чтобы запоминать последнее значение метода вычисления спреда:

Строки 183-234:

Формируем серии данных для чарта:

Метод LoadValueOnChart:

Проверяет изменился ли режим расчета спреда (regimeSpread.ValueString) и очищает данные спреда (spreadData) при необходимости.
Ограничивает количество точек на графике (maxCountDotInLine.ValueInt), удаляя старые значения из spreadData.
Проверяет наличие данных из обоих источников (tab0 и tab1).
Вычисляет значение спреда в зависимости от выбранного режима расчета и добавляет его в список spreadData.
Создает серию данных (lineSeries) для графика.
Заполняет серию данными из списка spreadData.
Обновляет график с помощью метода SetSeries.

Строки 239-266:

Подгружаем серии данных на наш чарт:

Метод SetSeries:

1. Проверка потока:

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

2. Очистка графика:

Удаляет все существующие серии данных с графика, чтобы избежать дублирования и обеспечить отображение только актуальных данных.

3. Добавление новой серии:

Добавляет переданную серию данных lineSeries на график.

4. Проверка и настройка области графика:

Ищет область графика с именем «ChartAreaSpread».
Если область найдена и полоса прокрутки по оси X видна, то сдвигает представление графика вправо, чтобы отобразить новые данные.

5. Обновление размера и перерисовка графика:

Вызывает метод ChartResize() для обновления размера графика (подробности этого метода неизвестны).
Вызывает метод Refresh() для перерисовки графика и отображения изменений.

6. Обработка ошибок:

Метод заключен в блок try-catch для обработки исключений, возникающих во время выполнения. В случае ошибки выводится сообщение пользователю.

Строки 270-283:

События, отвечающие за изменение масштаба графика:

Строки 285-332:

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

Метод Chart_MouseClick:

1. Получение координат клика:

Получает координаты x точки клика относительно левого верхнего угла графика.

2. Преобразование координат:

Преобразует координату x пикселя в значение по оси X графика, используя метод PixelPositionToValue.

3. Округление и проверка:

Округляет полученное значение X вверх, чтобы найти ближайший индекс в массиве данных.
Проверяет, чтобы полученный индекс не выходил за пределы массива.

4. Удаление предыдущей аннотации:

Если уже существует аннотация, удаляет ее с графика.

5. Создание новой аннотации:

Создает новый объект TextAnnotation и задает его свойства:
- Текст аннотации: строка, содержащая индекс и значение ближайшей точки.
- Положение аннотации: привязывается к координате ближайшей точки на графике.
- Форматирование текста: шрифт, цвет и выравнивание текста.

6. Добавление аннотации на график:

Добавляет созданную аннотацию на график.

7. Обработка ошибок:

Метод заключен в блок try-catch для обработки исключений, возникающих во время выполнения. В случае ошибки выводится сообщение пользователю.

Строки 337-384:

Метод, который устанавливает границы графика по оси Y:

Метод ChartResize:

1. Проверка наличия данных:

Если список данных spreadData пуст, метод завершается.

2. Поиск объектов серии данных и области графика:

Ищет серию данных с именем «SeriesLine» и область графика с именем «ChartAreaSpread».
Если не найдена серия или область, метод завершается.

3. Определение видимой области по оси X:

start и end определяют индексы первого и последнего отображаемых элементов серии данных.
Если полоса прокрутки по оси X не видна, значения start и end равны 0 и количеству элементов в серии соответственно.
Если полоса прокрутки видна, то значения start и end рассчитываются на основе текущего положения и размера видимой области.

4. Определение минимального и максимального значений для отображения:

Вызывает методы GetMaxValueOnChart и GetMinValueOnChart для определения минимального и максимального значений в списке spreadData в пределах видимой области (start и end).

5. Обработка одинаковых минимального и максимального значений:

Если минимальное и максимальное значения совпадают:
- Если значение равно 0, устанавливает максимум равным 1.
- Иначе, устанавливает минимум равным 0.

6. Установка границ отображения по оси Y:

Устанавливает для оси Y2 области графика «ChartAreaSpread» полученные минимальное и максимальное значения.

7. Обработка ошибок:

Метод заключен в блок try-catch для обработки исключений, возникающих во время выполнения. В случае ошибки выводится сообщение пользователю.

Строки 389-420:

Методы для нахождения максимального и минимального значения из массива данных:

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

Удачных алгоритмов!

Комментарии открыты для друзей!