altair.FacetedEncoding

altair.FacetedEncoding(angle=Undefined, color=Undefined, column=Undefined, description=Undefined, detail=Undefined, facet=Undefined, fill=Undefined, fillOpacity=Undefined, href=Undefined, key=Undefined, latitude=Undefined, latitude2=Undefined, longitude=Undefined, longitude2=Undefined, opacity=Undefined, order=Undefined, radius=Undefined, radius2=Undefined, row=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeDash=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, time=Undefined, tooltip=Undefined, url=Undefined, x=Undefined, x2=Undefined, xError=Undefined, xError2=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, yError=Undefined, yError2=Undefined, yOffset=Undefined, **kwds)

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

Параметры

angle — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Угол поворота точечных и текстовых меток.

color — dict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

Цвет меток — заливка или обводка в зависимости от свойства filled определения метки. По умолчанию color задаёт заливку для "area", "bar", "tick", "text", "trail", "circle" и "square", а для "line" и "point" — обводку.

Значение по умолчанию: если не задано, зависит от свойства color настроек меток.

Примечания:

  1. Чтобы отдельно управлять цветами заливки и обводки, используйте каналы fill и stroke. Они имеют приоритет над color и могут переопределить его при конфликте.
  2. Дополнительные сведения о настройке цветовой схемы приведены в документации шкал.
column — dict, RowColumnEncodingFieldDef

Определение поля для горизонтального разбиения диаграммы на фасеты.

description — dict, StringFieldDefWithCondition, StringValueDefWithCondition

Текстовое описание метки для доступности ARIA (только для вывода SVG). В SVG это описание записывается в атрибут "aria-label".

detail — dict, FieldDefWithoutScale, Sequence[dict, FieldDefWithoutScale]

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

facet — dict, FacetEncodingFieldDef

Определение поля для гибкого разбиения диаграммы на фасеты.

Если задан канал row или column, этот канал игнорируется.

fill — dict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

Цвет заливки меток. Значение по умолчанию: если не задано, зависит от свойства color настроек меток.

Примечание: кодирование fill имеет приоритет над color и может переопределить его при конфликте.

fillOpacity — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Непрозрачность заливки меток.

Значение по умолчанию: если не задано, зависит от свойства fillOpacity настроек меток.

href — dict, StringFieldDefWithCondition, StringValueDefWithCondition

URL, который открывается при щелчке мышью.

key — dict, FieldDefWithoutScale

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

latitude — dict, DatumDef, LatLongDef, LatLongFieldDef

Широта меток в географической проекции.

latitude2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Вторая координата широты для интервальных меток "area", "bar", "rect" и "rule" в географической проекции.

longitude — dict, DatumDef, LatLongDef, LatLongFieldDef

Долгота меток в географической проекции.

longitude2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Вторая координата долготы для интервальных меток "area", "bar", "rect" и "rule" в географической проекции.

opacity — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Непрозрачность меток.

Значение по умолчанию: если не задано, зависит от свойства opacity настроек меток.

order — dict, OrderOnlyDef, OrderFieldDef, OrderValueDef, Sequence[dict, OrderFieldDef]

Порядок меток.

Примечание: в агрегированных диаграммах поле order нужно агрегировать, чтобы не создавать дополнительные группы агрегирования.

radius — dict, PolarDef, PositionValueDef, PositionDatumDefBase, PositionFieldDefBase

Внешний радиус дуговых меток в пикселях.

radius2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Внутренний радиус дуговых меток в пикселях.

row — dict, RowColumnEncodingFieldDef

Определение поля для вертикального разбиения диаграммы на фасеты.

shape — dict, ShapeDef, FieldOrDatumDefWithConditionDatumDefstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull, ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull

Форма метки.

  1. Для меток point поддерживаются:
    • формы "circle", "square", "cross", "diamond", "triangle-up", "triangle-down", "triangle-right" и "triangle-left";
    • линейный символ "stroke";
    • центрированные направленные формы "arrow", "wedge" и "triangle";
    • пользовательская строка контура SVG. Для правильного масштабирования контур должен вписываться в квадрат с координатами от -1 до 1 по обеим осям.
  2. Для меток geoshape должно быть определением поля с данными GeoJSON.

Значение по умолчанию: если не задано, зависит от свойства shape настроек точечных меток; если и оно не задано, используется "circle".

size — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Размер метки.

  • Для "point", "square" и "circle" — размер символа, то есть площадь метки в пикселях.
  • Для "bar" и "tick" — размер столбца или штриха.
  • Для "text" — размер шрифта текста.
  • Для "line", "area" и "rect" не поддерживается. Для линии переменного размера используйте "trail".
stroke — dict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

Цвет обводки меток. Значение по умолчанию: если не задано, зависит от свойства color настроек меток.

Примечание: кодирование stroke имеет приоритет над color и может переопределить его при конфликте.

strokeDash — dict, NumericArrayMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumberArray, FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray, ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray

Штриховой узор обводки меток.

Значение по умолчанию: [1,0] (сплошная линия).

strokeOpacity — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Непрозрачность обводки меток.

Значение по умолчанию: если не задано, зависит от свойства strokeOpacity настроек меток.

strokeWidth — dict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

Толщина обводки меток.

Значение по умолчанию: если не задано, зависит от свойства strokeWidth настроек меток.

text — dict, TextDef, ValueDefWithConditionStringFieldDefText, FieldOrDatumDefWithConditionStringDatumDefText, FieldOrDatumDefWithConditionStringFieldDefText

Текст метки text.

theta — dict, PolarDef, PositionValueDef, PositionDatumDefBase, PositionFieldDefBase

Для arc — угловая длина дуги в радианах, если theta2 не задан, иначе начальный угол. Ноль направлен вверх, или на север; положительные значения идут по часовой стрелке. Для text — угол в полярных координатах, в радианах.

theta2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Конечный угол дуги в радианах. Ноль направлен вверх, или на север; положительные значения идут по часовой стрелке.

time — dict, TimeDef
tooltip — dict, StringFieldDefWithCondition, StringValueDefWithCondition, Sequence[dict, StringFieldDef], None

Текст всплывающей подсказки при наведении мыши. Кодирование tooltip переопределяет свойство tooltip определения метки.

Подробное описание всплывающих подсказок в Vega-Lite см. в документации tooltip.

url — dict, StringFieldDefWithCondition, StringValueDefWithCondition

URL метки изображения.

x — dict, PositionDef, PositionDatumDef, PositionFieldDef, PositionValueDef

Координата x примитива или ширина горизонтальных bar и area, если не заданы x2 или width. Значение может быть числом или строкой "width", обозначающей ширину диаграммы.

x2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Вторая координата x для area, bar, rect и rule с диапазоном. Значение может быть числом или строкой "width", обозначающей ширину диаграммы.

xError — dict, ValueDefnumber, SecondaryFieldDef

Погрешность координат x для меток "errorbar" и "errorband", заданных через значения погрешностей.

xError2 — dict, ValueDefnumber, SecondaryFieldDef

Вторичная погрешность координат x для меток "errorbar" и "errorband", заданных через значения погрешностей.

xOffset — dict, OffsetDef, ScaleDatumDef, ScaleFieldDef, ValueDefnumber

Смещение положения меток по оси x.

y — dict, PositionDef, PositionDatumDef, PositionFieldDef, PositionValueDef

Координата y примитива или высота вертикальных bar и area, если не заданы y2 или height. Значение может быть числом или строкой "height", обозначающей высоту диаграммы.

y2 — dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

Вторая координата y для area, bar, rect и rule с диапазоном. Значение может быть числом или строкой "height", обозначающей высоту диаграммы.

yError — dict, ValueDefnumber, SecondaryFieldDef

Погрешность координат y для меток "errorbar" и "errorband", заданных через значения погрешностей.

yError2 — dict, ValueDefnumber, SecondaryFieldDef

Вторичная погрешность координат y для меток "errorbar" и "errorband", заданных через значения погрешностей.

yOffset — dict, OffsetDef, ScaleDatumDef, ScaleFieldDef, ValueDefnumber

Смещение положения меток по оси y.

Конструктор

__init__(angle=Undefined, color=Undefined, column=Undefined, description=Undefined, detail=Undefined, facet=Undefined, fill=Undefined, fillOpacity=Undefined, href=Undefined, key=Undefined, latitude=Undefined, latitude2=Undefined, longitude=Undefined, longitude2=Undefined, opacity=Undefined, order=Undefined, radius=Undefined, radius2=Undefined, row=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeDash=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, time=Undefined, tooltip=Undefined, url=Undefined, x=Undefined, x2=Undefined, xError=Undefined, xError2=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, yError=Undefined, yError2=Undefined, yOffset=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) Проверяет свойство по его схеме в контексте корневой схемы.