Столбец

// Спецификация одиночного представления
{
  "data": ... ,
  "mark": "bar",
  "encoding": ... ,
  ...
}

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

Содержание страницы

• Свойства столбца
• Примеры
  • Один столбец
  • Обычная столбчатая диаграмма
  • Временная ось
  • Относительная ширина столбца
  • Дискретная временная ось
  • Скруглённые углы
  • Отрицательные значения
  • Гистограмма
  • Столбцы с накоплением
  • Наложенные столбцы
  • Нормированные столбцы с накоплением
  • Группировка со смещением
  • Группировка с панелями
  • Несколько показателей через повторение
  • Столбцы между границами
• Настройка столбцов

Свойства столбца

// Спецификация одиночного представления
{
  ...,
  "mark": {
    "type": "bar",
    ...
  },
  "encoding": ... ,
  ...
}

Помимо общих свойств примитивов, столбцу доступны:

Примеры

Один столбец

Если количественное поле сопоставлено только с x или только с y, получится диаграмма из одного столбца:

Обычная столбчатая диаграмма

Дискретное поле на оси y создаёт отдельный горизонтальный столбец для каждого значения. Свойство "height": {"step": 17} регулирует высоту шага дискретной шкалы:

Временная ось

Обычно один канал столбца дискретный, а другой непрерывный. Возможны и два непрерывных канала. Здесь временное поле на оси x использует непрерывную шкалу, а ширина столбца определяется настройкой continuousBandSize:

Относительная ширина столбца

Ширину можно задать как долю доступного временного интервала. Здесь каждый столбец занимает 70 % своей полосы:

Дискретная временная ось

Чтобы получить дискретную шкалу, укажите для временного поля тип "ordinal". Этот приём удобен для единиц времени с небольшим числом значений, например месяцев:

Скруглённые углы

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

Отрицательные значения

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

Гистограмма

Если исходные данные содержат по одной записи на наблюдение, разбейте количественное поле на интервалы для x и сопоставьте агрегат count с y:

Для гистограммы без промежутков между столбцами задайте свойство binSpacing равным 0:

Столбцы с накоплением

Поле в канале color по умолчанию разделяет каждый столбец на цветные сегменты и укладывает их друг на друга. В этом примере дополнительно настроена цветовая шкала:

Наложенные столбцы

Чтобы отключить укладку, установите stack равным null. Получится диаграмма с наложенными столбцами. Сделайте их полупрозрачными, задав opacity от 0 до 1, например 0.7, чтобы наложение было заметно:

Нормированные столбцы с накоплением

Нормированную диаграмму с укладкой можно создать, задав stack равным "normalize". Здесь хорошо видны доли мужчин и женщин для разных возрастов:

Группировка со смещением

Смещения каналов позволяют разместить столбцы разных групп рядом:

Группировка с панелями

Другой вариант — разбить диаграмму на панели:

При этом каждой панели можно задать независимую шкалу x:

Несколько показателей через повторение

Оператор повторения создаёт отдельную столбчатую диаграмму для каждого показателя:

Столбцы между границами

Канал x2 или y2 задаёт вторую границу количественного измерения. Такой столбец охватывает интервал, что удобно для диаграммы Ганта:

Настройка столбцов

// Спецификация представления верхнего уровня
{
  ...,
  "config": {
    "bar": ...,
    ...
  }
}

Свойство bar объекта config верхнего уровня задаёт стандартные свойства всех столбцов. Каналы свойств примитива переопределяют эти значения.

Помимо стандартных свойств столбцов, конфигурация поддерживает дополнительные параметры: