Полоса неопределённости

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

Примитив errorband показывает диапазон неопределённости количественных значений заполненной областью. Vega-Lite может рассчитать границы по исходным данным или использовать уже агрегированные значения. Для его создания задайте mark: "errorband".

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

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

Определение примитива полосы неопределённости может содержать следующие свойства:

Свойство Тип Описание
type ErrorBand Тип примитива: базовый ("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.
interpolate Interpolate Метод интерполяции для полосы неопределённости:
• "linear" — последовательность прямых отрезков, как у ломаной.
• "linear-closed" — замыкает прямые отрезки в многоугольник.
• "step" — кусочно-постоянная функция с чередованием горизонтальных и вертикальных отрезков; Y меняется в середине между каждой парой соседних значений X.
• "step-before" — кусочно-постоянная функция с чередованием горизонтальных и вертикальных отрезков; Y меняется перед X.
• "step-after" — кусочно-постоянная функция с чередованием горизонтальных и вертикальных отрезков; Y меняется после X.
• "basis" — B-сплайн с дублированием контрольных точек на концах.
• "basis-open" — открытый B-сплайн; может не проходить через начальную и конечную точки.
• "basis-closed" — замкнутый B-сплайн, образующий петлю.
• "cardinal" — кардинальный сплайн с дублированием контрольных точек на концах.
• "cardinal-open" — открытый кардинальный сплайн; может не проходить через начальную и конечную точки, но проходит через остальные контрольные точки.
• "cardinal-closed" — замкнутый кардинальный сплайн, образующий петлю.
• "bundle" — аналог basis, но параметр натяжения используется для выпрямления сплайна.
• "monotone" — кубическая интерполяция, сохраняющая монотонность по Y.
tension number Параметр натяжения для выбранного типа интерполяции полосы неопределённости, от 0 до 1.

band и borders задают свойства базовых примитивов, из которых состоит полоса.

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

Полоса и отрезок погрешности применяются одинаково. Вместо основного отрезка rule и концевых штрихов ticks у полосы используются заливка band и границы borders.

Полоса неопределённости

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

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

Если данные ещё не агрегированы, границы вычисляются по свойству extent, как в примере доверительного интервала. Возможные значения extent описаны также на странице «Отрезок погрешности»: "stderr", "stdev", "ci" и "iqr".

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

  1. Данные агрегированы с нижней и верхней границами полосы.

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

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

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

Измерения

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

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

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

errorband — составной примитив, разворачиваемый в слои. Например, двумерная полоса эквивалентна следующей спецификации:

Части полосы можно настроить в объекте mark или через конфигурацию. Свойство borders: true добавляет граничные линии; объект свойств позволяет менять их strokeDash, opacity и другие параметры:

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

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

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

Пользовательская подсказка переопределяет стандартную:

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

{
  "errorband": {
    "extent": ...,
    "band": ...,
    "borders": ...
  }
}

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