Линия правила

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

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

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

• Свойства линии правила
• Примеры
  • Линии во всю ширину или высоту
  • Линии между границами
• Настройка линий правила

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

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

Для rule используются общие свойства примитивов.

Примеры

Линии во всю ширину или высоту

Если у rule задан только канал y, горизонтальные линии занимают всю ширину представления. Аналогично, если задан только x, вертикальные линии занимают всю высоту.

Как и tick, отрезки позволяют показывать средние цены разных акций:

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

Здесь линия указывает общее среднее на гистограмме:

Линии между границами

Пары каналов x и x2 либо y и y2 задают границы горизонтальных и вертикальных отрезков. Например, y и y2 могут показывать "min" и "max" мощности автомобилей разного происхождения:

Так же строят отрезки неопределённости. В следующем примере агрегаты ci0 и ci1 задают 95-процентный доверительный интервал для средней урожайности сортов ячменя:

Другой вариант показывает по одному стандартному отклонению (stdev) выше и ниже среднего:

Настройка линий правила

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

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

Конфигурация может содержать любые свойства отрезков, кроме type, style и clip.