Операции в выражениях для расчета вычислимых тегов

Арифметические действия

Сложение

Сложение двух или более аргументов.

"x" + "y"

Вычитание

Вычитание двух или более аргументов.

"x" - "y"

Умножение

Умножение двух или более аргументов.

"x" * 2

Деление

Деление двух или более аргументов.

"x" / 6

Возведение в степень

Возведение аргумента в степень.

"x" ** 3

Операции сравнения

Равно (==)

Возвращает 1.0, если части выражения равны, иначе возвращает 0.0.

"y" - "z" == -90

Больше (>)

Возвращает 1.0, если левая часть выражения больше правой части выражения, иначе возвращает 0.0.

"y" > 5

Меньше (<)

Возвращает 1.0, если левая часть выражения меньше правой части выражения, иначе возвращает 0.0.

99 < "y" ** 2

Больше или равно (>=)

Возвращает 1.0, если левая часть больше или равна правой части выражения, иначе возвращает 0.0.

"y" ** 2 >= "z"

Меньше или равно (<=)

Возвращает 1.0, если левая часть меньше или равна правой части выражения, иначе возвращает 0.0.

"y" ** 2 <= "z"

Не равно (!=)

Возвращает 1.0, если части выражения не равны, иначе возвращает 0.0.

"y" ** 2 != "z"

Логические операции

ИЛИ (|)

Возвращает значение 1.0, если хотя бы один из операндов истинен. Возвращает 0.0, если все операнды ложны.

("x" != 0) | (("y" + "z") > 105.5)

И (&)

Возвращает значение 1.0, если все операнды выражения истинны. Возвращает 0.0, если хотя бы один из операндов ложен.

("x" != 0) & (("y" + "z") > 105.5)

Функции

all()

Функция-редуктор.

Возвращает значение 1.0, если значения всех аргументов функции истинны в каждом узле РИВС в рамках окна. Возвращает значение 0.0, если хотя бы в одном узле РИВС какое-либо значение аргумента функции ложно.

all("y" > 11, w=3)

any()

Функция-редуктор.

Возвращает значение 1.0, если значение хотя бы одного аргумента функции истинно хотя бы в одном узле РИВС. Возвращает 0.0, если значение всех аргументов функции ложно во всех узлах РИВС.

any("y" > 11, w=3)

max()

Функция-редуктор.

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

max("x", 12, -"y" + 7)

min()

Функция-редуктор.

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

min("x", 12, -"y" + 7)

mean()

Функция-редуктор.

Возвращает среднее арифметическое значение набора переданных в функцию аргументов. Рассматриваются все значения аргументов в рамках заданного окна.

mean("x", 12, -"y" + 7)

maxtag()

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

maxtag("x", "y" w=3)

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

mintag()

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

mintag("x", "y" w=3)

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

meantag()

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

meantag("x", "y", w=3)

Результатом вычисления функции будет вектор средних арифметических значений для тегов x и y в каждом узле заданного окна.

grad()

Вычисляет градиент массива переданных в функцию аргументов. Под градиентом аргумента в узле РИВС понимается разность между значением аргумента в этом узле и значением этого же аргумента в предыдущем узле РИВС.

Функция может быть использована с параметрами w и order. Параметр order используется для указания порядка при расчете градиента. Например, order=2 соответствует второму порядку. По умолчанию параметр order имеет значение 1.

Градиент первого порядка (order=1) вычисляется над значениями аргументов функции (над каждым аргументом отдельно). Результат представляет собой вектор длины w – 1.

Градиент более высокого порядка вычисляется над результатами вычисления градиента предыдущего порядка. Результатов применения функции является один или несколько (по числу аргументов) векторов длиной w – order.

• grad("x", w=5, order=2)

  Результатом вычисления функции будет вектор из трех значений.

• grad("x", "y", w=5, order=2)

  На вход подано окно из пяти значений. Градиент первого порядка на этом окне вернет результат длиной 4, а градиент второго порядка вернет результат длиной 3. Результатом вычисления функции будут два вектора из трех значений.

pwd()

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

Функция используется с параметрами w, how и absolute.

Параметр how регулирует принцип сравнения тегов. Предусмотрены следующие значения параметра:

• auto (по умолчанию). Регулирует автоматическое использование значений over_tags и over_time в зависимости от количества тегов, переданных в функцию в виде аргументов, и длины окна. Если в функцию передан один тег в качестве аргумента, параметру автоматически присваивается значение over_time. Иначе параметру автоматически присваивается значение over_tags.
• over_tags. Операция выполняется над значениями всех аргументов отдельно в каждом узле РИВС в рамках окна. Результатом операции является w окон длиной n * (n - 1) / 2, где n соответствует числу аргументов, а w – длине входного окна.
• over_time. Операция выполняется над значениями каждого аргумента, полученными за промежуток времени длиной в заданное окно. Результатом операции является n окон длиной w * (w - 1) / 2, где n соответствует числу аргументов, а w – длине входного окна.

  Аргумент over_time необходимо использовать при окне с длиной более одного узла.

Параметр absolute регулирует приведение переданных значений к модулю. Предусмотрены следующие значения параметра:

• true (по умолчанию), если требуется привести результат вычисления функции к модулю.
• false, если приведение результата вычисления функции к модулю не требуется.

• pwd("w", "x", "y", "z")

  Результатом вычисления функции будут попарные расстояния, а именно строка из чисел ("x"-"w", "y"-"w", "z"-"w", "y"-"x", "z"-"x", "z"-"y"), при этом значения всех тегов взяты в текущем узле РИВС, и результат вычисления приводится к модулю.

• pwd("x", "y", "z", w=3, how=over_time)

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

take()

Возвращает значения аргументов в заданном окне.

Функция используется с параметрами w, n и default.

Параметр n определяет длину возвращаемого окна, считая от начала входного окна w. Например, функция take("x", w=4, n=2) вернет вектор из двух значений тега x в первом и втором узлах окна w. По умолчанию n=-1, что соответствует всем узлам входного окна.

Параметр default используется для заполнения значений тегов, не поступивших в узлах РИВС на заданном окне.

take("x", w=3, default=10)

Результатом функции будет вектор со значениями тега x в трех последних узлах РИВС. При этом, если для какого-то узла РИВС значение тега еще не поступило, в этом узле для тега будет использовано значение 10.

abs()

Возвращает абсолютное значение аргумента, не изменяя его размерности.

abs("x")

abs("x", w=3)

latest()

Возвращает последнее (текущее) значение аргумента. Функция принимает только один аргумент.

Функция latest() неявно применяется ко всему выражению, если результатом вычисления выражения является вектор (окно).