altair.PointSelectionConfig

altair.PointSelectionConfig(type=Undefined, clear=Undefined, encodings=Undefined, fields=Undefined, nearest=Undefined, on=Undefined, resolve=Undefined, toggle=Undefined, **kwds)

Обёртка схемы PointSelectionConfig.

Параметры

type — Literal['point']

Определяет обработку событий и запросы к данным по умолчанию для выделения. Vega-Lite поддерживает два типа выделений:

  • "point" — выделение нескольких дискретных значений данных. Первое значение выбирается щелчком; дополнительные значения добавляются или удаляются щелчком с Shift.
  • "interval" — выделение непрерывного диапазона значений перетаскиванием.
clear — str, bool, dict, Stream, EventStream, MergedStream, DerivedStream

Очищает выделение, удаляя все его значения. Может быть потоком событий или false для отключения очистки.

Значение по умолчанию: dblclick.

См. также: примеры clear.

encodings — Sequence[SingleDefUnitChannel, Literal['text', 'shape', 'x', 'y', 'xOffset', 'yOffset', 'x2', 'y2', 'longitude', 'latitude', 'longitude2', 'latitude2', 'theta', 'theta2', 'radius', 'radius2', 'time', 'color', 'fill', 'stroke', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeWidth', 'strokeDash', 'size', 'angle', 'key', 'href', 'url', 'description']]

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

См. также: проецирование через encodings и fields.

fields — Sequence[str, FieldName]

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

См. также: проецирование через encodings и fields.

nearest — bool

При значении true вычисляется невидимая диаграмма Вороного для ускорения дискретного выделения. В выделение добавляется значение данных, ближайшее к курсору мыши.

Значение по умолчанию: false; для добавления значений в выделение нужно взаимодействовать непосредственно с ними, например щёлкнуть по точке.

См. также: примеры nearest.

on — str, dict, Stream, EventStream, MergedStream, DerivedStream

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

См. также: примеры on.

resolve — SelectionResolution, Literal['global', 'union', 'intersect']

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

Допустимые значения:

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

Значение по умолчанию: global.

См. также: примеры resolve.

toggle — str, bool

Определяет, нужно ли переключать значения данных — добавлять в точечное выделение или удалять из него — либо только добавлять.

Допустимые значения:

  • true — поведение по умолчанию, соответствующее "event.shiftKey": значения переключаются при взаимодействии с нажатой клавишей Shift.
  • false — отключает переключение; выделение всегда содержит только одно значение данных, соответствующее последнему действию пользователя.
  • Выражение Vega, пересчитываемое при взаимодействии. Если результат true, значение добавляется в выделение или удаляется из него. Если false, выделение сначала очищается, затем значение добавляется. Например, выражение "true" позволяет переключать значения без нажатия Shift.

Значение по умолчанию: true.

См. также: примеры toggle.

Конструктор

__init__(type=Undefined, clear=Undefined, encodings=Undefined, fields=Undefined, nearest=Undefined, on=Undefined, resolve=Undefined, toggle=Undefined, **kwds)

Методы

Метод Описание
__init__
copy(deep, ignore) Возвращает копию объекта.
from_dict(dct, validate) Создаёт экземпляр класса из представления в виде словаря.
from_json(json_string, validate, **kwargs) Создаёт экземпляр объекта из корректной строки JSON.
resolve_references(schema) Разрешает ссылки в контексте схемы объекта или корневой схемы.
to_dict(validate, ignore, context) Возвращает представление объекта в виде словаря.
to_json(validate, indent, sort_keys, ignore, …) Возвращает представление объекта в строке JSON.
validate(instance, schema) Проверяет экземпляр по схеме класса в контексте корневой схемы.
validate_property(name, value, schema) Проверяет свойство по его схеме в контексте корневой схемы.