Отрезок погрешности

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

Примитив errorbar показывает диапазон неопределённости количественного значения в виде отрезка, при необходимости с концевыми штрихами. Vega-Lite может вычислить границы по исходным данным или отобразить уже агрегированные значения.

Для построения задайте mark: "errorbar".

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

Свойства отрезка погрешности

Определение примитива отрезка погрешности содержит следующие свойства:

Свойство Тип Описание
type ErrorBar Тип примитива: базовый ("bar", "circle", "square", "tick", "line", "area", "point", "geoshape", "rule", "text") или составной ("boxplot", "errorband", "errorbar").
extent ErrorBarExtent Границы отрезка. Допустимы:
• "ci" — 95-процентный доверительный интервал среднего, рассчитанный методом бутстрепа.
• "stderr" — от среднего в обе стороны откладывается стандартная ошибка.
• "stdev" — от среднего в обе стороны откладывается стандартное отклонение.
• "iqr" — от первого до третьего квартиля (q1, q3).

По умолчанию: "stderr".
orient Orientation Ориентация отрезка погрешности. Обычно определяется автоматически; если ориентация неоднозначна и не может быть определена автоматически, задайте её явно.
color Color, Gradient, ExprRef Цвет по умолчанию.

По умолчанию: ■ "#4c78a8".

Примечания: это свойство нельзя задавать в конфигурации стилей. Свойства fill и stroke имеют более высокий приоритет и переопределяют color.
opacity number Непрозрачность примитива, от 0 до 1.

Свойства rule и ticks настраивают базовые примитивы, из которых составлен отрезок погрешности.

Расчёт границ по исходным данным

Если значения ещё не агрегированы, Vega-Lite вычисляет диапазон согласно свойству extent.

  1. Стандартная ошибка — значение по умолчанию ("stderr"). Отрезок начинается и заканчивается на расстоянии стандартной ошибки от среднего.
  1. Стандартное отклонение ("stdev") — от среднего откладывается по одному стандартному отклонению в обе стороны.
  1. Доверительный интервал ("ci") — границы задаются агрегатами ci0 и ci1.
  1. Межквартильный размах ("iqr") — отрезок идёт от первого квартиля до третьего.

Уже агрегированные данные

  1. Данные агрегированы с нижней и верхней границами отрезка.

Если у каждой записи есть нижняя и верхняя границы, задайте x и x2 либо y и y2:

  1. Данные агрегированы с центральным значением и величинами ошибок.

Если данные содержат центральное значение и величины ошибок, используйте x вместе с xError и xError2 или их аналоги для y. При отсутствии xError2 или yError2 диапазон симметричен.

Симметричные значения погрешности:

Несимметричные значения погрешности:

Для несимметричного случая одна из величин xError и xError2 (либо yError и yError2) должна быть положительной, а другая — отрицательной.

Измерения и ориентация

Одномерный отрезок показывает диапазон одного непрерывного поля:

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

Двумерная диаграмма показывает диапазон непрерывного поля для каждой категории. При непрерывном поле на оси x отрезки горизонтальны:

При непрерывном поле на оси y — вертикальны:

Из каких частей состоит примитив

errorbar — составной примитив, который Vega-Lite разворачивает в несколько слоёв. Например, первый одномерный пример эквивалентен следующей спецификации:

Части можно настроить в определении примитива или в конфигурации. Например, ticks: true добавляет концевые штрихи, а объект свойств ticks позволяет настроить их вид — здесь color задан равным "teal":

Цвет и прозрачность

Каналы кодирования color и opacity применяются ко всему составному примитиву. В примере канал color задан как {"value": "#4682b4"}:

Всплывающие подсказки

Настраиваемая подсказка переопределяет стандартную подсказку отрезка погрешности:

Настройка по умолчанию

{
  "errorbar": {
    "extent": ...,
    "rule": ...,
    "ticks": ...
  }
}

config.errorbar задаёт свойства отрезков погрешности по умолчанию. В этой конфигурации сейчас не поддерживаются color, opacity и orient.