Гистограмма
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2505
SaaS

Гистограмма

В этой статье

Виджет отображает приближенные вычисления в виде дробного значения количества.

Пример гистограммы

Предупреждение

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

Настройки виджета

Помимо общих настроек, у виджета есть уникальные.

Настройка данных

В виджет можно добавить несколько разрезов, но отображаться будет только первый в списке. Разрез показывает данные только для колонок с типом Integer, Float, Date или DateTime. Для разрезов применимы стандартные настройки. Доступные настройки цвета:

  • Авто
  • Базовый (цвет выбирается в палитре)
  • По правилу (для значений доступны правила с режимом Базовый или Настроить)
  • Настроить (по формуле)

Настройка отображения

Помимо общих настроек отображения, для виджета доступны дополнительные.

Размер текста

Регулирует размер текста в строках виджета.

Тип лимита

Доступны следующие типы:

  • Числовой
  • По переменной
  • По формуле

При использовании типа Числовой в параметре Лимит разреза настраивается количество отображаемых на гистограмме значений разреза.

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

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

Заметка

Если значение переменной или формулы больше 50, то на гистограмме отображаются только первые 50 значений.

Лимит разреза

Регулирует количество отображаемых на гистограмме значений разреза.

Подсказка

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

Тип

Параметр регулирует отображение значений разреза в виде столбиков или линий с точками.

Толщина линий

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

Сглаживание линий

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

Ориентация

Доступны следующие варианты ориентации:

  • Авто
  • Вертикальная
  • По левому краю
  • По правому краю

Ось X

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

Ось Y

Для оси Y можно включить отображение самой оси, заголовка и указать ширину меток. Название заголовка всегда Количество.

Настройка фильтрации

Для виджета доступны стандартные настройки фильтрации.

Фильтр, настроенный в виджете, невозможно удалить в режиме просмотра.

Режим просмотра

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

Режим просмотра

Чтобы выделить несколько значений на гистограмме, зажмите ЛКМ и проведите от первого необходимого столбика до последнего.

Применение

К одному или нескольким выделенным значениям можно добавить недостающие. Для этого направьте курсор к границе выделенной области. Иконка курсора изменится на значок с горизонтальными стрелками. Зажмите ЛКМ и проведите до необходимого столбика. Добавление работает, если в настройках фильтрации гистограммы выбран режим Базовый или Единичный выбор.

Выделенную область можно перемещать. Для этого зажмите ЛКМ на области и переместите ее влево или вправо. Столбики не меняют свое положение. Перемещение выделенной области работает, если в настройках фильтрации гистограммы выбран режим Базовый или Единичный выбор.

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

Фильтр "В диапазоне" в шапке

Граничное значение:

  • Слева входит в значение интервала, правое граничное значение в значение интервала не входит
  • В правую границу входит только для последнего интервала
  • У столбика — результат деления всего диапазона данных разреза на отдельные интервалы, поэтому значение из данных разреза может попадать или не попадать на границу диапазона
  • Если у столбика в интервале нет ни одного значения, он не отображается на графике
Заметка

При вычислении гистограммы значения null, NaN, -inf и inf не учитываются и не отображаются на ее графике.

Настройка виджета в YAML

Виджет можно редактировать не только в визуальном конструкторе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице. Общие параметры для виджетов описаны на странице Настройка виджетов в YAML.

Настройки данных в YAML

КлючТипОпределение
titlestringЗаголовок
showMarkdownbooleanОписание
markdownTextstringТекст описания
markdownMeasuresМеры в описании
dimensionsРазрезы

Разрезы в YAML (ключ dimensions)

КлючТипОпределение
namestringНазвание разреза
valueФормула показателя
dbDataTypeenumТип данных разреза
formatenumФормат
formattingenumФорматирование
formattingTemplatestringСобственное форматирование
Только для форматирования CUSTOM (Настроить)
hideEmptyValuesbooleanСкрыть пустые значения
hierarchyDimensionsРазрезы иерархии
Если добавлен этот параметр, то показатель определяется как иерархия
colorЦвет:
- AUTO — авто
- BASE — базовый
- FORMULA — по формуле
- RULE — по правилу
Если показатель иерархический, параметр не применяется
displayConditionОтображать (условие отображения)
arrayNestingbooleanВложенность массива
Иерархический разрез (ключ hierarchyDimensions)
КлючТипОпределение
namestringНазвание разреза
valueФормула разреза
dbDataTypeenumТип данных разрезза
formatenumФормат
formattingenumФорматирование
formattingTemplatestringСобственное форматирование
Только для форматирования CUSTOM (Настроить)
hideEmptyValuesbooleanСкрыть пустые значения
colorЦвет:
- AUTO — авто
- BASE — базовый
- FORMULA — по формуле
- RULE — по правилу
displayConditionОтображать (условие отображения)
arrayNestingbooleanВложенность массива

Настройки отображения в YAML

КлючТипОпределение
paddingsstringОтступы по сторонам
titleSizenumberРазмер заголовка
titleColorЦвет заголовка:
- AUTO — авто
- BASE — базовый
titleWeightenumТолщина шрифта:
- NORMAL — обычная
- BOLD — большая
markdownTextSizenumberТекст описания
В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание
textSizenumberРазмер текста
binsLimitnumberЛимит разреза
chartTypeenumТип:
- BAR — столбики
- LINE — линии
orientationenumОриентация:
- AUTO — авто
- HORIZONTAL — по горизонтали
- VERTICAL_LEFT — по левому краю
- VERTICAL_RIGHT — по правому краю
lineThicknessenumТолщина линий:
- THIN — малая
- THICK — большая
Только для типа LINE
lineSmoothingbooleanСглаживание линий
Только для типа LINE
xAxisНастройки оси X
yAxisНастройки оси Y

Лимит разреза (ключ binsLimit)

КлючТипОпределение
modeenumТип лимита:

- NUMBER — числовой
- VARIABLE — по переменной
- FORMULA — по формуле
limitValuenumberЗначение

Только для типа лимита NUMBER
variablestringПеременная

Только для типа лимита VARIABLE
formulastringФормула

Только для типа лимита FORMULA

Настройки оси X (ключ xAxis)

КлючТипОпределение
enabledbooleanОсь X вкл/выкл
rotationnumberПоворот меток
heightnumberВысота меток
showTitlebooleanЗаголовок оси X

Настройки оси Y (ключ yAxis)

КлючТипОпределение
enabledbooleanОсь Y вкл/выкл
widthnumberШирина меток
showTitlebooleanЗаголовок оси Y

Настройки фильтрации в YAML

КлючТипОпределение
filterModeenumРежим фильтрации:
- DEFAULT — базовый
- SINGLE — единичный выбор
- DISABLED — отключено
ignoreFiltersbooleanИгнорировать фильтры
filtersФильтры
stateNamestringСостояние

Пример настроенного виджета в YAML-редакторе

widgets:
  - key: histogram
    apiVersion: "15"
    type: HISTOGRAM
    settings:
      titleColor:
        mode: AUTO
      titleSize: 14
      paddings: 8
      titleWeight: NORMAL
      textSize: 12
      filterMode: DEFAULT
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      markdownTextSize: 14
      xAxis:
        enabled: true
        showTitle: true
      yAxis:
        enabled: true
        showTitle: true
      dimensions:
        - name: Формула
          value:
            mode: FORMULA
            formula: toDate("phases"."event_time")
          dbDataType: Date
          formatting: AUTO
          hideEmptyValues: false
          format: DATE
          displayCondition:
            mode: DISABLED
          color:
            mode: AUTO
      binsLimit:
        mode: NUMBER
        limitValue: 8
        variable: Тип лимита по переменной
        formula: count("phases"."event_time")
      showHint: false
      chartType: LINE
      orientation: AUTO
      lineSmoothing: true
      lineThickness: THICK

Была ли статья полезна?

Да
Нет
Предыдущая
Кольцевая диаграмма
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102025. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.