altair.selection_interval

altair.selection_interval(name=None, value=Undefined, bind=Undefined, empty=Undefined, expr=Undefined, encodings=Undefined, on=Undefined, clear=Undefined, resolve=Undefined, mark=Undefined, translate=Undefined, zoom=Undefined, **kwds)

Создаёт параметр интервального выбора.

Параметры выбора определяют запросы к данным, управляемые действиями пользователя, например щелчками и перетаскиванием. Интервальный выбор выделяет непрерывный диапазон значений перетаскиванием, а selection_point — несколько дискретных значений.

Параметры

name — str (необязательный)

Имя параметра. Если не задано, создаётся уникальное имя.

value — Any (необязательный)

Начальное значение параметра. Если не задано, параметр создаётся без начального значения.

bind — Binding, str (необязательный)

Связывает параметр с внешним элементом ввода: например, ползунком, списком или группой переключателей.

empty — bool (необязательный)

Предикат пустого выбора по умолчанию возвращает True. Для изменения задайте empty=False.

expr — Expr (необязательный)

Выражение для значения параметра. Может включать другие параметры; в этом случае значение автоматически обновляется при их изменении.

encodings — Sequence[str] (необязательный)

Список каналов кодирования. Значения соответствующих полей должны совпасть, чтобы запись данных входила в выбор.

on — str (необязательный)

Поток событий Vega, заданный объектом или селектором, который запускает выбор. Для интервального выбора поток должен задавать начальное и конечное события.

clear — str, bool (необязательный)

Очищает выбор от всех значений. Допустим поток событий или False для отключения очистки. По умолчанию — dblclick.

resolve — Literal['global', 'union', 'intersect'] (необязательный)

В многослойных и составных представлениях определяет объединение запросов выбора для фильтров, условного кодирования и области определения шкалы:

  • global — один выбор для всей матрицы диаграмм рассеяния (SPLOM). Новое перетаскивание очищает предыдущий выбор и создаёт новый.
  • union — каждая ячейка имеет собственный выбор; выделяются точки внутри любого из них.
  • intersect — каждая ячейка имеет собственный выбор; выделяются только точки внутри всех выборов.

По умолчанию: global.

mark — BrushConfig (необязательный)

Интервальный выбор добавляет прямоугольный примитив, показывающий его границы. Свойство mark настраивает оформление прямоугольника.

translate — str, bool (необязательный)

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

По умолчанию: True, соответствующее [pointerdown, window:pointerup] > window:pointermove!. Пользователь нажимает и перетаскивает внутри области выбора, чтобы переместить её.

zoom — str, bool (необязательный)

При истинном значении разрешает менять размер интервального выбора. Допустимы True, False для отключения масштабирования или поток событий Vega. Сейчас поддерживаются только события колеса мыши, но пользовательский поток позволяет задать фильтры, задержку debounce и ограничение частоты throttling. Набор событий планируется расширить.

По умолчанию: True, соответствующее wheel!; колесо мыши изменяет размер области выбора.

**kwds — Any

Дополнительные аргументы настройки выбора.

## Возвращает

parameter — объект Parameter, используемый при создании диаграмм.