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. |