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

Блок "Тепловая карта"

Блок доступен начиная с версии 0.10

Назначение

Блок «Тепловая карта» используется для цветового анализа плотности или величины значений на двумерной сетке. Особенно полезен при работе с большими объемами данных, где табличное представление становится нечитаемым. Блок формирует визуализатор "Тепловая карта" на основе массива рядов, приходящих из другого блока.

Настройки визуализатора

Общие настройки блоков описаны в отдельном разделе.

Группа "Настройка диапазонов"

Наименование Тип Обязательное Описание Пример
Наименование диапазона Строка Нет Наименование диапазона. Используется только в настройках блока.
Значение диапазона Целое число Да Значение диапазона
Цвет диапазона Настройка цвета Да Цвет диапазона

Группа "Тепловая карта"

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

Для корректной работы совместно с блоком "Анимация", дата должна быть указана в формате** "%d.%m.%Y"

Дата указывается в формате Python.

Список всех доступных форматов для маски описан ниже:

Доступные форматы для маски 
%a Weekday as locale’s abbreviated name. Mon
%A Weekday as locale’s full name. Monday
%w Weekday as a decimal number, where 0 is Sunday and 6 is Saturday. 1
%d Day of the month as a zero-padded decimal number. 30
%-d Day of the month as a decimal number. (Platform specific) 30
%b Month as locale’s abbreviated name. Sep
%B Month as locale’s full name. September
%m Month as a zero-padded decimal number. 09
%-m Month as a decimal number. (Platform specific) 9
%y Year without century as a zero-padded decimal number. 13
%Y Year with century as a decimal number. 2013
%H Hour (24-hour clock) as a zero-padded decimal number. 07
%-H Hour (24-hour clock) as a decimal number. (Platform specific) 7
%I Hour (12-hour clock) as a zero-padded decimal number. 07
%-I Hour (12-hour clock) as a decimal number. (Platform specific) 7
%p Locale’s equivalent of either AM or PM. AM
%M Minute as a zero-padded decimal number. 06
%-M Minute as a decimal number. (Platform specific) 6
%S Second as a zero-padded decimal number. 05
%-S Second as a decimal number. (Platform specific) 5
%f Microsecond as a decimal number, zero-padded on the left. 000000
%z UTC offset in the form +HHMM or -HHMM (empty string if the the object is naive). 
%Z Time zone name (empty string if the object is naive). 
%j Day of the year as a zero-padded decimal number. 273
%-j Day of the year as a decimal number. (Platform specific) 273
%U Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0. 39
%W Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0. 39
%c Locale’s appropriate date and time representation. Mon Sep 30 07:06:05 2013
%x Locale’s appropriate date representation. 09/30/13
%X Locale’s appropriate time representation. 07:06:05
%% A literal '%' character. %
Пример настройки маски даты 
Исходная дата: 20 декабря 2015 года
Маска: %Y-%m-%d - указывается в параметре
Отображаемая дата: 2015-12-20 - в таком виде дата отобразится на диаграмме

Группа "Привязки"

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

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

Наименование Тип Обязательное Описание Пример
Наименование ряда данных Выпадающий список Нет Ключ атрибута, отвечающего за наименование ряда. Можно выбрать несколько значений. В этом случае они будут отображаться через разделитель -.
Наименование точек данных Выпадающий список Нет Ключ атрибута, отвечающий за наименование точек. Для временных рядов, в качестве точек используется дата, формат которой определяется маской времени (см. выше). В случае, если поле не задано, по умолчанию проставляются ключи точек.
Описание привязок JSON Нет Используются для отображения корректных наименований точек и рядов с данными.

Возможные параметры для настройки раздела "Описание привязок":

  • name - Ключ атрибута, отвечающего за наименование ряда. Возможно указать как строковое значение, так и массив из нескольких строк. В этом случае они будут отображаться через разделитель -.
  • label - Ключ атрибута, отвечающий за наименование точек. Строковое значение.
    • Для временных рядов в качестве точек используется дата, формат которой определяется маской времени (см. выше).
    • В случае, если поле не задано, по умолчанию указываются ключи точек.
Пример с единичным наименованием точек 
{
   "label": "region_name", 
   "name": "date"
}
Пример со множественным наименованием точек 
{
    "label": "region_name", 
    "name": ["date", "pok1"] 
}
Допустимый вариант единичного наименования точек 
{
    "label": "region_name", 
    "name": ["date"] 
}

Входы блока

Название входа Тип Обязательный Описание
Данные Ряд данных Да Массив данных с типом "Ряд данных"
Привязки Строка Нет Привязки которые приходят на вход блока используются вместо параметра настроек "Привязки".
Для динамической перестройки, к примеру, когда таблица является частью ОЛАПа, статичные привязки могут привести к некорректному отображению данных. Поэтому, в таких случаях, в таблицу нужно передавать и привязки.Формат привязок аналогичен описанию из настройки "Описание привязок".

Warning

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

Выходы блока

В блоке нет выходов

События блока

В блоке нет событий

Описание работы визуализатора

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

Настройки визуализатора

Общий список настроек доступен на странице Настройки визуализаторов.