altair.expr

altair.expr(expr)

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

Выражения позволяют создавать простые формулы для пользовательского интерактивного поведения. Можно также задать встроенное выражение через expr().

Параметры

expr: str — строка выражения Vega.

Возвращаемое значение

ExprRef

Примеры

>>> import altair as alt

>>> bind_range = alt.binding_range(min=100, max=300, name="Slider value:  ")
>>> param_width = alt.param(bind=bind_range, name="param_width")
>>> param_color = alt.param(
...     expr=alt.expr.if_(param_width < 200, "red", "black"),
...     name="param_color",
... )
>>> y = alt.Y("yval").axis(titleColor=param_color)

>>> y
Y({
  axis: {'titleColor': Parameter('param_color', VariableParameter({
    expr: if((param_width < 200),'red','black'),
    name: 'param_color'
  }))},
  shorthand: 'yval'
})

Конструктор

__init__(expr)

Методы

Метод Описание
__init__
abs(value) Возвращает абсолютное значение value.
acos(value) Тригонометрический арккосинус.
asin(value) Тригонометрический арксинус.
atan(value) Тригонометрический арктангенс.
atan2(dy, dx) Возвращает арктангенс dy / dx.
atob(string) Декодирует строку ASCII, закодированную в Base64.
bandspace(count, paddingInner, paddingOuter) Возвращает число шагов полосовой шкалы по числу элементов входной области count и значениям внутренних и внешних отступов.
bandwidth(name, group) Возвращает текущую ширину полосы именованной полосовой шкалы; если шкала не найдена или не полосовая, возвращает ноль.
btoa(string) Создаёт строку ASCII, закодированную в Base64.
ceil(value) Округляет value до ближайшего целого, не меньшего исходного значения.
clamp(value, min, max) Ограничивает value заданными границами min и max.
clampRange(range, min, max) Ограничивает массив range из двух элементов, сохраняя ширину диапазона.
containerSize() Возвращает текущий размер CSS-блока родительского элемента DOM, содержащего представление Vega: [el.clientWidth, el.clientHeight].
contrast(specifier1, specifier2) Возвращает коэффициент контрастности заданных цветов как число от 1 до 21.
copy(name, group) Возвращает копию именованной шкалы или проекции; если они не найдены, возвращает undefined.
cos(value) Тригонометрический косинус.
cumulativeLogNormal(value, mean, stdev) Возвращает значение функции распределения в точке value для логнормального распределения с заданным логарифмическим средним mean и логарифмическим стандартным отклонением stdev.
cumulativeNormal(value, mean, stdev) Возвращает значение функции распределения в точке value для нормального распределения с заданным средним mean и стандартным отклонением stdev.
cumulativeUniform(value, min, max) Возвращает значение функции распределения в точке value для равномерного распределения с заданным интервалом [min, max).
data(name) Возвращает массив объектов данных набора Vega с именем name.
date(datetime) Возвращает день месяца для datetime по местному времени.
datetime(year, month, day, hour, …) Возвращает новый экземпляр Date.
day(datetime) Возвращает день недели для datetime по местному времени.
dayAbbrevFormat(day) Форматирует номер дня недели (0–6) как сокращённое название согласно текущей локали.
dayFormat(day) Форматирует номер дня недели (0–6) как полное название согласно текущей локали.
dayofyear(datetime) Возвращает день года, отсчитываемый от единицы для datetime по местному времени.
debug(value1, value2, *args) Записывает отладочное сообщение и возвращает последний аргумент.
densityLogNormal(value, mean, stdev) Возвращает значение плотности вероятности в точке value для логнормального распределения с заданным логарифмическим средним mean и логарифмическим стандартным отклонением stdev.
densityNormal(value, mean, stdev) Возвращает значение плотности вероятности в точке value для нормального распределения с заданным средним mean и стандартным отклонением stdev.
densityUniform(value, min, max) Возвращает значение плотности вероятности в точке value для равномерного распределения с заданным интервалом [min, max).
domain(name, group) Возвращает массив входной области именованной шкалы; если она не найдена, возвращает пустой массив.
exp(exponent) Возвращает число e в степени exponent.
extent(array) Возвращает новый массив [min, max] с минимумом и максимумом входного массива, игнорируя null, undefined и NaN.
floor(value) Округляет value до ближайшего целого, не большего исходного значения.
format(value, specifier) Форматирует числовое value как строку.
from_dict(dct, validate) Создаёт экземпляр класса из представления в виде словаря.
from_json(json_string, validate, **kwargs) Создаёт экземпляр объекта из корректной строки JSON.
geoArea(projection, feature, group) Возвращает площадь проекции элемента GeoJSON feature на плоскости, обычно в квадратных пикселях, согласно именованной проекции projection.
geoBounds(projection, feature, group) Возвращает ограничивающий прямоугольник проекции элемента GeoJSON feature на плоскости, обычно в пикселях, согласно именованной проекции projection.
geoCentroid(projection, feature, group) Возвращает центроид проекции элемента GeoJSON feature на плоскости, обычно в пикселях, согласно именованной проекции projection.
geoScale(projection, group) Возвращает значение масштаба именованной проекции projection.
gradient(scale, p0, p1, count) Возвращает линейный цветовой градиент шкалы scale, диапазон которой должен быть непрерывной цветовой схемой, между точками p0 и p1, заданными массивами [x, y].
group(name) Возвращает элемент групповой метки графа сцены, в котором произошло текущее событие.
hcl(*args) Создаёт новый цвет HCL: тон, насыщенность и яркость.
hours(datetime) Возвращает часы для datetime по местному времени.
hsl(*args) Создаёт новый цвет HSL.
hypot(value) Возвращает квадратный корень из суммы квадратов аргументов.
if_(test, thenValue, elseValue) Если test имеет истинное значение, возвращает thenValue.
inScope(item) Возвращает true, если элемент графа сцены item — потомок групповой метки, в которой определён обработчик события; иначе false.
indata(name, field, value) Проверяет, содержит ли набор name запись, в которой значение поля field совпадает с value.
indexof(array, value) Возвращает первый индекс value во входном массиве array.
info(value1, value2, *args) Записывает информационное сообщение и возвращает последний аргумент.
inrange(value, range) Проверяет, находится ли value между первым и последним значениями массива range, включая границы.
invert(name, value, group) Применяет обратное преобразование именованной шкалы или проекции к value.
isArray(value) Возвращает true, если value — массив; иначе false.
isBoolean(value) Возвращает true, если value — логическое значение (true или false); иначе false.
isDate(value) Возвращает true, если value — объект Date; иначе false.
isDefined(value) Возвращает true, если value определено; false, если равно undefined.
isFinite(value) Возвращает true, если value — конечное число.
isNaN(value) Возвращает true, если value — не число.
isNumber(value) Возвращает true, если value — число; иначе false.
isObject(value) Возвращает true, если value — объект, включая массивы и даты; иначе false.
isRegExp(value) Возвращает true, если value — объект регулярного выражения RegExp; иначе false.
isString(value) Возвращает true, если value — строка; иначе false.
isValid(value) Возвращает true, если value не равно null, undefined или NaN; иначе false.
item() Возвращает текущий элемент графа сцены, являющийся целью события.
join(array, separator) Возвращает строку из всех элементов массива array, разделённых запятыми или заданной строкой separator.
lab(*args) Создаёт новый цвет CIE LAB.
lastindexof(array, value) Возвращает последний индекс value во входном массиве array.
length(array) Возвращает длину входного массива array.
lerp(array, fraction) Возвращает линейно интерполированное значение между первым и последним элементами массива array для доли fraction, обычно от 0 до 1.
log(value) Возвращает натуральный логарифм value.
lower(string) Преобразует буквы строки string в нижний регистр.
luminance(specifier) Возвращает яркость цвета specifier, совместимого с функцией rgb библиотеки d3-color.
max(value1, value2, *args) Возвращает максимальное значение аргументов.
merge(object1, object2, *args) Объединяет входные объекты object1, object2 и другие в новый объект.
milliseconds(datetime) Возвращает миллисекунды для datetime по местному времени.
min(value1, value2, *args) Возвращает минимальное значение аргументов.
minutes(datetime) Возвращает минуты для datetime по местному времени.
month(datetime) Возвращает месяц, отсчитываемый от нуля для datetime по местному времени.
monthAbbrevFormat(month) Форматирует номер месяца, отсчитываемый от нуля, как сокращённое название согласно текущей локали.
monthFormat(month) Форматирует номер месяца, отсчитываемый от нуля, как полное название согласно текущей локали.
now() Возвращает временную метку текущего времени.
pad(string, length, character, align) Дополняет строку string повторениями character до заданной длины length.
panLinear(domain, delta) Для массива входной области domain линейной шкалы с числовыми значениями или датами возвращает новый массив границ из двух элементов после перемещения области на относительную величину delta.
panLog(domain, delta) Для массива входной области domain логарифмической шкалы с числовыми значениями или датами возвращает новый массив границ из двух элементов после перемещения области на относительную величину delta.
panPow(domain, delta, exponent) Для массива входной области domain степенной шкалы с числовыми значениями или датами и заданным показателем exponent возвращает новый массив границ из двух элементов после перемещения области на относительную величину delta.
panSymlog(domain, delta, constant) Для массива входной области domain симметричной логарифмической шкалы с числовыми значениями или датами и заданной константой constant возвращает новый массив границ из двух элементов после перемещения области на относительную величину delta.
parseFloat(string) Преобразует входную строку string в число с плавающей точкой.
parseInt(string) Преобразует входную строку string в целое число.
peek(array) Возвращает последний элемент входного массива array.
pinchAngle(event) Возвращает угол линии между первыми двумя точками касания многопальцевого события.
pinchDistance(event) Возвращает расстояние в пикселях между первыми двумя точками касания многопальцевого события.
pluck(array, field) Извлекает значения поля field из массива объектов array.
pow(value, exponent) Возвращает value в степени exponent.
quantileLogNormal(probability, mean, stdev) Возвращает квантиль (значение обратной функции распределения) для вероятности probability для логнормального распределения с заданным логарифмическим средним mean и логарифмическим стандартным отклонением stdev.
quantileNormal(probability, mean, stdev) Возвращает квантиль (значение обратной функции распределения) для вероятности probability для нормального распределения с заданным средним mean и стандартным отклонением stdev.
quantileUniform(probability, min, max) Возвращает квантиль (значение обратной функции распределения) для вероятности probability для равномерного распределения с заданным интервалом [min, max).
quarter(datetime) Возвращает квартал года (0–3) для datetime по местному времени.
random() Возвращает псевдослучайное число из диапазона [0,1).
range(name, group) Возвращает массив выходного диапазона именованной шкалы; если она не найдена, возвращает пустой массив.
regexp(pattern, flags) Создаёт регулярное выражение из строки pattern и необязательных флагов flags.
replace(string, pattern, replacement) Возвращает новую строку, где некоторые или все совпадения pattern заменены строкой replacement.
resolve_references(schema) Разрешает ссылки в контексте схемы объекта или корневой схемы.
reverse(array) Возвращает новый массив с элементами входного array в обратном порядке.
rgb(*args) Создаёт новый цвет RGB.
round(value) Округляет value до ближайшего целого.
sampleLogNormal(mean, stdev) Возвращает случайное значение из одномерного логнормального распределения с заданным логарифмическим средним mean и логарифмическим стандартным отклонением stdev.
sampleNormal(mean, stdev) Возвращает случайное значение из одномерного нормального распределения с заданным средним mean и стандартным отклонением stdev.
sampleUniform(min, max) Возвращает случайное значение из одномерного равномерного распределения с заданным интервалом [min, max).
scale(name, value, group) Применяет именованное преобразование шкалы или проекции к value.
screen() Возвращает объект window.screen или {}, если Vega выполняется вне браузера.
seconds(datetime) Возвращает секунды для datetime по местному времени.
sequence(*args) Возвращает массив с арифметической последовательностью чисел.
sin(value) Тригонометрический синус.
slice(array, start, end) Возвращает часть массива array между индексами start и end.
sort(array) Сортирует массив в естественном порядке с помощью ascending из Vega Utils.
span(array) Возвращает размах массива array: разность последнего и первого элементов, array[array.length-1] - array[0].
sqrt(value) Функция квадратного корня.
substring(string, start, end) Возвращает часть строки string между индексами start и end.
tan(value) Тригонометрический тангенс.
test(regexp, string) Проверяет строку string регулярным выражением regexp: возвращает true при совпадении с шаблоном, иначе false.
time(datetime) Возвращает временную метку datetime, отсчитываемую от эпохи Unix.
timeFormat(value, specifier) Форматирует дату и время value (объект Date или временную метку) как строку по правилам местного времени.
timeOffset(unit, date, step) Возвращает новый экземпляр Date, сдвигая date на единицу времени unit в часовом поясе местного времени.
timeParse(string, specifier) Преобразует строку в объект Date по правилам местного времени.
timeSequence(unit, start, stop, step) Возвращает массив экземпляров Date от start включительно до stop исключительно с шагом в единицах времени unit в часовом поясе местного времени.
timeUnitSpecifier(units, specifiers) Возвращает строку шаблона форматирования времени для единиц units.
timezoneoffset(datetime) Возвращает смещение местного часового пояса относительно UTC для datetime.
toBoolean(value) Преобразует входное value в строку.
toDate(value) Преобразует входное value в экземпляр Date.
toNumber(value) Преобразует входное value в число.
toString(value) Преобразует входное value в строку.
to_dict(validate, ignore, context) Возвращает представление объекта в виде словаря.
to_json(validate, indent, sort_keys, ignore, …) Возвращает представление объекта в строке JSON.
treeAncestors(name, node) Для иерархического набора name возвращает массив узлов-предков, начиная с node, затем его родителей до корня.
treePath(name, source, target) Для иерархического набора name возвращает кратчайший путь от идентификатора узла source до target.
trim(string) Возвращает строку без пробельных символов в начале и конце.
truncate(string, length, align, ellipsis) Обрезает входную строку string до длины length.
upper(string) Преобразует буквы строки string в верхний регистр.
utc(year, month, day, hour, …) Возвращает временную метку заданной даты UTC.
utcFormat(value, specifier) Форматирует дату и время value (объект Date или временную метку) как строку по правилам UTC.
utcOffset(unit, date, step) Возвращает новый экземпляр Date, сдвигая date на единицу времени unit в часовом поясе UTC.
utcParse(value, specifier) Преобразует строку в объект Date по правилам UTC.
utcSequence(unit, start, stop, step) Возвращает массив экземпляров Date от start включительно до stop исключительно с шагом в единицах времени unit в часовом поясе UTC.
utcdate(datetime) Возвращает день месяца для datetime по времени UTC.
utcday(datetime) Возвращает день недели для datetime по времени UTC.
utcdayofyear(datetime) Возвращает день года, отсчитываемый от единицы для datetime по времени UTC.
utchours(datetime) Возвращает часы для datetime по времени UTC.
utcmilliseconds(datetime) Возвращает миллисекунды для datetime по времени UTC.
utcminutes(datetime) Возвращает минуты для datetime по времени UTC.
utcmonth(datetime) Возвращает месяц, отсчитываемый от нуля для datetime по времени UTC.
utcquarter(datetime) Возвращает квартал года (0–3) для datetime по времени UTC.
utcseconds(datetime) Возвращает секунды для datetime по времени UTC.
utcweek(date) Возвращает номер недели года для datetime по времени UTC.
utcyear(datetime) Возвращает год для datetime по времени UTC.
validate(instance, schema) Проверяет экземпляр по схеме класса в контексте корневой схемы.
validate_property(name, value, schema) Проверяет свойство по его схеме в контексте корневой схемы.
warn(value1, value2, *args) Записывает предупреждение и возвращает последний аргумент.
week(date) Возвращает номер недели года для datetime по местному времени.
windowSize() Возвращает текущий размер окна [window.innerWidth, window.innerHeight] или [undefined, undefined], если Vega выполняется вне браузера.
x(item) Возвращает координату x текущего события.
xy(item) Возвращает координаты x и y текущего события массивом из двух элементов.
y(item) Возвращает координату y текущего события.
year(datetime) Возвращает год для datetime по местному времени.
zoomLinear(domain, anchor, scaleFactor) Для массива входной области domain линейной шкалы с числовыми значениями или датами возвращает новый массив границ из двух элементов после масштабирования области в scaleFactor раз относительно относительной точки привязки anchor.
zoomLog(domain, anchor, scaleFactor) Для массива входной области domain логарифмической шкалы с числовыми значениями или датами возвращает новый массив границ из двух элементов после масштабирования области в scaleFactor раз относительно относительной точки привязки anchor.
zoomPow(domain, anchor, scaleFactor, exponent) Для массива входной области domain степенной шкалы с числовыми значениями или датами и заданным показателем exponent возвращает новый массив границ из двух элементов после масштабирования области в scaleFactor раз относительно относительной точки привязки anchor.
zoomSymlog(domain, anchor, scaleFactor, constant) Для массива входной области domain симметричной логарифмической шкалы с числовыми значениями или датами и заданной константой constant возвращает новый массив границ из двух элементов после масштабирования области в scaleFactor раз относительно относительной точки привязки anchor.