ETrace.GetSubTrace
ETrace.GetSubTrace - возвращает объект типа ETrace, который содержит часть таблицы данных исходного объекта типа ETrace. Блок выбирает строки таблицы со значениями координаты X, которые находятся между заданными значениями StopX и StartX.
Свойства
| Входной аргумент | Тип аргумента | Тип переменной | Описание |
|---|---|---|---|
| ETrace | Variable | ETrace | Объект типа ETrace |
| StartX | Variable | Double | Минимальное значение X в выборке данных |
| StopX | Variable | Double | Максимальное значение X в выборке данных |
| Выходной аргумент | Тип аргумента | Тип переменной | Описание |
|---|---|---|---|
| ETrace | Variable | ETrace | Объект типа ETrace |
Пример
Рассмотрим работу блока на примере простой программы, которая обеспечивает считывание части данных из таблицы исходного объекта типа ETrace пользовательских точек трейса в массивы и дальнейшее их отображение на графике.
Создадим глобальные переменные, необходимые для работы программы. Данные переменные мы будем использовать с привязкой к элементам управления интерфейса пользователя.
ETrace – переменная типа ETrace, из которой мы будем получать часть таблицы данных.
StartX – минимальное значение X в выборке данных.
StopX – максимальное значение X в выборке данных.
Xpoints – массив значений X, в который будем считывать координаты всех точек по оси абсцис из объекта типа ETrace.
Ypoints – массив значений Y, в который будем считывать координаты всех точек по оси ординат из объекта типа ETrace.
Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».

Выберем элемент «Панель управления» и введем имя элемента. Нажмем кнопку «Создать»

Добавим на панель управления следующие элементы:
Интерактивные элементы -> Кнопка;
Визуализация данных -> Декартова диаграмма.
Ввод данных -> Числовой ввод (2 элемента);
Последовательно выберерем каждый из добавленных элементов, в свойствах элементов введем соответствующие имена и выполним привязку значения к переменным следующим образом:
Старт X: значение -> переменная StartX;
Стоп X: значение -> переменная StopX;
Пример привязки элемента панели управления «Стоп X» к переменной StopX показан на следующем рисунке.

Включим событие «Click» и введем имя в свойствах кнопки.

Нажмем правой кнопкой мыши по графику и выберем пункт меню «Настройка». Выполним настройку графика, как показано на следующем рисунке.

Перейдем на холст выполняемой программы. Действия программы будут происходить по нажатию пользователем на кнопку «Получить точки». Для этого запуск программы должен начинаться с отображения дашборда, Добавим блок «ShowDashboard» и выберем созданную панель управления в меню настройки:

Блок обработки события свяжем с программным алгоритмом, обеспечивающим соответствующие манипуляции с переменной ETrace. Добавим на холст блок ETrace.GetSubTrace.
В блоке Handler выберем созданное событие нажатия кнопки.
Следующий блок - ETrace.GetSubTrace. Здесь мы можем получить часть таблицы данных исходного объекта типа ETrace. Блок выбирает строки таблицы со значениями координаты X, которые находятся между заданными значениями StopX и StartX. Далее считаем данные из таблицы нового объекта ETrace в массивы Xpoints и Ypoints, которые также являются источником значений X и Y для графика на панели управления.
После передачи данных из трейса в массивы следует вызвать блок UpdateChart, который обеспечит отображение новых данных на графике пользовательского интерфейса. В свойствах выберем панель управления и график, который следует обновить.

Нажмем правой кнопкой мыши по переменной ETrace и выберем пункт меню «Редактировать начальное значение», как показано на следующем рисунке, чтобы внести данные, которые будут храниться в трейсе при запуске программы.
Посмотрим, как работает пример.