altair.Config#
- class altair.Config(arc=Undefined, area=Undefined, aria=Undefined, autosize=Undefined, axis=Undefined, axisBand=Undefined, axisBottom=Undefined, axisDiscrete=Undefined, axisLeft=Undefined, axisPoint=Undefined, axisQuantitative=Undefined, axisRight=Undefined, axisTemporal=Undefined, axisTop=Undefined, axisX=Undefined, axisXBand=Undefined, axisXDiscrete=Undefined, axisXPoint=Undefined, axisXQuantitative=Undefined, axisXTemporal=Undefined, axisY=Undefined, axisYBand=Undefined, axisYDiscrete=Undefined, axisYPoint=Undefined, axisYQuantitative=Undefined, axisYTemporal=Undefined, background=Undefined, bar=Undefined, boxplot=Undefined, circle=Undefined, concat=Undefined, countTitle=Undefined, customFormatTypes=Undefined, errorband=Undefined, errorbar=Undefined, facet=Undefined, fieldTitle=Undefined, font=Undefined, geoshape=Undefined, header=Undefined, headerColumn=Undefined, headerFacet=Undefined, headerRow=Undefined, image=Undefined, legend=Undefined, line=Undefined, lineBreak=Undefined, locale=Undefined, mark=Undefined, numberFormat=Undefined, padding=Undefined, params=Undefined, point=Undefined, projection=Undefined, range=Undefined, rect=Undefined, rule=Undefined, scale=Undefined, selection=Undefined, square=Undefined, style=Undefined, text=Undefined, tick=Undefined, timeFormat=Undefined, title=Undefined, trail=Undefined, view=Undefined, **kwds)#
Config schema wrapper
Mapping(required=[])
- Attributes
- arc
RectConfig
Arc-specific Config
- area
AreaConfig
Area-Specific Config
- ariaboolean
A boolean flag indicating if ARIA default attributes should be included for marks and guides (SVG output only). If false, the
"aria-hidden"
attribute will be set for all guides, removing them from the ARIA accessibility tree and Vega-Lite will not generate default descriptions for marks.Default value:
true
.- autosizeanyOf(
AutosizeType
,AutoSizeParams
) How the visualization size should be determined. If a string, should be one of
"pad"
,"fit"
or"none"
. Object values can additionally specify parameters for content sizing and automatic resizing.Default value :
pad
- axis
AxisConfig
Axis configuration, which determines default properties for all
x
andy
axes. For a full list of axis configuration options, please see the corresponding section of the axis documentation.- axisBand
AxisConfig
Config for axes with “band” scales.
- axisBottom
AxisConfig
Config for x-axis along the bottom edge of the chart.
- axisDiscrete
AxisConfig
Config for axes with “point” or “band” scales.
- axisLeft
AxisConfig
Config for y-axis along the left edge of the chart.
- axisPoint
AxisConfig
Config for axes with “point” scales.
- axisQuantitative
AxisConfig
Config for quantitative axes.
- axisRight
AxisConfig
Config for y-axis along the right edge of the chart.
- axisTemporal
AxisConfig
Config for temporal axes.
- axisTop
AxisConfig
Config for x-axis along the top edge of the chart.
- axisX
AxisConfig
X-axis specific config.
- axisXBand
AxisConfig
Config for x-axes with “band” scales.
- axisXDiscrete
AxisConfig
Config for x-axes with “point” or “band” scales.
- axisXPoint
AxisConfig
Config for x-axes with “point” scales.
- axisXQuantitative
AxisConfig
Config for x-quantitative axes.
- axisXTemporal
AxisConfig
Config for x-temporal axes.
- axisY
AxisConfig
Y-axis specific config.
- axisYBand
AxisConfig
Config for y-axes with “band” scales.
- axisYDiscrete
AxisConfig
Config for y-axes with “point” or “band” scales.
- axisYPoint
AxisConfig
Config for y-axes with “point” scales.
- axisYQuantitative
AxisConfig
Config for y-quantitative axes.
- axisYTemporal
AxisConfig
Config for y-temporal axes.
- backgroundanyOf(
Color
,ExprRef
) CSS color property to use as the background of the entire view.
Default value:
"white"
- bar
BarConfig
Bar-Specific Config
- boxplot
BoxPlotConfig
Box Config
- circle
MarkConfig
Circle-Specific Config
- concat
CompositionConfig
Default configuration for all concatenation and repeat view composition operators (
concat
,hconcat
,vconcat
, andrepeat
)- countTitlestring
Default axis and legend title for count fields.
Default value:
'Count of Records
.- customFormatTypesboolean
Allow the
formatType
property for text marks and guides to accept a custom formatter function registered as a Vega expression.- errorband
ErrorBandConfig
ErrorBand Config
- errorbar
ErrorBarConfig
ErrorBar Config
- facet
CompositionConfig
Default configuration for the
facet
view composition operator- fieldTitleenum(‘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”).
- fontstring
Default font for all text marks, titles, and labels.
- geoshape
MarkConfig
Geoshape-Specific Config
- header
HeaderConfig
Header configuration, which determines default properties for all headers.
For a full list of header configuration options, please see the corresponding section of in the header documentation.
- headerColumn
HeaderConfig
Header configuration, which determines default properties for column headers.
For a full list of header configuration options, please see the corresponding section of in the header documentation.
- headerFacet
HeaderConfig
Header configuration, which determines default properties for non-row/column facet headers.
For a full list of header configuration options, please see the corresponding section of in the header documentation.
- headerRow
HeaderConfig
Header configuration, which determines default properties for row headers.
For a full list of header configuration options, please see the corresponding section of in the header documentation.
- image
RectConfig
Image-specific Config
- 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
- lineBreakanyOf(string,
ExprRef
) A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property provides a global default for text marks, which is overridden by mark or style config settings, and by the lineBreak mark encoding channel. If signal-valued, either string or regular expression (regexp) values are valid.
- locale
Locale
Locale definitions for string parsing and formatting of number and date values. The locale object should contain
number
and/ortime
properties with locale definitions. Locale definitions provided in the config block may be overridden by the View constructor locale option.- mark
MarkConfig
Mark Config
- numberFormatstring
D3 Number format for guide labels and text marks. For example
"s"
for SI units. Use D3’s number format pattern.- paddinganyOf(
Padding
,ExprRef
) 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
- paramsList(anyOf(
VariableParameter
,TopLevelSelectionParameter
)) Dynamic variables or selections that parameterize a visualization.
- 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
RectConfig
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
- 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
MarkConfig
Text-Specific Config
- tick
TickConfig
Tick-Specific Config
- timeFormatstring
Default time format for raw time values (without time units) in text marks, legend labels and header labels.
Default value:
"%b %d, %Y"
Note: Axes automatically determine the format for each label automatically so this config does not affect axes.- title
TitleConfig
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.
- arc
- __init__(arc=Undefined, area=Undefined, aria=Undefined, autosize=Undefined, axis=Undefined, axisBand=Undefined, axisBottom=Undefined, axisDiscrete=Undefined, axisLeft=Undefined, axisPoint=Undefined, axisQuantitative=Undefined, axisRight=Undefined, axisTemporal=Undefined, axisTop=Undefined, axisX=Undefined, axisXBand=Undefined, axisXDiscrete=Undefined, axisXPoint=Undefined, axisXQuantitative=Undefined, axisXTemporal=Undefined, axisY=Undefined, axisYBand=Undefined, axisYDiscrete=Undefined, axisYPoint=Undefined, axisYQuantitative=Undefined, axisYTemporal=Undefined, background=Undefined, bar=Undefined, boxplot=Undefined, circle=Undefined, concat=Undefined, countTitle=Undefined, customFormatTypes=Undefined, errorband=Undefined, errorbar=Undefined, facet=Undefined, fieldTitle=Undefined, font=Undefined, geoshape=Undefined, header=Undefined, headerColumn=Undefined, headerFacet=Undefined, headerRow=Undefined, image=Undefined, legend=Undefined, line=Undefined, lineBreak=Undefined, locale=Undefined, mark=Undefined, numberFormat=Undefined, padding=Undefined, params=Undefined, point=Undefined, projection=Undefined, range=Undefined, rect=Undefined, rule=Undefined, scale=Undefined, selection=Undefined, square=Undefined, style=Undefined, text=Undefined, tick=Undefined, timeFormat=Undefined, title=Undefined, trail=Undefined, view=Undefined, **kwds)#
Methods
__init__
([arc, area, aria, autosize, axis, ...])copy
([deep, ignore])Return a copy of the object
from_dict
(dct[, validate, _wrapper_classes])Construct class from a dictionary representation
from_json
(json_string[, validate])Instantiate the object from a valid JSON string
resolve_references
([schema])Resolve references in the context of this object's schema or root schema.
to_dict
([validate, ignore, context])Return a dictionary representation of the object
to_json
([validate, ignore, context, indent, ...])Emit the JSON representation for this object as a string.
validate
(instance[, schema])Validate the instance against the class schema in the context of the rootschema.
validate_property
(name, value[, schema])Validate a property against property schema in the context of the rootschema