altair.FacetedUnitSpec

altair.FacetedUnitSpec(mark=Undefined, align=Undefined, bounds=Undefined, center=Undefined, data=Undefined, description=Undefined, encoding=Undefined, height=Undefined, name=Undefined, params=Undefined, projection=Undefined, resolve=Undefined, spacing=Undefined, title=Undefined, transform=Undefined, view=Undefined, width=Undefined, **kwds)

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

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

Параметры

mark — dict, Mark, AnyMark, BoxPlot, MarkDef, ErrorBar, ErrorBand, BoxPlotDef, ErrorBarDef, ErrorBandDef, CompositeMark, CompositeMarkDef, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape', 'boxplot', 'errorband', 'errorbar']

Строка с типом метки ("bar", "circle", "square", "tick", "line", "area", "point", "rule", "geoshape" или "text") либо объект определения метки.

align — dict, LayoutAlign, RowColLayoutAlign, Literal['all', 'each', 'none']

Выравнивание строк и столбцов сетки: "all", "each", "none".

  • none — последовательное размещение соседних представлений.
  • each — сетка с возможными различиями размеров строк и столбцов.
  • all — сетка с одинаковыми размерами строк и столбцов по максимальному размеру; строка задаёт оба направления.

Объект {"row": string, "column": string} позволяет задать разные правила для строк и столбцов.

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

bounds — Literal['full', 'flush']

Способ вычисления границ панели: full (по умолчанию) или flush.

  • full учитывает все границы, включая оси, заголовок и легенду.
  • flush учитывает только заданную ширину и высоту представления. Подходит для равномерной сетки панелей без осей и легенд.

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

center — bool, dict, RowColboolean

Центрировать ли представления относительно строк и столбцов. Объект {"row": boolean, "column": boolean} задаёт разные значения по направлениям.

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

data — dict, Data, UrlData, Generator, NamedData, DataSource, InlineData, SphereGenerator, SequenceGenerator, GraticuleGenerator, None

Объект, описывающий источник данных. Задайте null, чтобы игнорировать источник данных родительской спецификации. Если данные не заданы, они наследуются от родителя.

description — str

Описание метки, используемое как комментарий.

encoding — dict, FacetedEncoding

Словарь, сопоставляющий каналам кодирования определения полей.

height — dict, float, Step, Literal['container']

Высота визуализации.

  • Если поле y непрерывное, высота должна быть числом.
  • Если поле y дискретное или отсутствует, высоту можно задать числом для фиксированного размера либо объектом {step: number}, определяющим высоту одного дискретного шага. Отсутствие поля y эквивалентно одному дискретному шагу.
  • Для адаптивной высоты используйте "container".

Значение по умолчанию: определяется config.view.continuousHeight для непрерывного поля y и config.view.discreteHeight в остальных случаях.

Примечание: для диаграмм с каналами row и column задаёт высоту одного представления; значение "container" недоступно.

См. также: документация height.

name — str

Имя визуализации для последующих ссылок на неё.

params — Sequence[dict, SelectionParameter]

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

projection — dict, Projection

Объект со свойствами географической проекции. Применяется к контуру shape меток "geoshape" и к каналам latitude и longitude остальных меток.

resolve — dict, Resolve

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

spacing — dict, float, RowColnumber

Расстояние между представлениями композиции в пикселях. Объект {"row": number, "column": number} позволяет задать его отдельно для строк и столбцов.

По умолчанию: свойство spacing конфигурации композиции, обычно 20.

title — str, dict, Text, Sequence[str], TitleParams

Заголовок диаграммы.

transform — Sequence[dict, Transform, BinTransform, FoldTransform, LoessTransform, PivotTransform, StackTransform, ExtentTransform, FilterTransform, ImputeTransform, LookupTransform, SampleTransform, WindowTransform, DensityTransform, FlattenTransform, QuantileTransform, TimeUnitTransform, AggregateTransform, CalculateTransform, RegressionTransform, JoinAggregateTransform]

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

view — dict, ViewBackground

Объект, определяющий заливку и обводку фона представления.

Значение по умолчанию: отсутствует (прозрачный фон).

width — dict, float, Step, Literal['container']

Ширина визуализации.

  • Если поле x непрерывное, ширина должна быть числом.
  • Если поле x дискретное или отсутствует, ширину можно задать числом для фиксированного размера либо объектом {step: number}, определяющим ширину одного дискретного шага. Отсутствие поля x эквивалентно одному дискретному шагу.
  • Для адаптивной ширины используйте "container".

Значение по умолчанию: определяется config.view.continuousWidth для непрерывного поля x и config.view.discreteWidth в остальных случаях.

Примечание: для диаграмм с каналами row и column задаёт ширину одного представления; значение "container" недоступно.

См. также: документация width.

Конструктор

__init__(mark=Undefined, align=Undefined, bounds=Undefined, center=Undefined, data=Undefined, description=Undefined, encoding=Undefined, height=Undefined, name=Undefined, params=Undefined, projection=Undefined, resolve=Undefined, spacing=Undefined, title=Undefined, transform=Undefined, view=Undefined, width=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) Проверяет свойство по его схеме в контексте корневой схемы.