6. Математические функции

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

• выражениях триггера
• вычисляемых элементах данных
• макросах выражений

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

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

Подробности функций

Некоторые общие замечания о параметрах функций:

• параметры функций разделяются запятыми
• в качестве параметров допустимы выражения
• необязательные параметры функций (или части параметров) обозначаются угловыми скобками < >

abs(значение)

Абсолютное значение (по модулю) значения.

Параметр:

• значение — проверяемое значение

Например, абсолютное значение как «3», так и «-3» будет «3».

Пример:

abs(last(/узел_сети/ключ))>10

acos(значение)

Арккосинус значения как угол, выраженный в радианах.

Параметр:

• значение — проверяемое значение

Значение должно быть в диапазоне от -1 до 1. Например, арккосинус значения «0.5» будет «2.0943951».

Пример:

acos(last(/узел_сети/ключ))

asin(значение)

Арксинус значения как угол, выраженный в радианах.

Параметр:

• значение — проверяемое значение

Значение должно быть в диапазоне от -1 до 1. Например, арксинус значения «0.5» будет «-0.523598776».

Пример:

asin(last(/узел_сети/ключ)) 

atan(значение)

Арктангенс значения как угол, выраженный в радианах.

Параметр:

• значение — проверяемое значение

Например, арктангенс значения «1» будет «0.785398163».

Пример:

atan(last(/узел_сети/ключ))

atan2(значение,абсцисса)

Арктангенс указанных координат ординаты (значение) и абсцисса как угол, выраженный в радианах.

Параметры:

• значение — проверяемое значение;
• абсцисса — значение абсциссы.

Например, арктангенс координат, где ордината и абсцисса имеют значение «1», будет «2.21429744».

Пример:

atan2(last(/узел_сети/ключ),2)

avg(<значение1>,<значение2>,...)

Среднее из значений, на которые ссылаются перечисленные элементы данных.

Параметр:

• значениеX — значение, возвращаемое другой функцией, работающей с историей элементов данных.

Пример:

avg(avg(/узел_сети/ключ,1h),avg(/узел_сети2/ключ2,1h))

cbrt(значение)

Кубический корень из значения.

Параметр:

• значение — проверяемое значение

Например, кубический корень из «64» будет «4», а из «63» будет «3.97905721».

Пример:

cbrt(last(/узел_сети/ключ))

ceil(значение)

Округлить значение вверх до ближайшего целого.

Параметр:

• значение — проверяемое значение

Например, «2.4» будет округлено до «3». Смотрите также floor().

Пример:

ceil(last(/узел_сети/ключ))

cos(значение)

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

Параметр:

• значение — проверяемое значение

Например, косинус значения «1» будет «0.54030230586».

Пример:

cos(last(/узел_сети/ключ))

cosh(значение)

Гиперболический косинус значения. Возвращает значение как действительное число, не в научной нотации.

Параметр:

• значение — проверяемое значение

Например, гиберболический косинус значения «1» будет «1.54308063482».

Пример:

cosh(last(/узел_сети/ключ))

cot(значение)

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

Параметр:

• значение — проверяемое значение

Например, котангенс значения «1» будет «0.54030230586».

Пример:

cot(last(/узел_сети/ключ))

degrees(значение)

Конвертация значения из радиан в градусы.

Параметр:

• значение — проверяемое значение

Например, значение «1», сконвертированное в градусы, будет «57.2957795».

Пример:

degrees(last(/узел_сети/ключ))

e

Число Эйлера (2.718281828459045).

Пример:

e()

exp(значение)

Число Эйлера (e) в степени значения.

Параметр:

• значение — проверяемое значение

Например, число Эйлера, возведённое в степень «2», будет «7.38905609893065».

Пример:

exp(last(/узел_сети/ключ))

expm1(значение)

Число Эйлера (e) в степени значения, минус один.

Параметр:

• значение — проверяемое значение

Например, число Эйлера, возведённое в степень «2», после вычитания единицы будет «6.38905609893065».

Пример:

expm1(last(/узел_сети/ключ))

floor(значение)

Округление вниз до ближайшего целого.

Параметр:

• значение — проверяемое значение

Например, «2.6» будет округлено вниз до «2». Смотрите также ceil().

Пример:

floor(last(/узел_сети/ключ))

log(значение)

Натуральный логарифм.

Параметр:

• значение — проверяемое значение

Например, натуральный логарифм значения «2» будет «0.69314718055994529».

Пример:

log(last(/узел_сети/ключ))

log10(значение)

Десятичный логарифм.

Параметр:

• значение — проверяемое значение

Например, десятичный логарифм значения «5» will be «0.69897000433».

Пример:

log10(last(/узел_сети/ключ))

max(<значение1>,<значение2>,...)

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

Параметр:

• значениеX — значение, возвращаемое другой функцией, работающей с историей элементов данных.

Пример:

max(avg(/узел_сети/ключ,1h),avg(/узел_сети2/ключ2,1h))

min(<значение1>,<значение2>,...)

Наименьшее из значений, на которые ссылаются перечисленные элементы данных.

Параметр:

• значениеX — значение, возвращаемое другой функцией, работающей с историей элементов данных.

Пример:

min(avg(/узел_сети/ключ,1h),avg(/узел_сети2/ключ2,1h))

mod(значение,делитель)

Остаток от деления.

Параметры:

• значение — проверяемое значение;
• делитель — знаменатель деления.

Например, остаток от деления значения «5» с делителем «2» будет «1».

Пример:

mod(last(/узел_сети/ключ),2)

pi

Константа пи (3.14159265358979).

Пример:

pi()

power(значение,степень)

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

Параметры:

• значение — проверяемое значение;
• степень — используемый показатель степени.

Например, третья степень значения «2» будет «8».

Пример:

power(last(/узел_сети/ключ),3)

radians(значение)

Конвертация значения из градусов в радианы.

Параметр:

• значение — проверяемое значение

Например, значение «1», сконвертированное в радианы, будет «0.0174532925».

Пример:

radians(last(/узел_сети/ключ))

rand

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

Пример:

rand()

round(значение,дес_знаков)

Округлить значение до десятичных знаков.

Параметры:

• значение — проверяемое значение;
• дес_знаков — количество десятичных знаков для округления (0 также допустим).

Например, значение «2.5482», округлённое до 2 десятичных знаков, будет «2.55».

Пример:

round(last(/узел_сети/ключ),2)

signum(значение)

Возвращает «-1» для отрицательного значения, «0» для нуля, «1» для положительного значения.

Параметр:

• значение — проверяемое значение.

Пример:

signum(last(/узел_сети/ключ))

sin(значение)

Синус значения, воспринимаемого как угол, выраженный в радианах.

Параметр:

• значение — проверяемое значение

Например, синус значения «1» будет «0.8414709848».

Пример:

sin(last(/узел_сети/ключ))

sinh(значение)

Гиперболический синус значения.

Параметр:

• значение — проверяемое значение

Например, гиперболический синус значения «1» будет «1.17520119364».

Пример:

sinh(last(/узел_сети/ключ))

sqrt(значение)

Квадратный корень значения.
Эта функция выдаст ошибку для отрицательного значения.

Параметр:

• значение — проверяемое значение

Например, квадратный корень из значения «3.5» will be «1.87082869339».

Пример:

sqrt(last(/узел_сети/ключ))

sum(<значение1>,<значение2>,...)

Сумма значений, на которые ссылаются перечисленные элементы данных.

Параметр:

• значениеX — значение, возвращаемое другой функцией, работающей с историей элементов данных.

Пример:

sum(avg(/узел_сети/ключ,1h),avg(/узел_сети2/ключ2,1h))

tan(значение)

Тангенс значения.

Параметр:

• значение — проверяемое значение

Например, тангенс значения «1» будет «1.55740772465».

Пример:

tan(last(/узел_сети/ключ))

truncate(значение,дес_знаков)

Усечение значения до указанного числа десятичных знаков.

Параметры:

• значение — проверяемое значение;
• дес_знаков — количество десятичных знаков, оставляемых после усечения (0 также допустим).

Например, значение как «2.5482», усечённое до 2 десятичных знаков, будет «2.54».

Пример:

truncate(last(/узел_сети/ключ),2)

См. все поддерживаемые функции.