class altair.VConcatChart(vconcat=Undefined, autosize=Undefined, background=Undefined, bounds=Undefined, center=Undefined, config=Undefined, data=Undefined, datasets=Undefined, description=Undefined, name=Undefined, padding=Undefined, params=Undefined, resolve=Undefined, spacing=Undefined, title=Undefined, transform=Undefined, usermeta=Undefined, **kwds)#

A chart with vertically-concatenated facets

__init__(vconcat=Undefined, autosize=Undefined, background=Undefined, bounds=Undefined, center=Undefined, config=Undefined, data=Undefined, datasets=Undefined, description=Undefined, name=Undefined, padding=Undefined, params=Undefined, resolve=Undefined, spacing=Undefined, title=Undefined, transform=Undefined, usermeta=Undefined, **kwds)#

Refer to TopLevelVConcatSpec

TopLevelVConcatSpec, Dict[required=[vconcat]]

vconcatSequence[ConcatSpecGenericSpec, Dict[required=[concat]], FacetSpec, Dict[required=[facet, spec]], FacetedUnitSpec, Dict[required=[mark]], HConcatSpecGenericSpec, Dict[required=[hconcat]], LayerRepeatSpec, Dict[required=[repeat, spec]], NonLayerRepeatSpec, Dict[required=[repeat, spec]], RepeatSpec, LayerSpec, Dict[required=[layer]], NonNormalizedSpec, VConcatSpecGenericSpec, Dict[required=[vconcat]]]

A list of views to be concatenated and put into a column.

autosizeAutoSizeParams, Dict, AutosizeType, Literal[‘pad’, ‘none’, ‘fit’, ‘fit-x’, ‘fit-y’]

How the visualization size should be determined. If a string, should be one of "pad", "fit" or "none". Object values can additionally specify parameters for content sizing and automatic resizing.

Default value : pad

backgroundColorName, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], Color, HexColor, str, str, ExprRef, Dict[required=[expr]]

CSS color property to use as the background of the entire view.

Default value: "white"

boundsLiteral[‘full’, ‘flush’]

The bounds calculation method to use for determining the extent of a sub-plot. One of full (the default) or flush.

  • If set to full, the entire calculated bounds (including axes, title, and legend) will be used.

  • If set to flush, only the specified width and height values for the sub-view will be used. The flush setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.

Default value: "full"


Boolean flag indicating if subviews should be centered relative to their respective rows or columns.

Default value: false

configConfig, Dict

Vega-Lite configuration object. This property can only be defined at the top-level of a specification.

dataDataSource, InlineData, Dict[required=[values]], NamedData, Dict[required=[name]], UrlData, Dict[required=[url]], Data, Generator, GraticuleGenerator, Dict[required=[graticule]], SequenceGenerator, Dict[required=[sequence]], SphereGenerator, Dict[required=[sphere]], None

An object describing the data source. Set to null to ignore the parent’s data source. If no data is set, it is derived from the parent.

datasetsDatasets, Dict

A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a data property.


Description of this mark for commenting purpose.


Name of the visualization for later reference.

paddingExprRef, Dict[required=[expr]], Padding, Dict, float

The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format {"left": 5, "top": 5, "right": 5, "bottom": 5} to specify padding for each side of the visualization.

Default value : 5

paramsSequence[TopLevelParameter, TopLevelSelectionParameter, Dict[required=[name, select]], VariableParameter, Dict[required=[name]]]

Dynamic variables or selections that parameterize a visualization.

resolveResolve, Dict

Scale, axis, and legend resolutions for view composition specifications.


The spacing in pixels between sub-views of the concat operator.

Default value : 10

titleText, Sequence[str], str, TitleParams, Dict[required=[text]]

Title for the plot.

transformSequence[AggregateTransform, Dict[required=[aggregate]], BinTransform, Dict[required=[bin, field, as]], CalculateTransform, Dict[required=[calculate, as]], DensityTransform, Dict[required=[density]], ExtentTransform, Dict[required=[extent, param]], FilterTransform, Dict[required=[filter]], FlattenTransform, Dict[required=[flatten]], FoldTransform, Dict[required=[fold]], ImputeTransform, Dict[required=[impute, key]], JoinAggregateTransform, Dict[required=[joinaggregate]], LoessTransform, Dict[required=[loess, on]], LookupTransform, Dict[required=[lookup, from]], PivotTransform, Dict[required=[pivot, value]], QuantileTransform, Dict[required=[quantile]], RegressionTransform, Dict[required=[regression, on]], SampleTransform, Dict[required=[sample]], StackTransform, Dict[required=[stack, groupby, as]], TimeUnitTransform, Dict[required=[timeUnit, field, as]], Transform, WindowTransform, Dict[required=[window]]]

An array of data transformations such as filter and new field calculation.

usermetaDict, Dict

Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata.


URL to JSON schema for a Vega-Lite specification. Unless you have a reason to change this, use Setting the $schema property allows automatic validation and autocomplete in editors that support JSON schema.


__init__([vconcat, autosize, background, ...])

Refer to TopLevelVConcatSpec


Add one or more parameters to the chart.


'add_selection' is deprecated.

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

Refer to Config

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

Refer to RectConfig

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

Refer to AreaConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

configure_axisQuantitative([aria, ...])

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

configure_axisXDiscrete([aria, ...])

Refer to AxisConfig

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

Refer to AxisConfig

configure_axisXQuantitative([aria, ...])

Refer to AxisConfig

configure_axisXTemporal([aria, ...])

Refer to AxisConfig

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

Refer to AxisConfig

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

Refer to AxisConfig

configure_axisYDiscrete([aria, ...])

Refer to AxisConfig

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

Refer to AxisConfig

configure_axisYQuantitative([aria, ...])

Refer to AxisConfig

configure_axisYTemporal([aria, ...])

Refer to AxisConfig

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

Refer to BarConfig

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

Refer to BoxPlotConfig

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

Refer to MarkConfig

configure_concat([columns, spacing])

Refer to CompositionConfig

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

Refer to ErrorBandConfig

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

Refer to ErrorBarConfig

configure_facet([columns, spacing])

Refer to CompositionConfig

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

Refer to MarkConfig

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

Refer to HeaderConfig

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

Refer to HeaderConfig

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

Refer to HeaderConfig

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

Refer to HeaderConfig

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

Refer to RectConfig

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

Refer to LegendConfig

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

Refer to LineConfig

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

Refer to MarkConfig

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

Refer to MarkConfig

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

Refer to ProjectionConfig

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

Refer to RangeConfig

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

Refer to RectConfig

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

Refer to MarkConfig

configure_scale([bandPaddingInner, ...])

Refer to ScaleConfig

configure_selection([interval, point])

Refer to SelectionConfig

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

Refer to MarkConfig

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

Refer to MarkConfig

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

Refer to TickConfig

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

Refer to TitleConfig


Refer to FormatConfig

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

Refer to LineConfig

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

Refer to ViewConfig

copy([deep, ignore])

Return a copy of the object

display([renderer, theme, actions])

Display chart in Jupyter notebook or JupyterLab

from_dict(dct[, validate, _wrapper_classes])

Construct class from a dictionary representation

from_json(json_string[, validate])

Instantiate the object from a valid JSON string

interactive([name, bind_x, bind_y])

Make chart axes scales interactive

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

Add a geographic projection to the chart.


Set top-level properties of the Chart.

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

Return a RepeatChart built from the chart

resolve_axis([x, y])

Refer to AxisResolveMap

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

Refer to LegendResolveMap


Resolve references in the context of this object's schema or root schema.

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

Refer to ScaleResolveMap

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

Save a chart to file in a variety of formats

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

'serve' is deprecated.

show([embed_opt, open_browser])

Show the chart in an external browser window.

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

Convert the chart to a dictionary suitable for JSON export

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

Embed a Vega/Vega-Lite spec into an HTML page

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

Convert a chart to a JSON string

to_url(*[, fullscreen])

Convert a chart to a URL that opens the chart specification in the Vega chart editor The chart specification (including any inline data) is encoded in the URL.

transform_aggregate([aggregate, groupby])

Add an AggregateTransform to the schema.

transform_bin([as_, field, bin])

Add a BinTransform to the schema.

transform_calculate([as_, calculate])

Add a CalculateTransform to the schema.

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

Add a DensityTransform to the spec.

transform_extent(extent, param)

Add a ExtentTransform to the spec.

transform_filter(filter, **kwargs)

Add a FilterTransform to the schema.

transform_flatten(flatten[, as_])

Add a FlattenTransform to the schema.

transform_fold(fold[, as_])

Add a FoldTransform to the spec.

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

Add an ImputeTransform to the schema.

transform_joinaggregate([joinaggregate, groupby])

Add a JoinAggregateTransform to the schema.

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

Add a LoessTransform to the spec.

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

Add a DataLookupTransform or SelectionLookupTransform to the chart

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

Add a PivotTransform to the chart.

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

Add a QuantileTransform to the chart

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

Add a RegressionTransform to the chart.


Add a SampleTransform to the schema.

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

Add a StackTransform to the schema.

transform_timeunit([as_, field, timeUnit])

Add a TimeUnitTransform to the schema.

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

Add a WindowTransform to the schema

transformed_data([row_limit, exclude])

Evaluate a VConcatChart's transforms

validate(instance[, schema])

Validate the instance against the class schema in the context of the rootschema.

validate_property(name, value[, schema])

Validate a property against property schema in the context of the rootschema