altair.Chart

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

Create a basic Altair/Vega-Lite chart.

Although it is possible to set all Chart properties as constructor attributes, it is more idiomatic to use methods such as mark_point(), encode(), transform_filter(), properties(), etc. See Altair’s documentation for details and examples: http://altair-viz.github.io/.

Attributes:
data : Data

An object describing the data source

mark : AnyMark
A string describing the mark type (one of “bar”, “circle”, “square”, “tick”,

“line”, * “area”, “point”, “rule”, “geoshape”, and “text”) or a MarkDef object.

encoding : EncodingWithFacet

A key-value mapping between encoding channels and definition of fields.

autosize : anyOf(AutosizeType, AutoSizeParams)

Sets 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. “fit” is only supported for single and layered views that don’t use rangeStep. __Default value__: pad

background : string

CSS color property to use as the background of visualization.

Default value: none (transparent)

config : Config

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

description : string

Description of this mark for commenting purpose.

height : float

The height of a visualization.

name : string

Name of the visualization for later reference.

padding : Padding

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

projection : Projection

An object defining properties of geographic projection. Works with “geoshape” marks and “point” or “line” marks that have a channel (one or more of “X”, “X2”, “Y”, “Y2”) with type “latitude”, or “longitude”.

selection : Mapping(required=[])

A key-value mapping between selection names and definitions.

title : anyOf(string, TitleParams)

Title for the plot.

transform : List(Transform)

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

width : float

The width of a visualization.

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

Methods

__init__([data, encoding, mark, width, height])
add_selection(*selections) Add one or more selections to the chart
configure([area, autosize, axis, axisBand, …]) Config schema wrapper
configure_area([align, angle, baseline, …]) AreaConfig schema wrapper
configure_axis([bandPosition, domain, …]) AxisConfig schema wrapper
configure_axisBand([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisBottom([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisLeft([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisRight([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisTop([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisX([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_axisY([bandPosition, domain, …]) VgAxisConfig schema wrapper
configure_bar([align, angle, baseline, …]) BarConfig schema wrapper
configure_circle([align, angle, baseline, …]) MarkConfig schema wrapper
configure_geoshape([align, angle, baseline, …]) MarkConfig schema wrapper
configure_header([labelAngle, labelColor, …]) HeaderConfig schema wrapper
configure_legend([cornerRadius, …]) LegendConfig schema wrapper
configure_line([align, angle, baseline, …]) LineConfig schema wrapper
configure_mark([align, angle, baseline, …]) MarkConfig schema wrapper
configure_point([align, angle, baseline, …]) MarkConfig schema wrapper
configure_projection([center, clipAngle, …]) ProjectionConfig schema wrapper
configure_range([category, diverging, …]) RangeConfig schema wrapper
configure_rect([align, angle, baseline, …]) MarkConfig schema wrapper
configure_rule([align, angle, baseline, …]) MarkConfig schema wrapper
configure_scale([bandPaddingInner, …]) ScaleConfig schema wrapper
configure_selection([interval, multi, single]) SelectionConfig schema wrapper
configure_square([align, angle, baseline, …]) MarkConfig schema wrapper
configure_text([align, angle, baseline, …]) TextConfig schema wrapper
configure_tick([align, angle, bandSize, …]) TickConfig schema wrapper
configure_title([anchor, angle, baseline, …]) VgTitleConfig schema wrapper
configure_trail([align, angle, baseline, …]) LineConfig schema wrapper
configure_view([clip, fill, fillOpacity, …]) ViewConfig schema wrapper
copy([deep, ignore]) Return a copy of the object
display([renderer, theme, actions]) Display chart in Jupyter notebook or JupyterLab
encode([color, column, detail, fill, href, …]) EncodingWithFacet schema wrapper
facet([row, column, data]) Create a facet chart from the current chart.
from_dict(dct[, validate]) 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
mark_area([align, angle, baseline, …]) Set the chart’s mark to ‘area’
mark_bar([align, angle, baseline, …]) Set the chart’s mark to ‘bar’
mark_circle([align, angle, baseline, …]) Set the chart’s mark to ‘circle’
mark_geoshape([align, angle, baseline, …]) Set the chart’s mark to ‘geoshape’
mark_line([align, angle, baseline, …]) Set the chart’s mark to ‘line’
mark_point([align, angle, baseline, …]) Set the chart’s mark to ‘point’
mark_rect([align, angle, baseline, …]) Set the chart’s mark to ‘rect’
mark_rule([align, angle, baseline, …]) Set the chart’s mark to ‘rule’
mark_square([align, angle, baseline, …]) Set the chart’s mark to ‘square’
mark_text([align, angle, baseline, …]) Set the chart’s mark to ‘text’
mark_tick([align, angle, baseline, …]) Set the chart’s mark to ‘tick’
mark_trail([align, angle, baseline, …]) Set the chart’s mark to ‘trail’
project([type, center, clipAngle, …]) Add a geographic projection to the chartself.
properties(**kwargs) Set top-level properties of the Chart.
repeat([row, column]) Return a RepeatChart built from the chart
resolve_axis([x, y]) AxisResolveMap schema wrapper
resolve_legend([color, fill, opacity, …]) LegendResolveMap schema wrapper
resolve_references(schema) Resolve references of the schema the context of this object’s schema
resolve_scale([color, fill, opacity, shape, …]) ScaleResolveMap schema wrapper
save(fp[, format, …]) Save a chart to file in a variety of formats
savechart(fp[, format]) Save a chart to file in a variety of formats
serve([ip, port, n_retries, files, …]) Open a browser window and display a rendering of the chart
to_dict(*args, **kwargs) Convert the chart to a dictionary suitable for JSON export
to_json([validate, ignore, context, indent, …]) Emit the JSON representation for this object as a string.
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_filter(filter, **kwargs) Add a FilterTransform to the schema.
transform_lookup([as_, from_, lookup, default]) Add a LookupTransform 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
validate(instance[, schema]) Validate the instance against the class schema in the context of the rootschema.
add_selection(*selections)

Add one or more selections to the chart

configure(area=Undefined, autosize=Undefined, axis=Undefined, axisBand=Undefined, axisBottom=Undefined, axisLeft=Undefined, axisRight=Undefined, axisTop=Undefined, axisX=Undefined, axisY=Undefined, background=Undefined, bar=Undefined, circle=Undefined, countTitle=Undefined, datasets=Undefined, fieldTitle=Undefined, geoshape=Undefined, header=Undefined, invalidValues=Undefined, legend=Undefined, line=Undefined, mark=Undefined, numberFormat=Undefined, padding=Undefined, point=Undefined, projection=Undefined, range=Undefined, rect=Undefined, rule=Undefined, scale=Undefined, selection=Undefined, square=Undefined, stack=Undefined, style=Undefined, text=Undefined, tick=Undefined, timeFormat=Undefined, title=Undefined, trail=Undefined, view=Undefined, **kwds)

Config schema wrapper

Mapping(required=[])

Attributes:
area : AreaConfig

Area-Specific Config

autosize : anyOf(AutosizeType, AutoSizeParams)

Sets 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. "fit" is only supported for single and layered views that don’t use rangeStep.

Default value : pad

axis : AxisConfig

Axis configuration, which determines default properties for all x and y axes. For a full list of axis configuration options, please see the corresponding section of the axis documentation.

axisBand : VgAxisConfig

Specific axis config for axes with “band” scales.

axisBottom : VgAxisConfig

Specific axis config for x-axis along the bottom edge of the chart.

axisLeft : VgAxisConfig

Specific axis config for y-axis along the left edge of the chart.

axisRight : VgAxisConfig

Specific axis config for y-axis along the right edge of the chart.

axisTop : VgAxisConfig

Specific axis config for x-axis along the top edge of the chart.

axisX : VgAxisConfig

X-axis specific config.

axisY : VgAxisConfig

Y-axis specific config.

background : string

CSS color property to use as the background of visualization.

Default value: none (transparent)

bar : BarConfig

Bar-Specific Config

circle : MarkConfig

Circle-Specific Config

countTitle : string

Default axis and legend title for count fields.

Default value: 'Number of Records'.

datasets : Datasets

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.

fieldTitle : enum(‘verbal’, ‘functional’, ‘plain’)

Defines how Vega-Lite generates title for fields. There are three possible styles:

  • "verbal" (Default) - displays function in a verbal style (e.g., “Sum of field”, “Year-month of date”, “field (binned)”).
  • "function" - displays function using parentheses and capitalized texts (e.g., “SUM(field)”, “YEARMONTH(date)”, “BIN(field)”).
  • "plain" - displays only the field name without functions (e.g., “field”, “date”, “field”).
geoshape : MarkConfig

Geoshape-Specific Config

header : HeaderConfig

Header configuration, which determines default properties for all header. For a full list of header configuration options, please see the corresponding section of in the header documentation.

invalidValues : enum(‘filter’, None)

Defines how Vega-Lite should handle invalid values ( null and NaN ).

  • If set to "filter" (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).
  • If null, all data items are included. In this case, invalid values will be interpreted as zeroes.
legend : LegendConfig

Legend configuration, which determines default properties for all legends. For a full list of legend configuration options, please see the corresponding section of in the legend documentation.

line : LineConfig

Line-Specific Config

mark : MarkConfig

Mark Config

numberFormat : string

D3 Number format for axis labels and text tables. For example “s” for SI units. Use D3’s number format pattern.

padding : Padding

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

point : MarkConfig

Point-Specific Config

projection : ProjectionConfig

Projection configuration, which determines default properties for all projections. For a full list of projection configuration options, please see the corresponding section of the projection documentation.

range : RangeConfig

An object hash that defines default range arrays or schemes for using with scales. For a full list of scale range configuration options, please see the corresponding section of the scale documentation.

rect : MarkConfig

Rect-Specific Config

rule : MarkConfig

Rule-Specific Config

scale : ScaleConfig

Scale configuration determines default properties for all scales. For a full list of scale configuration options, please see the corresponding section of the scale documentation.

selection : SelectionConfig

An object hash for defining default properties for each type of selections.

square : MarkConfig

Square-Specific Config

stack : StackOffset

Default stack offset for stackable mark.

style : StyleConfigIndex

An object hash that defines key-value mappings to determine default properties for marks with a given style. The keys represent styles names; the values have to be valid mark configuration objects.

text : TextConfig

Text-Specific Config

tick : TickConfig

Tick-Specific Config

timeFormat : string

Default datetime format for axis and legend labels. The format can be set directly on each axis and legend. Use D3’s time format pattern.

Default value: '' (The format will be automatically determined).

title : VgTitleConfig

Title configuration, which determines default properties for all titles. For a full list of title configuration options, please see the corresponding section of the title documentation.

trail : LineConfig

Trail-Specific Config

view : ViewConfig

Default properties for single view plots.

configure_area(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

AreaConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

line : anyOf(boolean, OverlayMarkDef)

A flag for overlaying line on top of area marks, or an object defining the properties of the overlayed lines.

If this value is an empty object ( {} ) or true, lines with default properties will be used.

If this value is false, no lines would be automatically added to area marks.

Default value: false.

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

point : anyOf(boolean, OverlayMarkDef, enum(‘transparent’))

A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.

If this property is "transparent", transparent points will be used (for enhancing tooltips and selections).

If this property is an empty object ( {} ) or true, filled points with default properties will be used.

If this property is false, no points would be automatically added to line or area marks.

Default value: false.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_axis(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, shortTimeLabels=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

AxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

shortTimeLabels : boolean

Whether month names and weekday names should be abbreviated.

Default value: false

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisBand(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisBottom(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisLeft(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisRight(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisTop(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisX(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_axisY(bandPosition=Undefined, domain=Undefined, domainColor=Undefined, domainWidth=Undefined, grid=Undefined, gridColor=Undefined, gridDash=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAngle=Undefined, labelBound=Undefined, labelColor=Undefined, labelFlush=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, tickColor=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, titleAlign=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleMaxLength=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, **kwds)

VgAxisConfig schema wrapper

Mapping(required=[])

Attributes:
bandPosition : float

An interpolation fraction indicating where, for band scales, axis ticks should be positioned. A value of 0 places ticks at the left edge of their bands. A value of 0.5 places ticks in the middle of their bands.

domain : boolean

A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.

Default value: true

domainColor : string

Color of axis domain line.

Default value: (none, using Vega default).

domainWidth : float

Stroke width of axis domain line

Default value: (none, using Vega default).

grid : boolean

A boolean flag indicating if grid lines should be included as part of the axis

Default value: true for continuous scales that are not binned; otherwise, false.

gridColor : string

Color of gridlines.

gridDash : List(float)

The offset (in pixels) into which to begin drawing with the grid dash array.

gridOpacity : float

The stroke opacity of grid (value between [0,1])

Default value: ( 1 by default)

gridWidth : float

The grid width, in pixels.

labelAngle : float

The rotation angle of the axis labels.

Default value: -90 for nominal and ordinal fields; 0 otherwise.

labelBound : anyOf(boolean, float)

Indicates if labels should be hidden if they exceed the axis range. If false (the default) no bounds overlap analysis is performed. If true, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.

Default value: false.

labelColor : string

The color of the tick label, can be in hex color code or regular color name.

labelFlush : anyOf(boolean, float)

Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.

Default value: true for axis of a continuous x-scale. Otherwise, false.

labelFont : string

The font of the tick label.

labelFontSize : float

The font size of the label, in pixels.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOverlap : anyOf(boolean, enum(‘parity’), enum(‘greedy’))

The strategy to use for resolving overlap of axis labels. If false (the default), no overlap reduction is attempted. If set to true or "parity", a strategy of removing every other label is used (this works well for standard linear axes). If set to "greedy", a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).

Default value: true for non-nominal fields with non-log scales; "greedy" for log scales; otherwise false.

labelPadding : float

The padding, in pixels, between axis and text labels.

labels : boolean

A boolean flag indicating if labels should be included as part of the axis.

Default value: true.

maxExtent : float

The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.

Default value: undefined.

minExtent : float

The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.

Default value: 30 for y-axis; undefined for x-axis.

tickColor : string

The color of the axis’s tick.

tickRound : boolean

Boolean flag indicating if pixel position values should be rounded to the nearest integer.

tickSize : float

The size in pixels of axis ticks.

tickWidth : float

The width, in pixels, of ticks.

ticks : boolean

Boolean value that determines whether the axis should include ticks.

titleAlign : string

Horizontal text alignment of axis titles.

titleAngle : float

Angle in degrees of axis titles.

titleBaseline : string

Vertical text baseline for axis titles.

titleColor : string

Color of the title, can be in hex color code or regular color name.

titleFont : string

Font of the title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the title.

titleFontWeight : FontWeight

Font weight of the title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titleMaxLength : float

Max length for axis title if the title is automatically generated from the field’s description.

titlePadding : float

The padding, in pixels, between title and axis.

titleX : float

X-coordinate of the axis title relative to the axis group.

titleY : float

Y-coordinate of the axis title relative to the axis group.

configure_bar(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, color=Undefined, continuousBandSize=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, discreteBandSize=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

BarConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

binSpacing : float

Offset between bars for binned field. Ideal value for this is either 0 (Preferred by statisticians) or 1 (Vega-Lite Default, D3 example style).

Default value: 1

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

continuousBandSize : float

The default size of the bars on continuous scales.

Default value: 5

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

discreteBandSize : float

The size of the bars. If unspecified, the default size is bandSize-1, which provides 1 pixel offset between bars.

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_circle(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_geoshape(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_header(labelAngle=Undefined, labelColor=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, titleAnchor=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, **kwds)

HeaderConfig schema wrapper

Mapping(required=[])

Attributes:
labelAngle : float

The rotation angle of the header labels.

Default value: 0.

labelColor : string

The color of the header label, can be in hex color code or regular color name.

labelFont : string

The font of the header label.

labelFontSize : float

The font size of the header label, in pixels.

labelLimit : float

The maximum length of the header label in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

titleAnchor : string

The anchor position for placing the title. One of "start", "middle", or "end". For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title.

Default value: "middle" for single and layered views. "start" for other composite views.

Note: For now, anchor is only customizable only for single and layered views. For other composite views, anchor is always "start".

titleAngle : float

The rotation angle of the header title.

Default value: 0.

titleBaseline : TextBaseline

Vertical text baseline for the header title. One of "top", "bottom", "middle".

Default value: "middle"

titleColor : string

Color of the header title, can be in hex color code or regular color name.

titleFont : string

Font of the header title. (e.g., "Helvetica Neue" ).

titleFontSize : float

Font size of the header title.

titleFontWeight : FontWeight

Font weight of the header title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

The maximum length of the header title in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

configure_legend(cornerRadius=Undefined, entryPadding=Undefined, fillColor=Undefined, gradientHeight=Undefined, gradientLabelBaseline=Undefined, gradientLabelLimit=Undefined, gradientLabelOffset=Undefined, gradientStrokeColor=Undefined, gradientStrokeWidth=Undefined, gradientWidth=Undefined, labelAlign=Undefined, labelBaseline=Undefined, labelColor=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelLimit=Undefined, labelOffset=Undefined, offset=Undefined, orient=Undefined, padding=Undefined, shortTimeLabels=Undefined, strokeColor=Undefined, strokeDash=Undefined, strokeWidth=Undefined, symbolColor=Undefined, symbolSize=Undefined, symbolStrokeWidth=Undefined, symbolType=Undefined, titleAlign=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titlePadding=Undefined, **kwds)

LegendConfig schema wrapper

Mapping(required=[])

Attributes:
cornerRadius : float

Corner radius for the full legend.

entryPadding : float

Padding (in pixels) between legend entries in a symbol legend.

fillColor : string

Background fill color for the full legend.

gradientHeight : float

The height of the gradient, in pixels.

gradientLabelBaseline : string

Text baseline for color ramp gradient labels.

gradientLabelLimit : float

The maximum allowed length in pixels of color ramp gradient labels.

gradientLabelOffset : float

Vertical offset in pixels for color ramp gradient labels.

gradientStrokeColor : string

The color of the gradient stroke, can be in hex color code or regular color name.

gradientStrokeWidth : float

The width of the gradient stroke, in pixels.

gradientWidth : float

The width of the gradient, in pixels.

labelAlign : string

The alignment of the legend label, can be left, middle or right.

labelBaseline : string

The position of the baseline of legend label, can be top, middle or bottom.

labelColor : string

The color of the legend label, can be in hex color code or regular color name.

labelFont : string

The font of the legend label.

labelFontSize : float

The font size of legend label.

Default value: 10.

labelLimit : float

Maximum allowed pixel width of axis tick labels.

labelOffset : float

The offset of the legend label.

offset : float

The offset, in pixels, by which to displace the legend from the edge of the enclosing group or data rectangle.

Default value: 0

orient : LegendOrient

The orientation of the legend, which determines how the legend is positioned within the scene. One of “left”, “right”, “top-left”, “top-right”, “bottom-left”, “bottom-right”, “none”.

Default value: "right"

padding : float

The padding, in pixels, between the legend and axis.

shortTimeLabels : boolean

Whether month names and weekday names should be abbreviated.

Default value: false

strokeColor : string

Border stroke color for the full legend.

strokeDash : List(float)

Border stroke dash pattern for the full legend.

strokeWidth : float

Border stroke width for the full legend.

symbolColor : string

The color of the legend symbol,

symbolSize : float

The size of the legend symbol, in pixels.

symbolStrokeWidth : float

The width of the symbol’s stroke.

symbolType : string

Default shape type (such as “circle”) for legend symbols.

titleAlign : string

Horizontal text alignment for legend titles.

titleBaseline : string

Vertical text baseline for legend titles.

titleColor : string

The color of the legend title, can be in hex color code or regular color name.

titleFont : string

The font of the legend title.

titleFontSize : float

The font size of the legend title.

titleFontWeight : FontWeight

The font weight of the legend title. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

titleLimit : float

Maximum allowed pixel width of axis titles.

titlePadding : float

The padding, in pixels, between title and legend.

configure_line(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

LineConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

point : anyOf(boolean, OverlayMarkDef, enum(‘transparent’))

A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.

If this property is "transparent", transparent points will be used (for enhancing tooltips and selections).

If this property is an empty object ( {} ) or true, filled points with default properties will be used.

If this property is false, no points would be automatically added to line or area marks.

Default value: false.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_mark(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_point(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_projection(center=Undefined, clipAngle=Undefined, clipExtent=Undefined, coefficient=Undefined, distance=Undefined, fraction=Undefined, lobes=Undefined, parallel=Undefined, precision=Undefined, radius=Undefined, ratio=Undefined, rotate=Undefined, spacing=Undefined, tilt=Undefined, type=Undefined, **kwds)

ProjectionConfig schema wrapper

Mapping(required=[]) Any property of Projection can be in config

Attributes:
center : List(float)

Sets the projection’s center to the specified center, a two-element array of longitude and latitude in degrees.

Default value: [0, 0]

clipAngle : float

Sets the projection’s clipping circle radius to the specified angle in degrees. If null, switches to antimeridian cutting rather than small-circle clipping.

clipExtent : List(List(float))

Sets the projection’s viewport clip extent to the specified bounds in pixels. The extent bounds are specified as an array [[x0, y0], [x1, y1]], where x0 is the left-side of the viewport, y0 is the top, x1 is the right and y1 is the bottom. If null, no viewport clipping is performed.

coefficient : float
distance : float
fraction : float
lobes : float
parallel : float
precision : Mapping(required=[length])

Sets the threshold for the projection’s adaptive resampling to the specified value in pixels. This value corresponds to the Douglas–Peucker distance. If precision is not specified, returns the projection’s current resampling precision which defaults to √0.5 0.70710….

radius : float
ratio : float
rotate : List(float)

Sets the projection’s three-axis rotation to the specified angles, which must be a two- or three-element array of numbers [ lambda, phi, gamma ] specifying the rotation angles in degrees about each spherical axis. (These correspond to yaw, pitch and roll.)

Default value: [0, 0, 0]

spacing : float
tilt : float
type : ProjectionType

The cartographic projection to use. This value is case-insensitive, for example "albers" and "Albers" indicate the same projection type. You can find all valid projection types in the documentation.

Default value: mercator

configure_range(category=Undefined, diverging=Undefined, heatmap=Undefined, ordinal=Undefined, ramp=Undefined, symbol=Undefined, **kwds)

RangeConfig schema wrapper

Mapping(required=[])

Attributes:
category : anyOf(List(string), VgScheme)

Default range for nominal (categorical) fields.

diverging : anyOf(List(string), VgScheme)

Default range for diverging quantitative fields.

heatmap : anyOf(List(string), VgScheme)

Default range for quantitative heatmaps.

ordinal : anyOf(List(string), VgScheme)

Default range for ordinal fields.

ramp : anyOf(List(string), VgScheme)

Default range for quantitative and temporal fields.

symbol : List(string)

Default range palette for the shape channel.

configure_rect(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_rule(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_scale(bandPaddingInner=Undefined, bandPaddingOuter=Undefined, clamp=Undefined, continuousPadding=Undefined, maxBandSize=Undefined, maxFontSize=Undefined, maxOpacity=Undefined, maxSize=Undefined, maxStrokeWidth=Undefined, minBandSize=Undefined, minFontSize=Undefined, minOpacity=Undefined, minSize=Undefined, minStrokeWidth=Undefined, pointPadding=Undefined, rangeStep=Undefined, round=Undefined, textXRangeStep=Undefined, useUnaggregatedDomain=Undefined, **kwds)

ScaleConfig schema wrapper

Mapping(required=[])

Attributes:
bandPaddingInner : float

Default inner padding for x and y band-ordinal scales.

Default value: 0.1

bandPaddingOuter : float

Default outer padding for x and y band-ordinal scales. If not specified, by default, band scale’s paddingOuter is paddingInner/2.

clamp : boolean

If true, values that exceed the data domain are clamped to either the minimum or maximum range value

continuousPadding : float

Default padding for continuous scales.

Default: 5 for continuous x-scale of a vertical bar and continuous y-scale of a horizontal bar.; 0 otherwise.

maxBandSize : float

The default max value for mapping quantitative fields to bar’s size/bandSize.

If undefined (default), we will use the scale’s rangeStep - 1.

maxFontSize : float

The default max value for mapping quantitative fields to text’s size/fontSize.

Default value: 40

maxOpacity : float

Default max opacity for mapping a field to opacity.

Default value: 0.8

maxSize : float

Default max value for point size scale.

maxStrokeWidth : float

Default max strokeWidth for the scale of strokeWidth for rule and line marks and of size for trail marks.

Default value: 4

minBandSize : float

The default min value for mapping quantitative fields to bar and tick’s size/bandSize scale with zero=false.

Default value: 2

minFontSize : float

The default min value for mapping quantitative fields to tick’s size/fontSize scale with zero=false

Default value: 8

minOpacity : float

Default minimum opacity for mapping a field to opacity.

Default value: 0.3

minSize : float

Default minimum value for point size scale with zero=false.

Default value: 9

minStrokeWidth : float

Default minimum strokeWidth for the scale of strokeWidth for rule and line marks and of size for trail marks with zero=false.

Default value: 1

pointPadding : float

Default outer padding for x and y point-ordinal scales.

Default value: 0.5

rangeStep : anyOf(float, None)

Default range step for band and point scales of (1) the y channel and (2) the x channel when the mark is not text.

Default value: 21

round : boolean

If true, rounds numeric output values to integers. This can be helpful for snapping to the pixel grid. (Only available for x, y, and size scales.)

textXRangeStep : float

Default range step for x band and point scales of text marks.

Default value: 90

useUnaggregatedDomain : boolean

Use the source data range before aggregation as scale domain instead of aggregated data for aggregate axis.

This is equivalent to setting domain to "unaggregate" for aggregated quantitative fields by default.

This property only works with aggregate functions that produce values within the raw data domain ( "mean", "average", "median", "q1", "q3", "min", "max" ). For other aggregations that produce values outside of the raw data domain (e.g. "count", "sum" ), this property is ignored.

Default value: false

configure_selection(interval=Undefined, multi=Undefined, single=Undefined, **kwds)

SelectionConfig schema wrapper

Mapping(required=[])

Attributes:
interval : IntervalSelectionConfig

The default definition for an interval selection. All properties and transformations for an interval selection definition (except type ) may be specified here.

For instance, setting interval to {"translate": false} disables the ability to move interval selections by default.

multi : MultiSelectionConfig

The default definition for a multi selection. All properties and transformations for a multi selection definition (except type ) may be specified here.

For instance, setting multi to {"toggle": "event.altKey"} adds additional values to multi selections when clicking with the alt-key pressed by default.

single : SingleSelectionConfig

The default definition for a single selection. All properties and transformations for a single selection definition (except type ) may be specified here.

For instance, setting single to {"on": "dblclick"} populates single selections on double-click by default.

configure_square(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

MarkConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_text(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, shortTimeLabels=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

TextConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

shortTimeLabels : boolean

Whether month names and weekday names should be abbreviated.

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_tick(align=Undefined, angle=Undefined, bandSize=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, **kwds)

TickConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

bandSize : float

The width of the ticks.

Default value: 2/3 of rangeStep.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

thickness : float

Thickness of the tick mark.

Default value: 1

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_title(anchor=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, font=Undefined, fontSize=Undefined, fontWeight=Undefined, limit=Undefined, offset=Undefined, orient=Undefined, **kwds)

VgTitleConfig schema wrapper

Mapping(required=[])

Attributes:
anchor : Anchor

The anchor position for placing the title. One of "start", "middle", or "end". For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title.

Default value: "middle" for single and layered views. "start" for other composite views.

Note: For now, anchor is only customizable only for single and layered views. For other composite views, anchor is always "start".

angle : float

Angle in degrees of title text.

baseline : VerticalAlign

Vertical text baseline for title text.

color : string

Text color for title text.

font : string

Font name for title text.

fontSize : float

Font size in pixels for title text.

Default value: 10.

fontWeight : FontWeight

Font weight for title text. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

limit : float

The maximum allowed length in pixels of legend labels.

offset : float

Offset in pixels of the title from the chart body and axes.

orient : TitleOrient

Default title orientation (“top”, “bottom”, “left”, or “right”)

configure_trail(align=Undefined, angle=Undefined, baseline=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, tooltip=Undefined, **kwds)

LineConfig schema wrapper

Mapping(required=[])

Attributes:
align : HorizontalAlign

The horizontal alignment of the text. One of "left", "right", "center".

angle : float

The rotation angle of the text, in degrees.

baseline : VerticalAlign

The vertical alignment of the text. One of "top", "middle", "bottom".

Default value: "middle"

color : string

Default color. Note that fill and stroke have higher precedence than color and will override color.

Default value: "#4682b4"

Note: This property cannot be used in a style config.

cornerRadius : float

The radius in pixels of rounded rectangle corners.

Default value: 0

cursor : Cursor

The mouse cursor used over the mark. Any valid CSS cursor type can be used.

dir : Dir

The direction of the text. One of "ltr" (left-to-right) or "rtl" (right-to-left). This property determines on which side is truncated in response to the limit parameter.

Default value: "ltr"

dx : float

The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

dy : float

The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the angle property.

ellipsis : string

The ellipsis string for text truncated in response to the limit parameter.

Default value: "…"

fill : string

Default Fill Color. This has higher precedence than config.color

Default value: (None)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: 1

filled : boolean

Whether the mark’s color should be used as fill color instead of stroke color.

Default value: true for all marks except point and false for point.

Applicable for: bar, point, circle, square, and area marks.

Note: This property cannot be used in a style config.

font : string

The typeface to set the text in (e.g., "Helvetica Neue" ).

fontSize : float

The font size, in pixels.

fontStyle : FontStyle

The font style (e.g., "italic" ).

fontWeight : FontWeight

The font weight. This can be either a string (e.g "bold", "normal" ) or a number ( 100, 200, 300, …, 900 where "normal" = 400 and "bold" = 700 ).

href : string

A URL to load upon mouse click. If defined, the mark acts as a hyperlink.

interpolate : Interpolate

The line interpolation method to use for line and area marks. One of the following:

  • "linear" : piecewise linear segments, as in a polyline.
  • "linear-closed" : close the linear segments to form a polygon.
  • "step" : alternate between horizontal and vertical segments, as in a step function.
  • "step-before" : alternate between vertical and horizontal segments, as in a step function.
  • "step-after" : alternate between horizontal and vertical segments, as in a step function.
  • "basis" : a B-spline, with control point duplication on the ends.
  • "basis-open" : an open B-spline; may not intersect the start or end.
  • "basis-closed" : a closed B-spline, as in a loop.
  • "cardinal" : a Cardinal spline, with control point duplication on the ends.
  • "cardinal-open" : an open Cardinal spline; may not intersect the start or end, but will intersect other control points.
  • "cardinal-closed" : a closed Cardinal spline, as in a loop.
  • "bundle" : equivalent to basis, except the tension parameter is used to straighten the spline.
  • "monotone" : cubic interpolation that preserves monotonicity in y.
limit : float

The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.

Default value: 0, indicating no limit

opacity : float

The overall opacity (value between [0,1]).

Default value: 0.7 for non-aggregate plots with point, tick, circle, or square marks or layered bar charts and 1 otherwise.

orient : Orient

The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.

  • For bar, rule and tick, this determines whether the size of the bar and tick

should be applied to x or y dimension. * For area, this property determines the orient property of the Vega output. * For line and trail marks, this property determines the sort order of the points in

the line

if config.sortLineBy is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored.

point : anyOf(boolean, OverlayMarkDef, enum(‘transparent’))

A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.

If this property is "transparent", transparent points will be used (for enhancing tooltips and selections).

If this property is an empty object ( {} ) or true, filled points with default properties will be used.

If this property is false, no points would be automatically added to line or area marks.

Default value: false.

radius : float

Polar coordinate radial offset, in pixels, of the text label from the origin determined by the x and y properties.

shape : string

The default symbol shape to use. One of: "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or a custom SVG path.

Default value: "circle"

size : float

The pixel area each the point/circle/square. For example: in the case of circles, the radius is determined in part by the square root of the size value.

Default value: 30

stroke : string

Default Stroke Color. This has higher precedence than config.color

Default value: (None)

strokeCap : StrokeCap

The stroke cap for line ending style. One of "butt", "round", or "square".

Default value: "square"

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

strokeJoin : StrokeJoin

The stroke line join method. One of "miter", "round" or "bevel".

Default value: "miter"

strokeMiterLimit : float

The miter limit at which to bevel a line join.

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: 1

strokeWidth : float

The stroke width, in pixels.

tension : float

Depending on the interpolation type, sets the tension parameter (for line and area marks).

text : string

Placeholder text if the text channel is not specified

theta : float

Polar coordinate angle, in radians, of the text label from the origin determined by the x and y properties. Values for theta follow the same convention of arc mark startAngle and endAngle properties: angles are measured in radians, with 0 indicating “north”.

tooltip : Mapping(required=[])

The tooltip text to show upon mouse hover.

configure_view(clip=Undefined, fill=Undefined, fillOpacity=Undefined, height=Undefined, stroke=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, width=Undefined, **kwds)

ViewConfig schema wrapper

Mapping(required=[])

Attributes:
clip : boolean

Whether the view should be clipped.

fill : string

The fill color.

Default value: (none)

fillOpacity : float

The fill opacity (value between [0,1]).

Default value: (none)

height : float

The default height of the single plot or each plot in a trellis plot when the visualization has a continuous (non-ordinal) y-scale with rangeStep = null.

Default value: 200

stroke : string

The stroke color.

Default value: (none)

strokeDash : List(float)

An array of alternating stroke, space lengths for creating dashed or dotted lines.

Default value: (none)

strokeDashOffset : float

The offset (in pixels) into which to begin drawing with the stroke dash array.

Default value: (none)

strokeJoin : StrokeJoin

The stroke line join method. One of miter (default), round or bevel.

Default value: ‘miter’

strokeMiterLimit : float

The stroke line join method. One of miter (default), round or bevel.

Default value: ‘miter’

strokeOpacity : float

The stroke opacity (value between [0,1]).

Default value: (none)

strokeWidth : float

The stroke width, in pixels.

Default value: (none)

width : float

The default width of the single plot or each plot in a trellis plot when the visualization has a continuous (non-ordinal) x-scale or ordinal x-scale with rangeStep = null.

Default value: 200

copy(deep=True, ignore=())

Return a copy of the object

Parameters:
deep : boolean, optional

if True (default) then return a deep copy of all dict, list, and SchemaBase objects within the object structure

ignore : list, optional

A list of keys for which the contents should not be copied, but only stored by reference.

display(renderer=Undefined, theme=Undefined, actions=Undefined, **kwargs)

Display chart in Jupyter notebook or JupyterLab

Parameters are passed as options to vega-embed within supported frontends. See https://github.com/vega/vega-embed#options for details.

Parameters:
renderer : string (‘canvas’ or ‘svg’)

The renderer to use

theme : string

The Vega theme name to use; see https://github.com/vega/vega-themes

actions : bool or dict

Specify whether action links (“Open In Vega Editor”, etc.) are included in the view.

**kwargs :

Additional parameters are also passed to vega-embed as options.

encode(color=Undefined, column=Undefined, detail=Undefined, fill=Undefined, href=Undefined, key=Undefined, latitude=Undefined, latitude2=Undefined, longitude=Undefined, longitude2=Undefined, opacity=Undefined, order=Undefined, row=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, text=Undefined, tooltip=Undefined, x=Undefined, x2=Undefined, y=Undefined, y2=Undefined, **kwds)

EncodingWithFacet schema wrapper

Mapping(required=[])

Attributes:
color : anyOf(MarkPropFieldDefWithCondition,
:class:`MarkPropValueDefWithCondition`)

Color of the marks – either fill or stroke color based on the filled property of mark definition. By default, color represents fill color for "area", "bar", "tick", "text", "trail", "circle", and "square" / stroke color for "line" and "point".

Default value: If undefined, the default color depends on mark config ‘s color property.

Note: 1) For fine-grained control over both fill and stroke colors of the marks, please use the fill and stroke channels. If either fill or stroke channel is specified, color channel will be ignored. 2) See the scale documentation for more information about customizing color scheme.

column : FacetFieldDef

Horizontal facets for trellis plots.

detail : anyOf(FieldDef, List(FieldDef))

Additional levels of detail for grouping data in aggregate views and in line, trail, and area marks without mapping data to a specific visual channel.

fill : anyOf(MarkPropFieldDefWithCondition, MarkPropValueDefWithCondition)

Fill color of the marks. Default value: If undefined, the default color depends on mark config ‘s color property.

Note: When using fill channel, color channel will be ignored. To customize both fill and stroke, please use fill and stroke channels (not fill and color ).

href : anyOf(FieldDefWithCondition, ValueDefWithCondition)

A URL to load upon mouse click.

key : FieldDef

A data field to use as a unique key for data binding. When a visualization’s data is updated, the key value will be used to match data elements to existing mark instances. Use a key channel to enable object constancy for transitions over dynamic data.

latitude : FieldDef

Latitude position of geographically projected marks.

latitude2 : FieldDef

Latitude-2 position for geographically projected ranged "area", "bar", "rect", and "rule".

longitude : FieldDef

Longitude position of geographically projected marks.

longitude2 : FieldDef

Longitude-2 position for geographically projected ranged "area", "bar", "rect", and "rule".

opacity : anyOf(MarkPropFieldDefWithCondition,
:class:`MarkPropValueDefWithCondition`)

Opacity of the marks – either can be a value or a range.

Default value: If undefined, the default opacity depends on mark config ‘s opacity property.

order : anyOf(OrderFieldDef, List(OrderFieldDef), ValueDef)

Order of the marks.

  • For stacked marks, this order channel encodes stack order.
  • For line and trail marks, this order channel encodes order of data points in the lines. This can be useful for creating a connected scatterplot. Setting order to {"value": null} makes the line marks use the original order in the data sources.
  • Otherwise, this order channel encodes layer order of the marks.

Note : In aggregate plots, order field should be aggregate d to avoid creating additional aggregation grouping.

row : FacetFieldDef

Vertical facets for trellis plots.

shape : anyOf(MarkPropFieldDefWithCondition,
:class:`MarkPropValueDefWithCondition`)

For point marks the supported values are "circle" (default), "square", "cross", "diamond", "triangle-up", or "triangle-down", or else a custom SVG path string. For geoshape marks it should be a field definition of the geojson data

Default value: If undefined, the default shape depends on mark config ‘s shape property.

size : anyOf(MarkPropFieldDefWithCondition, MarkPropValueDefWithCondition)

Size of the mark.

  • For "point", "square" and "circle", – the symbol size, or pixel area of the mark.
  • For "bar" and "tick" – the bar and tick’s size.
  • For "text" – the text’s font size.
  • Size is unsupported for "line", "area", and "rect". (Use "trail" instead of line with varying size)
stroke : anyOf(MarkPropFieldDefWithCondition,
:class:`MarkPropValueDefWithCondition`)

Stroke color of the marks. Default value: If undefined, the default color depends on mark config ‘s color property.

Note: When using stroke channel, color channel will be ignored. To customize both stroke and fill, please use stroke and fill channels (not stroke and color ).

text : anyOf(TextFieldDefWithCondition, TextValueDefWithCondition)

Text of the text mark.

tooltip : anyOf(TextFieldDefWithCondition, TextValueDefWithCondition,
List(:class:`TextFieldDef`))

The tooltip text to show upon mouse hover.

x : anyOf(PositionFieldDef, ValueDef)

X coordinates of the marks, or width of horizontal "bar" and "area".

x2 : anyOf(FieldDef, ValueDef)

X2 coordinates for ranged "area", "bar", "rect", and "rule".

y : anyOf(PositionFieldDef, ValueDef)

Y coordinates of the marks, or height of vertical "bar" and "area".

y2 : anyOf(FieldDef, ValueDef)

Y2 coordinates for ranged "area", "bar", "rect", and "rule".

facet(row=Undefined, column=Undefined, data=Undefined, **kwargs)

Create a facet chart from the current chart.

Faceted charts require data to be specified at the top level; if data is not specified, the data from the current chart will be used at the top level.

classmethod from_dict(dct, validate=True)

Construct class from a dictionary representation

Parameters:
dct : dictionary

The dict from which to construct the class

validate : boolean

If True (default), then validate the input against the schema.

Returns:
obj : Chart object

The wrapped schema

Raises:
jsonschema.ValidationError :

if validate=True and dct does not conform to the schema

from_json(json_string, validate=True, **kwargs)

Instantiate the object from a valid JSON string

Parameters:
json_string : string

The string containing a valid JSON chart specification.

validate : boolean

If True (default), then validate the input against the schema.

**kwargs :

Additional keyword arguments are passed to json.loads

Returns:
chart : Chart object

The altair Chart object built from the specification.

interactive(name=None, bind_x=True, bind_y=True)

Make chart axes scales interactive

Parameters:
name : string

The selection name to use for the axes scales. This name should be unique among all selections within the chart.

bind_x : boolean, default True

If true, then bind the interactive scales to the x-axis

bind_y : boolean, default True

If true, then bind the interactive scales to the y-axis

Returns:
chart :

copy of self, with interactive axes added

mark_area(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘area’

For information on additional arguments, see alt.MarkDef

mark_bar(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘bar’

For information on additional arguments, see alt.MarkDef

mark_circle(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘circle’

For information on additional arguments, see alt.MarkDef

mark_geoshape(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘geoshape’

For information on additional arguments, see alt.MarkDef

mark_line(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘line’

For information on additional arguments, see alt.MarkDef

mark_point(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘point’

For information on additional arguments, see alt.MarkDef

mark_rect(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘rect’

For information on additional arguments, see alt.MarkDef

mark_rule(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘rule’

For information on additional arguments, see alt.MarkDef

mark_square(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘square’

For information on additional arguments, see alt.MarkDef

mark_text(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘text’

For information on additional arguments, see alt.MarkDef

mark_tick(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘tick’

For information on additional arguments, see alt.MarkDef

mark_trail(align=Undefined, angle=Undefined, baseline=Undefined, binSpacing=Undefined, clip=Undefined, color=Undefined, cornerRadius=Undefined, cursor=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, href=Undefined, interpolate=Undefined, limit=Undefined, line=Undefined, opacity=Undefined, orient=Undefined, point=Undefined, radius=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, thickness=Undefined, tooltip=Undefined, x2Offset=Undefined, xOffset=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)

Set the chart’s mark to ‘trail’

For information on additional arguments, see alt.MarkDef

project(type='mercator', center=Undefined, clipAngle=Undefined, clipExtent=Undefined, coefficient=Undefined, distance=Undefined, fraction=Undefined, lobes=Undefined, parallel=Undefined, precision=Undefined, radius=Undefined, ratio=Undefined, rotate=Undefined, spacing=Undefined, tilt=Undefined, **kwds)

Add a geographic projection to the chartself.

This is generally used either with mark_geoshape or with the latitude/longitude encodings.

Available projection types are [‘albers’, ‘albersUsa’, ‘azimuthalEqualArea’, ‘azimuthalEquidistant’, ‘conicConformal’, ‘conicEqualArea’, ‘conicEquidistant’, ‘equirectangular’, ‘gnomonic’, ‘mercator’, ‘orthographic’, ‘stereographic’, ‘transverseMercator’]

Attributes:
type : ProjectionType

The cartographic projection to use. This value is case-insensitive, for example “albers” and “Albers” indicate the same projection type. You can find all valid projection types [in the documentation](https://vega.github.io/vega-lite/docs/projection.html#projection-types).

Default value: mercator

center : List(float)

Sets the projection’s center to the specified center, a two-element array of longitude and latitude in degrees.

Default value: [0, 0]

clipAngle : float

Sets the projection’s clipping circle radius to the specified angle in degrees. If null, switches to [antimeridian](http://bl.ocks.org/mbostock/3788999) cutting rather than small-circle clipping.

clipExtent : List(List(float))

Sets the projection’s viewport clip extent to the specified bounds in pixels. The extent bounds are specified as an array [[x0, y0], [x1, y1]], where x0 is the left-side of the viewport, y0 is the top, x1 is the right and y1 is the bottom. If null, no viewport clipping is performed.

coefficient : float
distance : float
fraction : float
lobes : float
parallel : float
precision : Mapping(required=[length])

Sets the threshold for the projection’s [adaptive resampling](http://bl.ocks.org/mbostock/3795544) to the specified value in pixels. This value corresponds to the [Douglas–Peucker distance](http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm).

If precision is not specified, returns the projection’s current resampling

precision which defaults to √0.5 ≅ 0.70710….

radius : float
ratio : float
rotate : List(float)

Sets the projection’s three-axis rotation to the specified angles, which must be a two- or three-element array of numbers [lambda, phi, gamma] specifying the rotation angles in degrees about each spherical axis. (These correspond to yaw, pitch and roll.)

Default value: [0, 0, 0]

spacing : float
tilt : float
properties(**kwargs)

Set top-level properties of the Chart.

Argument names and types are the same as class initialization.

repeat(row=Undefined, column=Undefined, **kwargs)

Return a RepeatChart built from the chart

Fields within the chart can be set to correspond to the row or column using alt.repeat(‘row’) and alt.repeat(‘column’).

Parameters:
row : list

a list of data column names to be mapped to the row facet

column : list

a list of data column names to be mapped to the column facet

Returns:
chart : RepeatChart

a repeated chart.

resolve_axis(x=Undefined, y=Undefined, **kwds)

AxisResolveMap schema wrapper

Mapping(required=[])

Attributes:
x : ResolveMode
y : ResolveMode
resolve_legend(color=Undefined, fill=Undefined, opacity=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, **kwds)

LegendResolveMap schema wrapper

Mapping(required=[])

Attributes:
color : ResolveMode
fill : ResolveMode
opacity : ResolveMode
shape : ResolveMode
size : ResolveMode
stroke : ResolveMode
resolve_references(schema)

Resolve references of the schema the context of this object’s schema

resolve_scale(color=Undefined, fill=Undefined, opacity=Undefined, shape=Undefined, size=Undefined, stroke=Undefined, x=Undefined, y=Undefined, **kwds)

ScaleResolveMap schema wrapper

Mapping(required=[])

Attributes:
color : ResolveMode
fill : ResolveMode
opacity : ResolveMode
shape : ResolveMode
size : ResolveMode
stroke : ResolveMode
x : ResolveMode
y : ResolveMode
save(fp, format=None, override_data_transformer=True, scale_factor=1.0, vegalite_version='2.6.0', vega_version='3.3.1', vegaembed_version='3.14', **kwargs)

Save a chart to file in a variety of formats

Supported formats are json, html, png, svg

Parameters:
fp : string filename or file-like object

file in which to write the chart.

format : string (optional)

the format to write: one of [‘json’, ‘html’, ‘png’, ‘svg’]. If not specified, the format will be determined from the filename.

override_data_transformer : boolean (optional)

If True (default), then the save action will be done with the default data_transformer with max_rows set to None. If False, then use the currently active data transformer.

scale_factor : float

For svg or png formats, scale the image by this factor when saving. This can be used to control the size or resolution of the output. Default is 1.0

**kwargs :

Additional keyword arguments are passed to the output method associated with the specified format.

savechart(fp, format=None, **kwargs)

Save a chart to file in a variety of formats

Supported formats are json, html, png, svg

Parameters:
fp : string filename or file-like object

file in which to write the chart.

format : string (optional)

the format to write: one of [‘json’, ‘html’, ‘png’, ‘svg’]. If not specified, the format will be determined from the filename.

**kwargs :

Additional keyword arguments are passed to the output method associated with the specified format.

serve(ip='127.0.0.1', port=8888, n_retries=50, files=None, jupyter_warning=True, open_browser=True, http_server=None, **kwargs)

Open a browser window and display a rendering of the chart

Parameters:
html : string

HTML to serve

ip : string (default = ‘127.0.0.1’)

ip address at which the HTML will be served.

port : int (default = 8888)

the port at which to serve the HTML

n_retries : int (default = 50)

the number of nearby ports to search if the specified port is already in use.

files : dictionary (optional)

dictionary of extra content to serve

jupyter_warning : bool (optional)

if True (default), then print a warning if this is used within the Jupyter notebook

open_browser : bool (optional)

if True (default), then open a web browser to the given HTML

http_server : class (optional)

optionally specify an HTTPServer class to use for showing the figure. The default is Python’s basic HTTPServer.

**kwargs :

additional keyword arguments passed to the save() method

to_dict(*args, **kwargs)

Convert the chart to a dictionary suitable for JSON export

to_json(validate=True, ignore=[], context={}, indent=2, sort_keys=True, **kwargs)

Emit the JSON representation for this object as a string.

Parameters:
validate : boolean or string

If True (default), then validate the output dictionary against the schema. If “deep” then recursively validate all objects in the spec. This takes much more time, but it results in friendlier tracebacks for large objects.

ignore : list

A list of keys to ignore. This will not passed to child to_dict function calls.

context : dict (optional)

A context dictionary that will be passed to all child to_dict function calls

indent : integer, default 2

the number of spaces of indentation to use

sort_keys : boolean, default True

if True, sort keys in the output

**kwargs

Additional keyword arguments are passed to json.dumps()

Returns:
spec : string

The JSON specification of the chart object.

transform_aggregate(aggregate=Undefined, groupby=Undefined, **kwds)

Add an AggregateTransform to the schema.

Parameters:
aggregate : List(AggregatedFieldDef)

Array of objects that define fields to aggregate.

groupby : List(string)

The data fields to group by. If not specified, a single group containing all data objects will be used.

**kwds :

additional keywords are converted to aggregates using standard shorthand parsing.

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.AggregateTransform
underlying transform object

Examples

The aggregate transform allows you to specify transforms directly using the same shorthand syntax as used in encodings:

>>> import altair as alt
>>> chart1 = alt.Chart().transform_aggregate(
...     mean_acc='mean(Acceleration)',
...     groupby=['Origin']
... )
>>> print(chart1.transform[0].to_json())  
{
  "aggregate": [
    {
      "as": "mean_acc",
      "field": "Acceleration",
      "op": "mean"
    }
  ],
  "groupby": [
    "Origin"
  ]
}

It also supports including AggregatedFieldDef instances or dicts directly, so you can create the above transform like this:

>>> chart2 = alt.Chart().transform_aggregate(
...     [alt.AggregatedFieldDef(field='Acceleration', op='mean',
...                             **{'as': 'mean_acc'})],
...     groupby=['Origin']
... )
>>> chart2.transform == chart1.transform
True
transform_bin(as_=Undefined, field=Undefined, bin=True, **kwargs)

Add a BinTransform to the schema.

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.BinTransform
underlying transform object

Examples

>>> import altair as alt
>>> chart = alt.Chart().transform_bin("x_binned", "x")
>>> chart.transform[0]
BinTransform({
  as: 'x_binned',
  bin: True,
  field: 'x'
})
>>> chart = alt.Chart().transform_bin("x_binned", "x",
...                                   bin=alt.Bin(maxbins=10))
>>> chart.transform[0]
BinTransform({
  as: 'x_binned',
  bin: BinParams({
    maxbins: 10
  }),
  field: 'x'
})
Attributes:
as_ : anyOf(string, List(string))

The output fields at which to write the start and end bin values.

bin : anyOf(boolean, BinParams)

An object indicating bin properties, or simply true for using default bin parameters.

field : string

The data field to bin.

transform_calculate(as_=Undefined, calculate=Undefined, **kwargs)

Add a CalculateTransform to the schema.

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.CalculateTransform
underlying transform object

Examples

>>> import altair as alt
>>> from altair import datum, expr
>>> chart = alt.Chart().transform_calculate(y = 2 * expr.sin(datum.x))
>>> chart.transform[0]
CalculateTransform({
  as: 'y',
  calculate: (2 * sin(datum.x))
})

It’s also possible to pass the CalculateTransform arguments directly:

>>> kwds = {'as': 'y', 'calculate': '2 * sin(datum.x)'}
>>> chart = alt.Chart().transform_calculate(**kwds)
>>> chart.transform[0]
CalculateTransform({
  as: 'y',
  calculate: '2 * sin(datum.x)'
})

As the first form is easier to write and understand, that is the recommended method.

Attributes:
as_ : string

The field for storing the computed formula value.

calculate : string or alt.expr expression

A expression string. Use the variable datum to refer to the current data object.

**kwargs

transforms can also be passed by keyword argument; see Examples

transform_filter(filter, **kwargs)

Add a FilterTransform to the schema.

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.FilterTransform
underlying transform object
Attributes:
filter : a filter expression or LogicalOperandPredicate

The filter property must be one of the predicate definitions: (1) a string or alt.expr expression (2) a range predicate (3) a selection predicate (4) a logical operand combining (1)-(3) (5) a NamedSelection object

transform_lookup(as_=Undefined, from_=Undefined, lookup=Undefined, default=Undefined, **kwargs)

Add a LookupTransform to the schema

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.LookupTransform
underlying transform object
Attributes:
as_ : anyOf(string, List(string))

The field or fields for storing the computed formula value. If from.fields is specified, the transform will use the same names for as. If from.fields is not specified, as has to be a string and we put the whole object into the data under the specified name.

from_ : LookupData

Secondary data reference.

lookup : string

Key in primary data source.

default : string

The default value to use if lookup fails. Default value: null

transform_timeunit(as_=Undefined, field=Undefined, timeUnit=Undefined, **kwargs)

Add a TimeUnitTransform to the schema.

Returns:
self : Chart object

returns chart to allow for chaining

See also

alt.TimeUnitTransform
underlying transform object

Examples

>>> import altair as alt
>>> from altair import datum, expr
>>> chart = alt.Chart().transform_timeunit(month='month(date)')
>>> chart.transform[0]
TimeUnitTransform({
  as: 'month',
  field: 'date',
  timeUnit: 'month'
})

It’s also possible to pass the TimeUnitTransform arguments directly; this is most useful in cases where the desired field name is not a valid python identifier:

>>> kwds = {'as': 'month', 'timeUnit': 'month', 'field': 'The Month'}
>>> chart = alt.Chart().transform_timeunit(**kwds)
>>> chart.transform[0]
TimeUnitTransform({
  as: 'month',
  field: 'The Month',
  timeUnit: 'month'
})

As the first form is easier to write and understand, that is the recommended method.

Attributes:
as_ : string

The output field to write the timeUnit value.

field : string

The data field to apply time unit.

timeUnit : TimeUnit

The timeUnit.

**kwargs

transforms can also be passed by keyword argument; see Examples

transform_window(window=Undefined, frame=Undefined, groupby=Undefined, ignorePeers=Undefined, sort=Undefined, **kwargs)

Add a WindowTransform to the schema

Examples

A cumulative line chart

>>> import altair as alt
>>> import numpy as np
>>> import pandas as pd
>>> data = pd.DataFrame({'x': np.arange(100),
...                      'y': np.random.randn(100)})
>>> chart = alt.Chart(data).mark_line().encode(
...     x='x:Q',
...     y='ycuml:Q'
... ).transform_window(
...     ycuml='sum(y)'
... )
>>> chart.transform[0]
WindowTransform({
  window: [WindowFieldDef({
    as: 'ycuml',
    field: 'y',
    op: 'sum'
  })]
})
Attributes:
window : List(WindowFieldDef)

The definition of the fields in the window, and what calculations to use.

frame : List(anyOf(None, float))

A frame specification as a two-element array indicating how the sliding window should proceed. The array entries should either be a number indicating the offset from the current data object, or null to indicate unbounded rows preceding or following the current data object. The default value is [null, 0], indicating that the sliding window includes the current object and all preceding objects. The value [-5, 5] indicates that the window should include five objects preceding and five objects following the current object. Finally, [null, null] indicates that the window frame should always include all data objects. The only operators affected are the aggregation operations and the first_value, last_value, and nth_value window operations. The other window operations are not affected by this.

Default value: : [null, 0] (includes the current object and all preceding objects)

groupby : List(string)

The data fields for partitioning the data objects into separate windows. If unspecified, all data points will be in a single group.

ignorePeers : boolean

Indicates if the sliding window frame should ignore peer values. (Peer values are those considered identical by the sort criteria). The default is false, causing the window frame to expand to include all peer values. If set to true, the window frame will be defined by offset values only. This setting only affects those operations that depend on the window frame, namely aggregation operations and the first_value, last_value, and nth_value window operations.

Default value: false

sort : List(SortField)

A sort field definition for sorting data objects within a window. If two data objects are considered equal by the comparator, they are considered “peer” values of equal rank. If sort is not specified, the order is undefined: data objects are processed in the order they are observed and none are considered peers (the ignorePeers parameter is ignored and treated as if set to true ).

**kwargs

transforms can also be passed by keyword argument; see Examples

validate(instance, schema=None)

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