Перейти к содержанию

Функции

Функция - подпрограмма в выражении, выполняющая какую-либо операцию и возвращающая результат.

Обобщенно функцию можно представить так:

<имя>(<параметры>)

где:

  • имя - наименование функции;
  • параметры - параметры для выполнения функции.
  • Наименование функции регистрозависимо.
  • У некоторых функций есть русские наименования.

Встроенные функции

Встроенные функции - функции, взятые напрямую из Python. Ниже приведены некоторые из функций.

Полный перечень функций доступен в официальной документации: Python 3.10 Built-in Functions

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

all

all(<Массив>) → <Логический тип>

Возвращает <Истина> если все элементы массива являются Истиной. Функция работает только с Массивами.

any

any(<Массив>) → <Логический тип>

Возвращает <Истина> если любой элемент массива является Истиной. Функция работает только с Массивами.

len

len(<Массив>) → <Целое число>
Возвращает количество элементов массива. Функция работает только с Массивами.

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

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

Полный перечень функций доступен в официальной документации: math — Mathematical functions

Все математические функции работают с Целыми или Вещественными числами.

exp

exp([ <Целое число> | <Вещественное число> ]) → <Вещественное число>
Функция рассчитывает экспоненту в указанной степени - ex

log

log([ <Целое число> | <Вещественное число> ], (Не обязательное [ <Целое число> | <Вещественное число> ])) → <Вещественное число>
Функция рассчитывает логарифм первого числа по основанию второго числа. Если второй параметр не указан, вычисляется натуральный логарифм.

cos

cos([ <Целое число> | <Вещественное число> ]) → <Вещественное число>
Функция рассчитывает косинус числа. В радианах.

acos

acos([ <Целое число> | <Вещественное число> ]) → <Вещественное число>
Функция рассчитывает арккосинус числа. В радианах.

Математические функции - дополнительные

Кроме того, добавлены следующие функции, работающие с Массивами или Рядами:

diff

[ diff | АБС ]([ <Массив> | <Ряд> ]) → <Массив>
Функция рассчитывает абсолютный прирост ряда.

ratio

[ ratio | РОСТ ]([ <Массив> | <Ряд> ]) → <Массив>
Функция рассчитывает темп роста ряда.

pch

[ pch | ПРСТ ]([ <Массив> | <Ряд> ]) → <Массив>
Функция рассчитывает темп прироста ряда.

ln

[ ln | ЛОГ ]([ <Массив> | <Ряд> ]) → <Массив>
Функция осуществляет логарифмирование ряда.

dlog

[ dlog | ЛОГПРСТ ]([ <Массив> | <Ряд> ]) → <Массив>
Функция рассчитывает логарифмический прирост ряда.

norm

[ norm | НОРМ ]([ <Массив> | <Ряд> ]) → <Массив>
Функция осуществляет нормализацию ряда.

std

[ std | СТД ]([ <Массив> | <Ряд> ]) → <Массив>
Функция осуществляет стандартизацию ряда.

pchYtD

[ pchYtD | ГодПРСТ ]([ <Ряд> ]) → <Массив>
Функция рассчитывает годовой темп прирост временного ряда.

  • Функция работает только с временными рядами, т.е. ключ ряда должен быть датой.
  • Период должен быть не меньше месяца.

Статистические функции

min

[ min | МИН ]([ <Массив> | <Ряд> | <Словарь> | <Объект> ])
Функция рассчитывает минимальное значение. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается минимальное значение среди атрибутов.

minByKey

[ minByKey | МИНПоКлючу ]([ <Ряд> | <Объект> ])

Функция рассчитывает минимальное значение ключей ряда. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается минимальное значение среди ключей атрибутов.

max

[ max | МАКС ]([ <Массив> | <Ряд> | <Словарь> | <Объект> ])

Функция рассчитывает максимальное значение. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается максимальное значение среди атрибутов.

maxByKey

[ maxByKey | МАКСПоКлючу ]([ <Ряд> | <Объект> ])

Функция рассчитывает максимальное значение ключей ряда. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается максимальное значение среди ключей атрибутов.

avg

[ avg | СРД ]([ <Массив> | <Ряд> | <Словарь> | <Объект> ])
Функция рассчитывает среднее арифметическое значение. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается среднее арифметическое среди атрибутов.

avgByKey

[ avgByKey | СРДПоКлючу ]([ <Ряд> | <Объект> ])
Функция рассчитывает среднее арифметическое значение ключей ряда. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается среднее арифметическое среди ключей атрибутов.

median

[ median | МЕДИАНА ]([ <Массив> | <Ряд> | <Словарь> | <Объект> ])
Функция рассчитывает медианное значение. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается медиана среди атрибутов.

medianByKey

[ medianByKey | МЕДИАНАПоКлючу ]([ <Ряд> | <Объект> ])
Функция рассчитывает медианное значение ключей ряда. Формат результата зависит от формата элементов внутри массива. Для Объекта - высчитывается медиана среди ключей атрибутов.

Разное

Функции, не вошедшие в предыдущие пункты.

msg

[ msg | сообщить ](<Выражение>) → <Пустой элемент>

Вычисляет Выражение внутри себя и передает его на выход "Рекомендации". Актуально для блока "Правила".

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