Построение массива данных графика

Графики определяют несколько способов извлечения табличных данных из дерева контекстов AggreGate Server и их применения для построения массива данных графика.

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

Свойства графика, относящиеся к данным

Тип источника данных

Данный основной параметр определяет, какой тип данных должен использоваться для построения графика. Здесь представлены четыре варианта:

  • Пользовательские данные. Использование пользовательских табличных данных для построения графика.
  • Событие. Использование данных из истории событий и возникновений новых событий для построения и  динамического обновления графика.
  • Переменная. Использование данных из истории изменений переменной и изменений переменной в реальном времени для построения и динамического обновления графика.
  • Трендинг. Использование  массива данных другого графика для построения тренда, такого как "смещенная средняя", линейная/экспоненциальная регрессия и т.д.
  • Зависимый. Использование  массива данных другого графика для построения зависимого графика, который может обрабатывать исходный массив данных при помощи привязок зависимых графиков.

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

Имя свойства: source

Тип свойства: Целое

Исходные события

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

Каждые серии данных обладают следующими свойствами:

Свойство

Тип

Описание

Имя

строка

Имя серии данных, указанное на графике.

Контекст

строка

Контекст сервера, определяющий событие, из которого берутся данные.

Событие

строка

Событие, из которого берутся данные.

Выражение

строка

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

Среда вычисления выражения серии переменной:

Контекст по умолчанию

Определяется настройкой серии Контекст.

Таблица данных по умолчанию

Значение переменной, определяемой настройкой серии Событие.

Номер ряда по умолчанию

0

Переменные среды

Только стандартные переменные.

Выражение даты

строка

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

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

Среда вычисления выражения даты серии переменной:

Контекст по умолчанию

Определяется настройкой серии Контекст.

Таблица данных по умолчанию

Значение переменной, определяемой настройкой серии Событие.

Номер ряда по умолчанию

0

Переменные среды

Только стандартные переменные.

Агрегирование

целое

Определяет дальнейшие действия, если некоторые значения данных существуют в течении данного интервала времени. Возможные варианты: расчет среднего, взятие минимального или максимального значения, расчет суммарного значения, взятие первого/последнего значения для указанного интервала.

Имя свойства: eventSeries

Тип свойства: Таблица данных

Исходные переменные

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

Каждая серия данных обладает следующими свойствами:

Свойство

Тип

Описание

Имя

строка

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

Контекст

строка

Контекст сервера, определяющий событие, из которого берутся данные.

Переменная

строка

Переменная, из которой берутся данные.

Выражение

строка

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

Среда вычисления выражения серии переменной:

Контекст по умолчанию

Определяется настройкой серии Контест.

Таблица данных по умолчанию

Значение переменной, определяемое настройкой серии Переменная.

Ряд по умолчанию

0 (или динамическое, если включено свойство размножение серии).

Переменные среды

Только стандартные переменные.

Размножать

логическое

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

Агрегирование

целое

Определяет дальнейшие действия, если некоторые значения данных существуют в течение определенного интервала времени. Возможные варианты: расчет среднего, взятие минимального или максимального значения, расчет суммарного значения, взятие первого/последнего значения для указанного интервала.

Тип

целое

Тип серии данных.

Имя свойства: variableSeries

Тип свойства: Таблица данных

Период времени

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

Доступные единицы времени: Год, Квартал, Месяц, Неделя, День, Час, Минута и Секунда.

Имя свойства: timeUnit

Тип свойства: Целое

Включить исторические данные

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

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

Имя свойства: includeHistory

Тип свойства: Логическое

Включить текущие данные

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

Имя свойства: includeRealtime

Тип свойства: Логическое

Ограничить диапазон времени

Данное свойство относится к графикам, основанным на событии или на переменной. Поддерживаемые значения:

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

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

Имя свойства: enableTimeRange

Тип свойства: Логическое

Диапазон времени (в периодах времени)

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

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

Имя свойства: timeRange

Тип свойства: Целое

Начальная дата

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

Имя свойства: startDate

Тип свойства: Дата

Конечная дата

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

Имя свойства: endDate

Тип свойства: Дата

Исходные данные

Таблица исходных данных, используемая для построения графиков, основанных на пользовательских данных.

Имя свойства: sourceData

Тип свойства: Таблица данных

Привязки исходных данных

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

Имя свойства: chartBindings

Тип свойства: Таблица данных