altair.Chart#

class altair.Chart(data=Undefined, encoding=Undefined, mark=Undefined, width=Undefined, height=Undefined, **kwargs)#

创建一个基本的 Altair/Vega-Lite 图表。

虽然可以将所有 Chart 属性设置为构造函数属性，但更常用的方法是使用诸如 mark_point()、encode()、transform_filter()、properties() 等方法。有关详细信息和示例，请参阅 Altair 文档：https://vega-altair.cn/。

参数:
dataData

描述数据源的对象

markAnyMark

一个MarkDef 或 CompositeMarkDef 对象，或者描述标记类型的字符串（以下之一：“arc”、“area”、“bar”、“circle”、“geoshape”、“image”、“line”、“point”、“rule”、“rect”、“square”、“text”、“tick”、“trail”、“boxplot”、“errorband” 和 “errorbar”）。

encodingFacetedEncoding

编码通道和字段定义之间的键值映射。

autosizeanyOf(AutosizeType, AutoSizeParams)

设置可视化大小的确定方式。如果是字符串，应为 “pad”、“fit” 或 “none” 之一。对象值还可以指定内容大小和自动调整大小的参数。“fit” 仅支持不使用 rangeStep 的单个和分层视图。默认值：pad

backgroundstring

用作可视化背景的 CSS 颜色属性。

默认值： none（透明）

configConfig

Vega-Lite 配置对象。此属性只能在规范的顶层定义。

descriptionstring

此标记的描述，用于注释目的。

heightfloat

可视化的高度。

namestring

可视化的名称，用于以后引用。

paddingPadding

默认的可视化填充，以像素为单位，从可视化画布边缘到数据矩形。如果是一个数字，则指定所有边的填充。如果是一个对象，则该值应具有 {“left”: 5, “top”: 5, “right”: 5, “bottom”: 5} 格式，以指定可视化的每一边的填充。默认值：5

projectionProjection

一个定义地理投影属性的对象。适用于 “geoshape” 标记以及具有 “latitude” 或 “longitude” 类型的通道（一个或多个 “X”、“X2”、“Y”、“Y2”）的 “point” 或 “line” 标记。

selectionMapping(required=[])

选择名称和定义之间的键值映射。

titleanyOf(string, TitleParams)

图表的标题。

transformList(Transform)

数据转换数组，例如过滤和新字段计算。

widthfloat

可视化的宽度。

__init__(data=Undefined, encoding=Undefined, mark=Undefined, width=Undefined, height=Undefined, **kwargs)#

方法

__init__([data, encoding, mark, width, height])

add_params(*params)

向图表添加一个或多个参数。

add_selection(*params)

'add_selection' 已弃用

configure([arc, area, aria, autosize, axis, ...])

请参阅 Config Config schema wrapper。

configure_arc([align, angle, aria, ...])

请参阅 RectConfig RectConfig schema wrapper。

configure_area([align, angle, aria, ...])

请参阅 AreaConfig AreaConfig schema wrapper。

configure_axis([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisBand([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisBottom([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisDiscrete([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisLeft([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisPoint([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisQuantitative([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisRight([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisTemporal([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisTop([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisX([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisXBand([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisXDiscrete([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisXPoint([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisXQuantitative([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisXTemporal([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisY([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisYBand([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisYDiscrete([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisYPoint([aria, bandPosition, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisYQuantitative([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_axisYTemporal([aria, ...])

请参阅 AxisConfig AxisConfig schema wrapper。

configure_bar([align, angle, aria, ...])

请参阅 BarConfig BarConfig schema wrapper。

configure_boxplot([box, extent, median, ...])

请参阅 BoxPlotConfig BoxPlotConfig schema wrapper。

configure_circle([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_concat([columns, spacing])

请参阅 CompositionConfig CompositionConfig schema wrapper。

configure_errorband([band, borders, extent, ...])

请参阅 ErrorBandConfig ErrorBandConfig schema wrapper。

configure_errorbar([extent, rule, size, ...])

请参阅 ErrorBarConfig ErrorBarConfig schema wrapper。

configure_facet([columns, spacing])

请参阅 CompositionConfig CompositionConfig schema wrapper。

configure_geoshape([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_header([format, formatType, ...])

请参阅 HeaderConfig HeaderConfig schema wrapper。

configure_headerColumn([format, formatType, ...])

请参阅 HeaderConfig HeaderConfig schema wrapper。

configure_headerFacet([format, formatType, ...])

请参阅 HeaderConfig HeaderConfig schema wrapper。

configure_headerRow([format, formatType, ...])

请参阅 HeaderConfig HeaderConfig schema wrapper。

configure_image([align, angle, aria, ...])

请参阅 RectConfig RectConfig schema wrapper。

configure_legend([aria, clipHeight, ...])

请参阅 LegendConfig LegendConfig schema wrapper。

configure_line([align, angle, aria, ...])

请参阅 LineConfig LineConfig schema wrapper。

configure_mark([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_point([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_projection([center, clipAngle, ...])

请参阅 ProjectionConfig ProjectionConfig schema wrapper。

configure_range([category, diverging, ...])

请参阅 RangeConfig RangeConfig schema wrapper。

configure_rect([align, angle, aria, ...])

请参阅 RectConfig RectConfig schema wrapper。

configure_rule([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_scale([bandPaddingInner, ...])

请参阅 ScaleConfig ScaleConfig schema wrapper。

configure_selection([interval, point])

请参阅 SelectionConfig SelectionConfig schema wrapper。

configure_square([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_text([align, angle, aria, ...])

请参阅 MarkConfig MarkConfig schema wrapper。

configure_tick([align, angle, aria, ...])

请参阅 TickConfig TickConfig schema wrapper。

configure_title([align, anchor, angle, ...])

请参阅 TitleConfig TitleConfig schema wrapper。

configure_tooltipFormat([...])

请参阅 FormatConfig FormatConfig schema wrapper。

configure_trail([align, angle, aria, ...])

请参阅 LineConfig LineConfig schema wrapper。

configure_view([clip, continuousHeight, ...])

请参阅 ViewConfig ViewConfig schema wrapper。

copy([deep, ignore])

返回对象的副本。

display([renderer, theme, actions])

在 Jupyter notebook 或 JupyterLab 中显示图表。

encode(*args[, angle, color, column, ...])

将数据的属性映射到图表的视觉属性（参见 FacetedEncoding）。

facet([facet, row, column, data, columns])

从当前图表创建分面图表。

from_dict(dct[, validate])

从字典表示构造一个 Chart 对象。

from_json(json_string[, validate])

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

interactive([name, bind_x, bind_y])

使图表轴刻度具有交互性。

mark_arc([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'arc'（参见 MarkDef）。

mark_area([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'area'（参见 MarkDef）。

mark_bar([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'bar'（参见 MarkDef）。

mark_boxplot([box, clip, color, extent, ...])

将图表的标记设置为 'boxplot'（参见 BoxPlotDef）。

mark_circle([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'circle'（参见 MarkDef）。

mark_errorband([band, borders, clip, color, ...])

将图表的标记设置为 'errorband'（参见 ErrorBandDef）。

mark_errorbar([clip, color, extent, ...])

将图表的标记设置为 'errorbar'（参见 ErrorBarDef）。

mark_geoshape([align, angle, aria, ...])

将图表的标记设置为 'geoshape'（参见 MarkDef）。

mark_image([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'image'（参见 MarkDef）。

mark_line([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'line'（参见 MarkDef）。

mark_point([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'point'（参见 MarkDef）。

mark_rect([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'rect'（参见 MarkDef）。

mark_rule([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'rule'（参见 MarkDef）。

mark_square([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'square'（参见 MarkDef）。

mark_text([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'text'（参见 MarkDef）。

mark_tick([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'tick'（参见 MarkDef）。

mark_trail([align, angle, aria, ariaRole, ...])

将图表的标记设置为 'trail'（参见 MarkDef）。

open_editor(*[, fullscreen])

使用默认浏览器在 Vega 图表编辑器中打开图表规范。

project([type, center, clipAngle, ...])

向图表添加地理投影。

properties(**kwargs)

设置 Chart 的顶层属性。

repeat([repeat, row, column, layer, columns])

返回从当前图表构建的 RepeatChart。

resolve_axis([x, y])

请参阅 AxisResolveMap AxisResolveMap schema wrapper。

resolve_legend([angle, color, fill, ...])

请参阅 LegendResolveMap LegendResolveMap schema wrapper。

resolve_references([schema])

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

resolve_scale([angle, color, fill, ...])

请参阅 ScaleResolveMap ScaleResolveMap schema wrapper。

save(fp[, format, ...])

将图表保存为各种格式的文件。

serve([ip, port, n_retries, files, ...])

'serve' 已弃用。

show()

使用活动渲染器显示图表。

to_dict([validate, format, ignore, context])

将 Chart 转换为适合 JSON 导出的字典。

to_html([base_url, output_div, ...])

将 Vega/Vega-Lite 规范嵌入到 HTML 页面中。

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

将图表转换为 JSON 字符串。

to_url(*[, fullscreen])

将图表转换为可在 Vega 图表编辑器中打开图表规范的 URL。

transform_aggregate([aggregate, groupby])

向 schema 添加一个 AggregateTransform。

transform_bin([as_, field, bin])

向 schema 添加一个 BinTransform。

transform_calculate([as_, calculate])

向 schema 添加一个 CalculateTransform。

transform_density(density[, as_, bandwidth, ...])

向 spec 添加一个 DensityTransform。

transform_extent(extent, param)

向 spec 添加一个 ExtentTransform。

transform_filter([predicate, empty])

向 spec 添加一个 FilterTransform。

transform_flatten(flatten[, as_])

向 schema 添加一个 FlattenTransform。

transform_fold(fold[, as_])

向 spec 添加一个 FoldTransform。

transform_impute(impute, key[, frame, ...])

向 schema 添加一个 ImputeTransform。

transform_joinaggregate([joinaggregate, groupby])

向 schema 添加一个 JoinAggregateTransform。

transform_loess(on, loess[, as_, bandwidth, ...])

向 spec 添加一个 LoessTransform。

transform_lookup([lookup, from_, as_, default])

向图表添加一个 DataLookupTransform 或 SelectionLookupTransform。

transform_pivot(pivot, value[, groupby, ...])

向图表添加一个 PivotTransform。

transform_quantile(quantile[, as_, groupby, ...])

向图表添加一个 QuantileTransform。

transform_regression(on, regression[, as_, ...])

向图表添加一个 RegressionTransform。

transform_sample([sample])

向 schema 添加一个 SampleTransform。

transform_stack(as_, stack, groupby[, ...])

向 schema 添加一个 StackTransform。

transform_timeunit([as_, field, timeUnit])

向 schema 添加一个 TimeUnitTransform。

transform_window([window, frame, groupby, ...])

向 schema 添加一个 WindowTransform。

transformed_data([row_limit, exclude])

评估 Chart 的转换。

validate(instance[, schema])

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

validate_property(name, value[, schema])

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

属性

data