Разбиение на панели

Панельная диаграмма (trellis plot, или small multiples) — это серия похожих графиков, показывающих разные подмножества одного набора данных и облегчающих их сравнение.

В Vega-Lite есть два способа разбить представление на панели.

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

Второй — сокращённая запись через каналы кодирования facet, column или row.

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

• Оператор facet
  • Определение поля панели
  • Строки и столбцы панелей
  • Заголовки панелей
  • Примеры
    • Панели по строкам
    • Панели с переносом строк
• Каналы facet, row и column
  • Свойства определений полей
  • Примеры
    • Панели по строкам через канал row
    • Сетка через row и column
    • Панели с переносом через канал facet
• Общие и независимые шкалы
• Настройка панелей

Оператор facet

Свойство facet описывает разбиение данных, а spec — диаграмму внутри каждой панели:

{
  "facet": {
    ... // Определение панелей
  },
  "spec": ... // Внутреннее представление
}

Помимо общих свойств спецификации, здесь доступны:

Определение поля панели

Определение поля панели имеет следующие свойства:

Примечания

1. В отличие от определения позиционного поля, определение поля панели содержит header вместо scale и axis.
2. Каналы facet, row и column представляют реальные поля данных, используемые для их разбиения, поэтому они не могут кодировать постоянное value. Не следует разбивать данные на панели по количественным полям без разбиения на интервалы, а по временным — без timeUnit.

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

Если facet задаётся объектом, он может содержать поля row и column:

Заголовки панелей

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

Подробнее см. документацию заголовков.

Примеры

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

Панели по строкам

Следующая спецификация использует оператор facet, чтобы разделить гистограммы мощности автомобилей (Horsepower) по происхождению (Origin) и расположить их вертикально с помощью "row". Каждая диаграмма показывает гистограмму для одной группы: Европы, Японии или США.

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

Панели с переносом строк

Каналы facet, row и column

Каналы панелей (facet, row и column) — это каналы кодирования, служащие сокращённой записью спецификации панелей. Vega-Lite автоматически преобразует эту запись в спецификацию с оператором facet.

Свойства определений полей

Помимо field, type, bin и timeUnit, определения полей каналов row, column и facet могут содержать следующие свойства:

Кроме того, канал facet может содержать свойство columns:

Каналы row и column могут содержать следующие свойства:

Примеры

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

Панели по строкам через канал row

Vega-Lite преобразует эту запись в более гибкую спецификацию с оператором facet.

Сетка через row и column

Одновременное использование каналов "row" и "column" создаёт сетку небольших однотипных диаграмм.

Панели с переносом через канал facet

Эта сокращённая запись также преобразуется в спецификацию с оператором facet.

Общие и независимые шкалы

По умолчанию правила объединения панелей по строкам и столбцам предусматривают общие шкалы, оси и легенды.

Чтобы переопределить это поведение, задайте "independent" для соответствующего свойства resolve:

Настройка панелей

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

    "facet": { // Конфигурация панелей
      "spacing": ...,
      "columns": ...,
    },
    ...
  }
}

Конфигурация панелей поддерживает следующие свойства: