altair.selection_point

altair.selection_point(name=None, value=Undefined, bind=Undefined, empty=Undefined, expr=Undefined, encodings=Undefined, fields=Undefined, on=Undefined, clear=Undefined, resolve=Undefined, toggle=Undefined, nearest=Undefined, **kwds)

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

Параметры выбора определяют запросы к данным, управляемые действиями пользователя, например щелчками и перетаскиванием. Точечный выбор выделяет несколько дискретных значений: первое — щелчком, следующие добавляются или удаляются щелчком с Shift. Для непрерывного диапазона, выбираемого перетаскиванием, используйте selection_interval.

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Управляет добавлением и удалением значений из точечного выбора:

  • True (по умолчанию) соответствует event.shiftKey: значения добавляются или удаляются при взаимодействии с зажатой Shift.
  • False отключает переключение: выбор содержит только одно значение последнего взаимодействия.
  • Выражение Vega вычисляется при каждом взаимодействии. При True значение добавляется или удаляется; при False выбор сначала очищается, затем добавляется новое значение. Например, постоянное выражение True позволяет переключать значения без Shift.
nearest — bool (необязательный)

При true вычисляется невидимая диаграмма Вороного для ускорения дискретного выбора. Выбирается значение, ближайшее к указателю мыши. По умолчанию — False: для добавления нужно непосредственно взаимодействовать с точкой, например щёлкнуть по ней.

**kwds — Any

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

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

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