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

Чтобы добавить в датасет расчетную колонку, в окне редактирования датасета кликните на кнопку  в строке "Расчетные" над списком колонок. По клику кнопки открывается страница настройки расчетной колонки.

Страница состоит из полей и элементов, сверху вниз, слева направо:

• "Название" – поле для ввода названия колонки, которое будет отображаться в датасете.
• "Тип данных" – выпадающий список для выбора типа данных, который соответствует возвращаемому значению расчетной колонки. Возможные значения:
  • Строка;
  • Число;
  • Дата;
  • Булево.
• "Переменные" – блок для создания переменных из колонок датасета, чтобы использовать их значения в расчете.
• "Формула" – блок для написания алгоритма расчета на языке RPython.
• "Датасет" – блок с колонками датасета.
• "Превью" – блок для предпросмотра результата расчета.
• "Ошибка" – всплывающий в правой части страницы блок с сообщением об ошибке в настройках расчетной колонки.
• "Записать расчет в датасет" – параметр для управления записью результата расчета, который изменяет логику проведения расчета.

Тип данных   

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

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

Пример: расчетная колонка ниже показывает уровень урбанизации муниципальных образований РФ. Если городское население преобладает, возвращается числовое значение уровня урбанизации, вычисляемое по формуле, если нет - строковое "Сельская местность". При этом тип данных колонки - "Число".

Как видно из предпросмотра расчета, вместо строковых значений в числовой колонке отображаются пустые ячейки. Для того, чтобы отображался текст "Сельская местность", необходимо после сохранения расчетной колонки (кнопка "Создать") перейти в ее настройки и в поле "Значение вместо Null" ввести "Сельская местность".

Переменные

Переменные создаются из колонок датасета и позволяют обращаться к значениям в колонке. Так, через переменную District из колонки "Федеральный округ" для каждой строки расчетной колонки будет получено значение из соответствующей строки колонки "Федеральный округ".

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

После настройки блока "Переменные" нужно нажать на кнопку "Сохранить" в правом верхнем углу блока, тогда станет активным блок "Формула", а в правом верхнем углу блока "Переменные" появится кнопка "Редактировать", по нажатию на которую можно снова вносить изменения в блок:

При нажатии на кнопку "Отменить" в блоке "Переменные" все внесенные изменения отменяются. 

Чтобы удалить настроенную переменную, кликните для соответствующей переменной кнопку .

Формула

Блок "Формула" предназначен для написания алгоритма расчета на языке RPython. Ключевое слово return используется для передачи значения в расчетную колонку.

Чтобы получить результат расчета, напишите алгоритм и кликните в блоке кнопку "Рассчитать".

—

В следующем примере используются дополнительные переменные, объявленные в блоке.

Превью

По клику кнопки "Рассчитать" в блоке превью отображается расчетная колонка с результатом расчета, а также колонки, которые вынесены в блок "Переменные", независимо от того, используются ли они в алгоритме расчета. Это может быть использовано для удобства предпросмотра.

Ошибка

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

Исключение составляет ошибка приведения типа данных, возвращаемых формулой, к типу данных расчетной колонки. Ошибка при этом не отображается, а система следует правилам обработки неприводимых типов данных.

Записать расчет в датасет

Параметр управляет записью результата расчета в датасет.

Когда параметр включен, результат расчета записывается в датасет и такая расчетная колонка:

• выполняет расчет построчно, игнорируя методы агрегации, задаваемые для переменных в блоке "Переменные";
• может быть использована для сортировки и фильтрации;
• обновляется только с обновлением датасета, изменением SQL-запроса, удалением или добавлением колонки датасета, а также после ее редактирования и сохранения изменений;
• позволяет управлять агрегацией через настройки полей данных с агрегацией.

Когда параметр выключен, результат расчета НЕ записывается в датасет, а запрашивается во время обращения к данным датасета и такая расчетная колонка:

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

Для расчетной колонки, сохраненной с включенным параметром, на странице настройки датасета в блоке колонок, отображается пиктограмма . Для расчетной колонки с выключенным параметром – пиктограмма .

Агрегация

Применение агрегации перед расчетом позволяет рассчитывать значения для любого уровня детализации. Без применения агрегации расчет выполняется построчно.

Чтобы расчетная колонка применяла агрегацию перед расчетом, требуется совместное выполнение условий:

• параметр "Записать расчет в датасет" выключен;
• расчетная колонка используется в поле данных с агрегацией.

Агрегация перед расчетом НЕ применяется в любом плоском представлении данных:

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

Для разных типов данных доступны разные методы агрегации.

• Для типа данных "Число": 
  • Sum - сумма;
  • Avg - среднее арифметическое;
  • Min, Max - минимум и максимум;
  • Соunt - количество записей;
  • Count Distinct - точное количество записей, включая пустые.
• Для типов данных  "Дата" и  "Строка":
  • Min, Max - минимум и максимум, берутся из связанной числовой колонки;
  • Соunt - количество записей;
  • Count Distinct - точное количество записей, включая пустые.
• Для типа данных "Булево":
  • Соunt - количество записей;
  • Count Distinct - точное количество записей, включая пустые.

Примеры

Пусть есть набор данных:

—

Создадим расчетную колонку с формулой "Значение 1 / Значение 2" с записью в датасет. Без применения агрегации перед расчетом результат расчета выполняется построчно и записывается в датасет:

—

Детализация по такой колонке использует агрегацию уже рассчитанных значений. Пример с методом агрегации SUM:

—

Создадим вторую колонку с такой же формулой без записи в датасет. Детализация по такой колонке вызывает агрегацию перед расчетом значений. Пример с методом агрегации SUM для переменных "Значение 1" и "Значение 2":

—

—

Сравнение колонок на виджете:

—

—

—

—

Пример с методом агрегации SUM для переменной "Значение 1" и COUNT для переменной "Значение 2":

—

—

Сравнение колонок на виджете:

—

—

—

—

Пример с методом агрегации MAX для переменной "Значение 1" и COUNT DISTINCT для переменной "Значение 2":

—

—

Сравнение колонок на виджете:

—

—

—

—

Создадим на том же наборе данных расчетную колонку с формулой "(Значение 2) if (Колонка 1) == "А" else 0" с записью в датасет. Без применения агрегации перед расчетом результат расчета выполняется построчно и записывается в датасет:

—

Детализация по такой колонке использует агрегацию уже рассчитанных значений. Пример с методом агрегации SUM:

—

Создадим вторую колонку с такой же формулой без записи в датасет. Детализация по такой колонке вызывает агрегацию перед расчетом значений. Пример с методом агрегации COUNT для переменной "Значение 1" и SUM для переменной "Значение 2":

—

Поскольку для каждого уровня детализации выполнялась агрегация перед расчетом, то в переменную Column1 перед каждым расчетом передавалось значение "5", то есть агрегированное значение по колонке "Колонка 1". В результате выражение везде вернуло результат "0", так как "5" не равно "А".

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

—

Но на виджете видим, что значение для колонки без записи – "0":

Удаление колонки датасета, используемой в расчете

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

Для подтверждения удаления нужно нажать кнопку "Удалить", для отмены - "Отменить".