ETraceSet.GetMinInIntervals (Получить минимум в интервалах из набора трасс)

Описание

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

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

Свойства

Тип переменной Scale входного аргумента scale содержит следующие значения:

• Linear - линейное масштабирование.
• Log - логарифмическое масштабирование.

Пример

Рассмотрим работу блока на примере простой программы, которая возвращает массив объектов типа ETrace, содержащих минимальные значения координат (Xmin, Ymin) из коллекции трейсов и лимитов ETraceSet .

Создадим глобальные переменные, необходимые для работы программы. Данные переменные мы будем использовать с привязкой к элементам управления интерфейса пользователя. ETrace – переменная, которая хранит объект типа ETrace. ETraceTag – идентификатор, который будет применяться для обращения к объектам типа ETrace в коллекции трейсов и лимитов ETraceSet. ETraceSet – переменная, которая хранит объект типа ETraceSet. intervalsCount – Количество интервалов. MinTracesArray – Массив объектов типа ETrace. Xpoints – Массив координат X. Ypoints – Массив координат Y.

Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».

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

Добавим на панель управления следующие элементы: Интерактивные элементы -> Кнопка; Ввод данных -> Поле ввода; Ввод данных -> Числовой ввод; Пользовательские -> Пользовательский тип.

Последовательно выберем каждый из добавленных элементов, в свойствах элементов введем соответствующие имена и выполним привязку значения к переменным следующим образом: TraceSet: значение -> переменная ETraceSet; Идентификатор: значение -> переменная ETraceTag. Количество интервалов: значение -> переменная intervalsCount.

Пример привязки элемента панели управления «TraceSet» к переменной ETraceSet показан на следующем рисунке.

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

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

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

Блок Handler будет срабатывать по событию нажатия кнопки.

Следующий блок - CreateInstance. Данный блок создает новый объект типа ETraceSet, который не содержит никаких данных.

Далее используем блок "If - else" для построения цикла на 11 итераций. Значение переменной i вначале цикла равняется нулю и наращивается на 1 после выполнения каждой итерации. При выполнении условия i<=10 блок принимает значение "True", иначе работа блока завершается через выход "False".

При выполнении каждой итерации цикла будут выполняться следующий действия. Используем блок CreateInstance для создания нового объекта типа ETrace, который передадим в переменную ETrace, как показано на рисунке.

Зададим идентификатор созданного трейса с помощью блока ETrace.SetTag. В качестве идентификатора будем использовать текущее значение номера итерации i, преобразованное в строковый тип данных с помощью функции i.ToString().

Зададим имя созданного трейса с помощью блока ETrace.SetName. В качестве имени будем использовать текущее значение номера итерации i, преобразованное в строковый тип данных с помощью функции i.ToString().

Сформируем массив координат Y из 10 случайных значений c помощью блока RandomArray, передадим полученный массив в переменную Ypoints.

Добавим массив Xpoints с координатами X и массив Ypoints с координатами Y в качестве значений объекта типа ETrace с помощью блока ETrace.AddPoints.

Элементы массива Xpoints заданы в качестве начального значения, как показано на следующем рисунке.

Добавим созданный трейс, который хранится в переменной ETrace в массив ETracesArray с помощью блока AddArrayValue.

Нарастим значение i на 1 с помощью блока SetVariable и функции i=i+1.

По окончании созданного цикла (условие i>10) добавим все объекты типа ETrace из массива ETracesArray в коллекцию трейсов и лимитов ETraceSet с помощью блока ETraceSet.AddTraces.

Далее воспользуемся блоком ETraceSet.GetMinInIntervals, чтобы получить трейсы с минимальными значениями на заданном количестве интервалов, при нижеуказанных настройках выполняется анализ объектов ETrace в коллекции ETraceSet, идентификаторы которых полностью совпадает с заданным. Разделение на интервалы выполняется с линейным масштабированием по шкале значений X.

Посмотрим, как работает пример. Введем значение "4" в качестве идентификатора, количество интервалов равным "2". Значение переменной MinTracesArray после выполнения программы можно просмотреть через вкладку "Контекст". Видно, что для идентификатора "4" выходной массив содержит один объект типа ETrace. То есть программа нашла только один трейс в коллекции TraceSet c указанным идентификатором, разделила массив данных этого трейса на два интервала и выбрала из каждого интервала два минимальных значения Ymin, а также соответствующие им значения Xmin, передав их в сформированный объект ETrace.