altair.theme.AreaConfigKwds

class altair.theme.AreaConfigKwds

Обёртка TypedDict для altair.AreaConfig.

Параметры

align

Горизонтальное выравнивание текста или примитивов с диапазоном: area, bar, image, rect, rule. Значения: "left", "right", "center". Для примитивов с диапазоном ссылки на выражения не поддерживаются.

angle

Угол поворота текста в градусах.

aria

Добавлять ли атрибуты ARIA для доступности; только для SVG. При false выходной SVG-элемент получает aria-hidden, и примитив исключается из дерева доступности ARIA.

ariaRole

Тип элемента пользовательского интерфейса для доступности ARIA (только SVG). Если задан, определяет атрибут role. Внимание: экспериментальное свойство, которое может измениться.

ariaRoleDescription

Понятное человеку описание роли примитива, локализованное автором, для доступности ARIA (только SVG). Если задано, определяет атрибут aria-roledescription. Внимание: экспериментальное свойство, которое может измениться.

aspect

Сохранять ли соотношение сторон изображения.

baseline

Для текста — вертикальная базовая линия: "alphabetic", используемая по умолчанию, "top", "middle", "bottom", "line-top", "line-bottom" либо ссылка на выражение, возвращающее допустимое значение. line-top и line-bottom похожи на top и bottom, но вычисляются относительно lineHeight, а не только fontSize. Для примитивов с диапазоном — вертикальное выравнивание "top", "middle" или "bottom"; ссылки на выражения для них не поддерживаются.

blend

Режим смешивания цвета примитива с текущим фоном. Допускается любое значение CSS mix-blend-mode. По умолчанию: "source-over".

color

Стандартный цвет. По умолчанию: ■ "#4682b4". Нельзя задавать в конфигурации стилей. Свойства fill и stroke имеют больший приоритет и переопределяют color.

cornerRadius

Радиус скругления углов прямоугольников или дуг в пикселях. По умолчанию: 0.

cornerRadiusBottomLeft

Радиус скругления нижнего левого угла прямоугольника в пикселях. По умолчанию: 0.

cornerRadiusBottomRight

Радиус скругления нижнего правого угла прямоугольника в пикселях. По умолчанию: 0.

cornerRadiusTopLeft

Радиус скругления верхнего левого угла прямоугольника в пикселях. По умолчанию: 0.

cornerRadiusTopRight

Радиус скругления верхнего правого угла прямоугольника в пикселях. По умолчанию: 0.

cursor

Указатель мыши при наведении на примитив. Допускается любой тип указателя CSS.

description

Текстовое описание примитива для доступности ARIA; только для SVG. Если задано, определяет атрибут aria-label.

dir

Направление текста: "ltr" — слева направо, "rtl" — справа налево. Определяет, с какой стороны текст обрезается по параметру limit. По умолчанию: "ltr".

dx

Горизонтальное смещение подписи относительно точки привязки, в пикселях. Применяется после поворота свойством angle.

dy

Вертикальное смещение подписи относительно точки привязки, в пикселях. Применяется после поворота свойством angle.

ellipsis

Строка многоточия для текста, обрезанного по limit. По умолчанию: "…".

endAngle

Конечный угол примитива Arc в радианах. Значение 0 соответствует направлению вверх, на север; угол увеличивается по часовой стрелке.

fill

Стандартный цвет заливки; имеет больший приоритет, чем config.color. Значение null убирает заливку. По умолчанию: отсутствует.

fillOpacity

Непрозрачность заливки в диапазоне [0,1]. По умолчанию: 1.

filled

Использовать ли цвет примитива для заливки вместо обводки. По умолчанию: false для point, line, rule и geoshape с источником graticule; для остальных — true. Нельзя задавать в конфигурации стилей.

font

Гарнитура текста, например "Helvetica Neue".

fontSize

Размер шрифта в пикселях. По умолчанию: 11.

fontStyle

Начертание шрифта, например "italic".

fontWeight

Насыщенность шрифта: строка, например "bold" или "normal", либо число 100, 200, 300, …, 900. normal соответствует 400, bold — 700.

height

Высота примитивов.

href

URL для перехода при щелчке мышью. При заданном значении примитив действует как гиперссылка.

innerRadius

Внутренний радиус дуги в пикселях; псевдоним radius2. По умолчанию: 0.

interpolate

Способ интерполяции линий и областей:

  • "linear" — последовательность прямых отрезков.
  • "linear-closed" — замкнутые отрезки, образующие многоугольник.
  • "step" — чередующиеся горизонтальные и вертикальные отрезки.
  • "step-before" — чередующиеся вертикальные и горизонтальные отрезки.
  • "step-after" — чередующиеся горизонтальные и вертикальные отрезки.
  • "basis" — B-сплайн с дублированием крайних контрольных точек.
  • "basis-open" — открытый B-сплайн, который может не проходить через начало или конец.
  • "basis-closed" — замкнутый B-сплайн.
  • "cardinal" — кардинальный сплайн с дублированием крайних контрольных точек.
  • "cardinal-open" — открытый кардинальный сплайн: может не проходить через начало и конец, но проходит через остальные контрольные точки.
  • "cardinal-closed" — замкнутый кардинальный сплайн.
  • "bundle" — аналог basis, но tension используется для выпрямления сплайна.
  • "monotone" — кубическая интерполяция, сохраняющая монотонность по y.
invalid

Режим обработки некорректных данных: null и NaN на непрерывных шкалах без заданного результата для таких значений.

  • "filter" исключает некорректные значения из примитивов и шкал. Линии, области и trail соединяют допустимые точки, словно некорректных строк нет.
  • "break-paths-filter-domains" разрывает пути в некорректных точках. Для примитивов без пути эквивалентен "filter". Все диапазоны шкал исключают отфильтрованные точки.
  • "break-paths-show-domains" разрывает пути и скрывает некорректные точки остальных примитивов. Диапазоны всех шкал включают эти точки.
  • "show" или null показывает все точки в примитивах и диапазонах шкал. Шкала использует результат из config.scale.invalid; если он не задан, некорректные значения отображаются как ноль, когда он входит в шкалу, или как минимум шкалы, когда ноль не входит.
  • "break-paths-show-path-domains", используемый по умолчанию, эквивалентен "break-paths-show-domains" для line/area/trail и "filter" для остальных примитивов.

Если для шкалы канала задан результат некорректных значений в config.scale.invalid, все её значения считаются допустимыми. Поля такого канала не фильтруются и не вызывают разрывов пути.

limit

Максимальная длина текстового примитива в пикселях. Текст автоматически обрезается, если его отображаемый размер превышает предел. По умолчанию: 0, без ограничения.

line

Флаг добавления линии поверх area либо объект свойств наложенной линии. При {} или true используются стандартные свойства; при false линия автоматически не добавляется. По умолчанию: false.

lineBreak

Разделитель для разбиения текста на строки, например символ новой строки. Игнорируется, если текст задан массивом.

lineHeight

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

opacity

Общая непрозрачность в диапазоне [0,1]. По умолчанию: 0.7 для неагрегированных диаграмм с point, tick, circle, square или столбчатых диаграмм со слоями; иначе 1.

order

Для line и trail значение null или false сохраняет исходный порядок данных при построении линии.

orient

Ориентация диаграмм bar без накопления, tick, area и line: horizontal, используемая по умолчанию, либо vertical. Для bar, rule и tick определяет, к x или y применяется размер. Для area задаёт orient результата Vega. Для line и trail определяет порядок сортировки точек, если config.sortLineBy не задан. При накоплении ориентация определяется самим накоплением, и явно заданное значение игнорируется.

outerRadius

Внешний радиус дуги в пикселях; псевдоним radius. По умолчанию: 0.

padAngle

Угловой отступ по сторонам дуги, в радианах.

point

Флаг добавления точек поверх line или area либо объект свойств этих точек. При "transparent" добавляются прозрачные точки для улучшения подсказок и выбора; при {} или true — заполненные точки со стандартными свойствами; при false точки автоматически не добавляются. По умолчанию: false.

radius

Для arc — основной внешний радиус в пикселях. Для text — радиальное смещение текста в полярных координатах от начала, заданного x и y. По умолчанию: min(plot_width, plot_height)/2.

radius2

Второй, внутренний радиус дуги в пикселях. По умолчанию: 0.

shape

Форма точек. Поддерживаются "circle", "square", "cross", "diamond", "triangle-up", "triangle-down", "triangle-right", "triangle-left"; символ линии "stroke"; направленные формы "arrow", "wedge", "triangle"; пользовательская строка пути SVG. Для правильного размера путь должен находиться в квадрате с координатами от -1 до 1 по обеим осям. По умолчанию: "circle".

size

Стандартный размер примитива. Для point/circle/square — площадь в пикселях; длины сторон растут пропорционально квадратному корню из этого значения. Для bar — размер полосы в пикселях, для text — размер шрифта. По умолчанию: 30 для point/circle/square; step ширины/высоты; 2 для bar с дискретным измерением; 5 для bar с непрерывным измерением; 11 для text.

smooth

Сглаживать ли изображение при изменении размера; по умолчанию true. При false отдельные пиксели масштабируются непосредственно, без сглаживающей интерполяции. Для SVG настройка может не работать в некоторых браузерах из-за отсутствия стандартизации.

startAngle

Начальный угол примитива Arc в радианах. Значение 0 соответствует направлению вверх, на север; угол увеличивается по часовой стрелке.

stroke

Стандартный цвет обводки; имеет больший приоритет, чем config.color. Значение null убирает обводку. По умолчанию: отсутствует.

strokeCap

Форма концов линии: "butt", "round" или "square". По умолчанию: "butt".

strokeDash

Массив чередующихся длин штриха и промежутка для пунктирных и штриховых линий.

strokeDashOffset

Смещение в пикселях, с которого начинается рисунок штриховой линии.

strokeJoin

Способ соединения сегментов обводки: "miter", "round" или "bevel". По умолчанию: "miter".

strokeMiterLimit

Предел острого соединения, при превышении которого оно срезается.

strokeOffset

Смещение в пикселях для отрисовки обводки и заливки группы. Если не задано, группы с обводкой динамически смещаются так, чтобы обводка шириной 1 пиксель совпадала с пиксельной сеткой.

strokeOpacity

Непрозрачность обводки в диапазоне [0,1]. По умолчанию: 1.

strokeWidth

Толщина обводки в пикселях.

tension

Параметр натяжения для line и area, в зависимости от типа интерполяции.

text

Текст-заполнитель, если канал text не указан.

theta

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

theta2

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

time
timeUnitBandPosition

Стандартное относительное положение полосы временной единицы. При 0 примитивы располагаются в начале шага временной полосы, при 0.5 — в середине.

timeUnitBandSize

Стандартный относительный размер полосы временной единицы. При 1 ширина примитивов равна шагу временной полосы, при 0.5 — половине шага.

tooltip

Строка подсказки при наведении или объект, определяющий её поля. При true или {"content": "encoding"} используются все поля encoding; при {"content": "data"} — все поля наведённой точки данных. При null или false подсказка отсутствует. Подробнее см. подсказки Vega-Lite. По умолчанию: null.

url

URL файла изображения для примитива image.

width

Ширина примитивов.

x

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

x2

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

y

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

y2

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

Конструктор

__init__(*args, **kwargs)

Методы

Метод Описание
__init__
clear() Удалить все элементы словаря.
copy() Вернуть поверхностную копию словаря.
fromkeys(type, iterable, value) Создать словарь с ключами из итерируемого объекта и значениями, равными value.
get(key, default) Вернуть значение ключа, если он есть в словаре; иначе default.
items() Вернуть представление элементов словаря с операциями, подобными операциям над множествами.
keys() Вернуть представление ключей словаря с операциями, подобными операциям над множествами.
pop Удалить указанный ключ и вернуть соответствующее значение: D.pop(k[,d]) → v.
popitem() Удалить и вернуть пару (ключ, значение) в виде кортежа из двух элементов.
setdefault(key, default) Добавить ключ со значением default, если ключ отсутствует в словаре.
update Обновить словарь D из отображения или итерируемого объекта E и именованных аргументов F: D.update([E, ]**F) → None.
values() Вернуть представление значений словаря.

Атрибуты

Атрибут
align
angle
aria
ariaRole
ariaRoleDescription
aspect
baseline
blend
color
cornerRadius
cornerRadiusBottomLeft
cornerRadiusBottomRight
cornerRadiusTopLeft
cornerRadiusTopRight
cursor
description
dir
dx
dy
ellipsis
endAngle
fill
fillOpacity
filled
font
fontSize
fontStyle
fontWeight
height
href
innerRadius
interpolate
invalid
limit
line
lineBreak
lineHeight
opacity
order
orient
outerRadius
padAngle
point
radius
radius2
shape
size
smooth
startAngle
stroke
strokeCap
strokeDash
strokeDashOffset
strokeJoin
strokeMiterLimit
strokeOffset
strokeOpacity
strokeWidth
tension
text
theta
theta2
time
timeUnitBandPosition
timeUnitBandSize
tooltip
url
width
x
x2
y
y2