altair.FacetedEncoding#

class altair.FacetedEncoding(angle=Undefined, color=Undefined, column=Undefined, description=Undefined, detail=Undefined, facet=Undefined, fill=Undefined, fillOpacity=Undefined, href=Undefined, key=Undefined, latitude=Undefined, latitude2=Undefined, longitude=Undefined, longitude2=Undefined, opacity=Undefined, order=Undefined, radius=Undefined, radius2=Undefined, row=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeDash=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, tooltip=Undefined, url=Undefined, x=Undefined, x2=Undefined, xError=Undefined, xError2=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, yError=Undefined, yError2=Undefined, yOffset=Undefined, **kwds)#

FacetedEncoding 模式封装器。

参数：
angledict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

点标记和文本标记的旋转角度。

colordict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

标记的颜色 - 基于标记定义中的 filled 属性，可以是填充色或描边色。默认情况下，color 表示 "area"、"bar"、"tick"、"text"、"trail"、"circle" 和 "square" 的填充色 / "line" 和 "point" 的描边色。

默认值: 如果未定义，默认颜色取决于 标记配置的 color 属性。

注意: 1) 要对标记的填充色和描边色进行精细控制，请使用 fill 和 stroke 通道。fill 或 stroke 编码比 color 具有更高的优先级，因此在指定冲突的编码时，它们可能会覆盖 color 编码。2) 有关自定义颜色方案的更多信息，请参阅比例尺文档。

columndict, RowColumnEncodingFieldDef

网格图的水平分面的字段定义。

descriptiondict, StringFieldDefWithCondition, StringValueDefWithCondition

此标记的文本描述，用于 ARIA 可访问性（仅限 SVG 输出）。对于 SVG 输出，"aria-label" 属性将设置为此描述。

detaildict, FieldDefWithoutScale, Sequence[dict, FieldDefWithoutScale]

用于在聚合视图以及线、轨迹和面积标记中对数据进行分组的更多详细信息级别，无需将数据映射到特定的视觉通道。

facetdict, FacetEncodingFieldDef

网格图的（灵活）分面的字段定义。

如果指定了 row 或 column，则此通道将被忽略。

filldict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

标记的填充色。默认值：如果未定义，默认颜色取决于 标记配置的 color 属性。

注意: fill 编码比 color 具有更高的优先级，因此在指定冲突的编码时，它可能会覆盖 color 编码。

fillOpacitydict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

标记的填充不透明度。

默认值：如果未定义，默认不透明度取决于 标记配置的 fillOpacity 属性。

hrefdict, StringFieldDefWithCondition, StringValueDefWithCondition

鼠标点击时加载的 URL。

keydict, FieldDefWithoutScale

用作数据绑定唯一键的数据字段。更新可视化数据时，将使用键值将数据元素与现有标记实例匹配。使用键通道可以实现动态数据转换中的对象恒定性。

latitudedict, DatumDef, LatLongDef, LatLongFieldDef

地理投影标记的纬度位置。

latitude2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

地理投影范围标记 "area"、"bar"、"rect" 和 "rule" 的纬度-2 位置。

longitudedict, DatumDef, LatLongDef, LatLongFieldDef

地理投影标记的经度位置。

longitude2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

地理投影范围标记 "area"、"bar"、"rect" 和 "rule" 的经度-2 位置。

opacitydict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

标记的不透明度。

默认值：如果未定义，默认不透明度取决于 标记配置的 opacity 属性。

orderdict, OrderOnlyDef, OrderFieldDef, OrderValueDef, Sequence[dict, OrderFieldDef]

标记的顺序。

  • 对于堆叠标记，此 order 通道编码堆叠顺序。

  • 对于线标记和轨迹标记，此 order 通道编码线中数据点的顺序。这对于创建连接散点图非常有用。将 order 设置为 {"value": null} 使线标记使用数据源中的原始顺序。

  • 否则，此 order 通道编码标记的层顺序。

注意: 在聚合图中，order 字段应进行``aggregate``d 以避免创建额外的聚合分组。

radiusdict, PolarDef, PositionValueDef, PositionDatumDefBase, PositionFieldDefBase

弧形标记的外部半径（像素）。

radius2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

弧形标记的内部半径（像素）。

rowdict, RowColumnEncodingFieldDef

网格图的垂直分面的字段定义。

shapedict, ShapeDef, FieldOrDatumDefWithConditionDatumDefstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull, ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull

标记的形状。

1. 对于 point 标记，支持的值包括：- 绘图形状："circle"、"square"、"cross"、"diamond"、"triangle-up"、"triangle-down"、"triangle-right" 或 "triangle-left"。- 线符号 "stroke" - 中心定向形状 "arrow"、"wedge" 或 "triangle" - 自定义 SVG 路径字符串（为了正确调整大小，自定义形状路径应定义在 x 和 y 维度坐标范围都在 -1 到 1 的正方形边界框内。）

  1. 对于 geoshape 标记，它应该是 geojson 数据的字段定义

默认值：如果未定义，默认形状取决于 标记配置的 shape 属性。（如果未设置，则为 "circle"。）

sizedict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

标记的大小。

  • 对于 "point"、"square" 和 "circle"，- 符号大小，或标记的像素面积。

  • 对于 "bar" 和 "tick" - 条形和刻度的大小。

  • 对于 "text" - 文本的字体大小。

  • 不支持 "line"、"area" 和 "rect" 的 Size。（使用 "trail" 代替具有可变大小的 line）

strokedict, ColorDef, FieldOrDatumDefWithConditionDatumDefGradientstringnull, FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull

标记的描边色。默认值：如果未定义，默认颜色取决于 标记配置的 color 属性。

注意: stroke 编码比 color 具有更高的优先级，因此在指定冲突的编码时，它可能会覆盖 color 编码。

strokeDashdict, NumericArrayMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumberArray, FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray, ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray

标记的描边虚线样式。

默认值： [1,0] （无虚线）。

strokeOpacitydict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

标记的描边不透明度。

默认值：如果未定义，默认不透明度取决于 标记配置的 strokeOpacity 属性。

strokeWidthdict, NumericMarkPropDef, FieldOrDatumDefWithConditionDatumDefnumber, FieldOrDatumDefWithConditionMarkPropFieldDefnumber, ValueDefWithConditionMarkPropFieldOrDatumDefnumber

标记的描边宽度。

默认值：如果未定义，默认描边宽度取决于 标记配置的 strokeWidth 属性。

textdict, TextDef, ValueDefWithConditionStringFieldDefText, FieldOrDatumDefWithConditionStringDatumDefText, FieldOrDatumDefWithConditionStringFieldDefText

text 标记的文本内容。

thetadict, PolarDef, PositionValueDef, PositionDatumDefBase, PositionFieldDefBase

  • 对于弧形标记，如果未指定 theta2，则为弧长（弧度）；否则为起始弧角。（值为 0 表示向上或“北方”，值增加则顺时针方向前进。）

  • 对于文本标记，极坐标角度（弧度）。

theta2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

弧形标记的结束角（弧度）。值为 0 表示向上或“北方”，值增加则顺时针方向前进。

tooltipdict, StringFieldDefWithCondition, StringValueDefWithCondition, Sequence[dict, StringFieldDef], None

鼠标悬停时显示的工具提示文本。指定 tooltip 编码会覆盖标记定义中的 tooltip 属性。

有关 Vega-Lite 中工具提示的详细讨论，请参阅工具提示文档。

urldict, StringFieldDefWithCondition, StringValueDefWithCondition

图像标记的 URL。

xdict, PositionDef, PositionDatumDef, PositionFieldDef, PositionValueDef

标记的 X 坐标，或未指定 x2 或 width 的水平 "bar" 和 "area" 的宽度。

此通道的 value 可以是数字，也可以是字符串 "width" 表示图表的宽度。

x2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

范围标记 "area"、"bar"、"rect" 和 "rule" 的 X2 坐标。

此通道的 value 可以是数字，也可以是字符串 "width" 表示图表的宽度。

xErrordict, ValueDefnumber, SecondaryFieldDef

指定错误类型 "errorbar" 和 "errorband" 的 x 坐标错误值。

xError2dict, ValueDefnumber, SecondaryFieldDef

指定错误类型 "errorbar" 和 "errorband" 的 x 坐标次级错误值。

xOffsetdict, OffsetDef, ScaleDatumDef, ScaleFieldDef, ValueDefnumber

标记的 x 位置偏移。

ydict, PositionDef, PositionDatumDef, PositionFieldDef, PositionValueDef

标记的 Y 坐标，或未指定 y2 或 height 时，垂直 "bar" 和 "area" 的高度。

此通道的 value 可以是数字或字符串 "height"，表示绘图区域的高度。

y2dict, DatumDef, Position2Def, PositionValueDef, SecondaryFieldDef

用于范围型 "area"、"bar"、"rect" 和 "rule" 的 Y2 坐标。

此通道的 value 可以是数字或字符串 "height"，表示绘图区域的高度。

yErrordict, ValueDefnumber, SecondaryFieldDef

指定错误类型 "errorbar" 和 "errorband" 的 y 坐标错误值。

yError2dict, ValueDefnumber, SecondaryFieldDef

指定错误类型 "errorbar" 和 "errorband" 的 y 坐标次级错误值。

yOffsetdict, OffsetDef, ScaleDatumDef, ScaleFieldDef, ValueDefnumber

标记的 y 位置偏移。

__init__(angle=Undefined, color=Undefined, column=Undefined, description=Undefined, detail=Undefined, facet=Undefined, fill=Undefined, fillOpacity=Undefined, href=Undefined, key=Undefined, latitude=Undefined, latitude2=Undefined, longitude=Undefined, longitude2=Undefined, opacity=Undefined, order=Undefined, radius=Undefined, radius2=Undefined, row=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeDash=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, tooltip=Undefined, url=Undefined, x=Undefined, x2=Undefined, xError=Undefined, xError2=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, yError=Undefined, yError2=Undefined, yOffset=Undefined, **kwds)#

方法

__init__([angle, color, column, ...])

返回对象的副本。

copy([deep, ignore])

从字典表示形式构造类。

from_dict(dct[, validate])

从有效的 JSON 字符串实例化对象。

from_json(json_string[, validate])

在此对象 schema 或根 schema 的上下文中解析引用。

resolve_references([schema])

返回对象的字典表示形式。

to_dict([validate, ignore, context])

将此对象的 JSON 表示形式作为字符串发出。

to_json([validate, indent, sort_keys, ...])

在根 schema 的上下文中，根据类 schema 验证实例。

validate(instance[, schema])

在根 schema 的上下文中，根据属性 schema 验证属性。

validate_property(name, value[, schema])