altair.YDatum

altair.YDatum(datum, axis=Undefined, bandPosition=Undefined, impute=Undefined, scale=Undefined, stack=Undefined, title=Undefined, type=Undefined, **kwds)

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

Параметры

axis — dict, Axis, None

Объект свойств линий сетки, делений и подписей оси. При null ось канала удаляется.

По умолчанию: стандартные свойства оси, если значение не задано.

bandPosition — float

Относительное положение внутри полосы шкалы, интервала группировки, единицы времени или сегмента накопления. Значение 0 помещает примитив в начало полосы, 0.5 — в середину.

datum — str, bool, dict, float, ExprRef, DateTime, RepeatRef, PrimitiveValue, None

Постоянное значение в области данных.

impute — dict, ImputeParams, None

Объект свойств операции заполнения пропущенных значений Impute. Поле другого канала положения используется как key, а поле канала color, если задано, — как groupby.

См. Impute.

scale — dict, Scale, None

Объект свойств шкалы канала. Шкала преобразует значения области данных — числа, даты, строки — в визуальные значения: пиксели, цвета, размеры.

При null шкала отключается, и значение данных кодируется непосредственно.

По умолчанию: стандартные свойства шкалы, если значение не задано.

stack — bool, StackOffset, Literal['zero', 'center', 'normalize'], None

Тип смещения накопления, если поле нужно накапливать. stack применим только к каналам x, y, theta и radius с непрерывной входной областью. Например, stack канала y задаёт накопление вертикальной столбчатой диаграммы.

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

"zero" или true — накопление с базовой линией на нуле шкалы, для обычных столбчатых и областных диаграмм с накоплением.
"normalize" — накопление с нормализованной входной областью, для нормализованных столбчатых и областных диаграмм, а также круговых диаграмм с процентами в подсказке.
"center" — накопление относительно центральной базовой линии, для потоковой диаграммы.
null или false — без накопления; получаются многослойные столбчатые и областные диаграммы.

Значение по умолчанию: zero, если выполнены все условия: (1) тип метки — bar, area или arc; (2) канал накапливаемой меры (x или y) использует линейную шкалу; (3) хотя бы один непозиционный канал сопоставлен неагрегированному полю, отличному от x и y. Иначе null.

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

title — str, Text, Sequence[str], None

Заголовок поля. При null удаляется.

По умолчанию: формируется из имени поля и преобразования (aggregate, bin, timeUnit). Агрегирование включается в заголовок, например "Sum of Profit"; группировка по интервалам и единицы времени — в скобках: "Profit (binned)", "Transaction Date (year-month)". Без преобразования используется имя поля.

Примечания:

Формат заголовка можно настроить свойством fieldTitle конфигурации или функцией fieldTitle в параметрах компиляции.
Если заголовок задан и у поля, и у оси, заголовка панели или легенды, используется заголовок оси, панели или легенды.

type — Type, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']

Тип измерения поля или константы datum: "quantitative", "temporal", "ordinal", "nominal"; для Geoshape также "geojson".

Vega-Lite часто выводит тип автоматически. Явный тип нужен, если поле не номинальное и в кодировании не заданы aggregate (кроме argmin, argmax), bin, тип шкалы, собственный sort или timeUnit; также он нужен для порядковой шкалы поля с bin или timeUnit.

По умолчанию для поля: nominal, кроме следующих случаев:

quantitative: есть bin или агрегирование, кроме argmin/argmax; канал — latitude или longitude; либо указан количественный тип шкалы.
temporal: есть timeUnit либо шкала типа time или utc.
ordinal: есть собственный порядок sort, шкала ordinal/point/band либо канал order.

Для константы datum: число — quantitative, строка — nominal, объект даты и времени — temporal.

Примечания:

Тип описывает смысл данных, а не примитивный тип числа или строки. Числа могут означать количественные, порядковые или номинальные значения.
Временные значения могут быть строками даты/времени, например "2015-03-07 12:32:17", "17:01", "2015-03-16", "2015", или числовой временной меткой, например 1552199579097.
С bin используйте quantitative для линейной шкалы интервалов или ordinal для порядковой.
С timeUnit используйте temporal для временной шкалы (по умолчанию) или ordinal для порядковой.
С aggregate тип относится к результату: число различных категорий {"aggregate": "distinct", "field": "cat"} имеет тип quantitative.
Вторичные каналы x2, y2, xError, yError не имеют собственного type: тип совпадает с основным каналом x или y.

См. типы данных.

Конструктор

__init__(datum, axis=Undefined, bandPosition=Undefined, impute=Undefined, scale=Undefined, stack=Undefined, title=Undefined, type=Undefined, **kwds)

Методы

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