altair.typing.EncodeKwds#
- class altair.typing.EncodeKwds#
编码通道将数据的属性映射到图表的可视属性。
- 参数:
- angle
点和文本标记的旋转角度。
- color
标记的颜色 - 根据标记定义的
filled
属性确定是填充色还是描边色。默认情况下,color
表示"area"`,
"bar"`,
"tick"`,
"text"`,
"trail"`,
"circle"`, 和
"square"` 的填充色,以及
"line"` 和
"point"` 的描边色。
默认值:如果未定义,默认颜色取决于标记配置的
color
属性。注意: 1) 要精细控制标记的填充色和描边色,请使用
fill
和stroke
通道。fill
或stroke
编码比color
具有更高的优先级,因此如果指定了冲突的编码,可能会覆盖color
编码。 2) 有关自定义配色方案的更多信息,请参阅比例尺文档。- column
网格图水平刻面的字段定义。
- description
此标记的文本描述,用于 ARIA 可访问性(仅限 SVG 输出)。对于 SVG 输出,
"aria-label"
属性将设置为此描述。- detail
在聚合视图和折线、轨迹和面积标记中用于分组数据的额外细节级别,而不将数据映射到特定的视觉通道。
- facet
网格图(灵活)刻面的字段定义。
如果指定了
row
或column
,此通道将被忽略。- fill
标记的填充色。**默认值:**如果未定义,默认颜色取决于标记配置的
color
属性。注意:
fill
编码比color
具有更高的优先级,因此如果指定了冲突的编码,可能会覆盖color
编码。- fillOpacity
标记的填充不透明度。
默认值:如果未定义,默认不透明度取决于标记配置的
fillOpacity
属性。- href
鼠标点击时加载的 URL。
- key
用于数据绑定的唯一键的数据字段。当可视化数据更新时,键值将用于将数据元素与现有的标记实例匹配。使用 key 通道可以为动态数据的过渡实现对象恒常性。
- latitude
地理投影标记的纬度位置。
- latitude2
地理投影的范围
"area"`,
"bar"`,
"rect"`, 和
"rule"` 的纬度-2 位置。
- longitude
地理投影标记的经度位置。
- longitude2
地理投影的范围
"area"`,
"bar"`,
"rect"`, 和
"rule"` 的经度-2 位置。
- opacity
标记的不透明度。
默认值:如果未定义,默认不透明度取决于标记配置的
opacity
属性。- order
标记的顺序。
对于堆叠标记,此
order
通道编码堆叠顺序。对于折线和轨迹标记,此
order
通道编码线中数据点的顺序。这对于创建连接散点图非常有用。将order` 设置为
{"value": null}` 会使折线标记使用数据源中的原始顺序。
否则,此
order
通道编码标记的图层顺序。
注意:在聚合图表中,
order
字段应进行聚合(aggregated),以避免创建额外的聚合分组。- radius
弧形标记的外半径(像素)。
- radius2
弧形标记的内半径(像素)。
- row
网格图垂直刻面的字段定义。
- shape
标记的形状。
1. 对于
point` 标记,支持的值包括: - 绘图形状:
"circle"`,
"square"`,
"cross"`,
"diamond"`,
"triangle-up"`,
"triangle-down"`,
"triangle-right"`, 或
"triangle-left"`。 - 线条符号
"stroke"` - 中心方向形状
"arrow"`,
"wedge"`, 或
"triangle"` - 自定义SVG 路径字符串(为确保正确尺寸,自定义形状路径应定义在一个方形边界框内,其 x 和 y 维度坐标范围均为 -1 到 1。)
对于
geoshape` 标记,它应该是 geojson 数据的字段定义
默认值:如果未定义,默认形状取决于标记配置的
shape
属性。(如果未设置,则为"circle"`。)
- size
标记的大小。
对于
"point"`,
"square"` 和
"circle"`,- 符号大小或标记的像素面积。
对于
"bar"` 和
"tick"` - 条形和刻度的大小。
对于
"text"` - 文本的字体大小。
Size 不支持
"line"`,
"area"`, 和
"rect"`。(可以使用
"trail"` 代替具有可变大小的折线)
- stroke
标记的描边色。**默认值:**如果未定义,默认颜色取决于标记配置的
color
属性。注意:
stroke` 编码比
color
具有更高的优先级,因此如果指定了冲突的编码,可能会覆盖color
编码。- strokeDash
标记的描边虚线样式。
默认值:
[1,0]`(无虚线)。
- strokeOpacity
标记的描边不透明度。
默认值:如果未定义,默认不透明度取决于标记配置的
strokeOpacity
属性。- strokeWidth
标记的描边宽度。
默认值:如果未定义,默认描边宽度取决于标记配置的
strokeWidth
属性。- text
text
标记的文本。- theta
对于弧形标记,如果未指定 theta2,则表示弧长(弧度),否则表示起始弧角。(值为 0 表示向上或“北方”,值增加表示顺时针方向。)
对于文本标记,表示极坐标角度(弧度)。
- theta2
弧形标记的终止角(弧度)。值为 0 表示向上或“北方”,值增加表示顺时针方向。
- tooltip
鼠标悬停时显示的工具提示文本。指定
tooltip` 编码会覆盖标记定义中的工具提示属性。
有关 Vega-Lite 中工具提示的详细讨论,请参阅工具提示文档。
- url
图像标记的 URL。
- x
标记的 X 坐标,或未指定
x2` 或
width` 时水平
"bar"` 和
"area"` 的宽度。
此通道的
value` 可以是数字或字符串
"width"`,表示绘图的宽度。
- x2
范围
"area"`,
"bar"`,
"rect"`, 和
"rule"` 的 X2 坐标。
此通道的
value` 可以是数字或字符串
"width"`,表示绘图的宽度。
- xError
错误指定
"errorbar"` 和
"errorband"` 的 X 坐标误差值。
- xError2
错误指定
"errorbar"` 和
"errorband"` 的 X 坐标次误差值。
- xOffset
标记 X 位置的偏移量
- y
标记的 Y 坐标,或未指定
y2` 或
height` 时垂直
"bar"` 和
"area"` 的高度。
此通道的
value` 可以是数字或字符串
"height"`,表示绘图的高度。
- y2
范围
"area"`,
"bar"`,
"rect"`, 和
"rule"` 的 Y2 坐标。
此通道的
value` 可以是数字或字符串
"height"`,表示绘图的高度。
- yError
错误指定
"errorbar"` 和
"errorband"` 的 Y 坐标误差值。
- yError2
错误指定
"errorbar"` 和
"errorband"` 的 Y 坐标次误差值。
- yOffset
标记 Y 位置的偏移量
- __init__(*args, **kwargs)#
方法
__init__
(*args, **kwargs)clear
()copy
()fromkeys
(iterable[, value])创建一个新字典,其键来自 iterable,值设置为 value。
get
(key[, default])如果 key 在字典中,返回 key 的值,否则返回 default。
items
()keys
()pop
(key[, default])如果未找到 key,则返回 default(如果给出);否则,引发 KeyError。
popitem
(/)移除并返回一个 (key, value) 对,作为 2 元组。
setdefault
(key[, default])如果 key 不在字典中,则插入 key 并将其值设为 default。
update
([E, ]**F)如果 E 存在且具有 .keys() 方法,则执行:对于 E 中的 k,D[k] = E[k]。如果 E 存在但没有 .keys() 方法,则执行:对于 E 中的 k, v 对,D[k] = v。无论哪种情况,之后都会执行:对于 F 中的 k,D[k] = F[k]。
values
()属性
angle
color
column
description
detail
facet
fill
fillOpacity
href
key
latitude
latitude2
longitude
longitude2
opacity
order
radius
radius2
row
shape
size
stroke
strokeDash
strokeOpacity
strokeWidth
text
theta
theta2
tooltip
url
x
x2
xError
xError2
xOffset
y
y2
yError
yError2
yOffset