altair.MarkConfig
- class altair.MarkConfig(align=Undefined, angle=Undefined, aria=Undefined, ariaRole=Undefined, ariaRoleDescription=Undefined, aspect=Undefined, baseline=Undefined, blend=Undefined, color=Undefined, cornerRadius=Undefined, cornerRadiusBottomLeft=Undefined, cornerRadiusBottomRight=Undefined, cornerRadiusTopLeft=Undefined, cornerRadiusTopRight=Undefined, cursor=Undefined, description=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, endAngle=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, height=Undefined, href=Undefined, innerRadius=Undefined, interpolate=Undefined, invalid=Undefined, limit=Undefined, lineBreak=Undefined, lineHeight=Undefined, opacity=Undefined, order=Undefined, orient=Undefined, outerRadius=Undefined, padAngle=Undefined, radius=Undefined, radius2=Undefined, shape=Undefined, size=Undefined, smooth=Undefined, startAngle=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOffset=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, timeUnitBand=Undefined, timeUnitBandPosition=Undefined, tooltip=Undefined, url=Undefined, width=Undefined, x=Undefined, x2=Undefined, y=Undefined, y2=Undefined, **kwds)
-
MarkConfig schema wrapper
Mapping(required=[])
- Attributes
-
- alignanyOf(
Align,ExprRef) -
The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of
"left","right","center".Note: Expression reference is not supported for range marks.
- angleanyOf(float,
ExprRef) - ariaanyOf(boolean,
ExprRef) - ariaRoleanyOf(string,
ExprRef) - ariaRoleDescriptionanyOf(string,
ExprRef) - aspectanyOf(boolean,
ExprRef) - baselineanyOf(
TextBaseline,ExprRef) -
For text marks, the vertical text baseline. One of
"alphabetic"(default),"top","middle","bottom","line-top","line-bottom", or an expression reference that provides one of the valid values. The"line-top"and"line-bottom"values operate similarly to"top"and"bottom", but are calculated relative to thelineHeightrather thanfontSizealone.For range marks, the vertical alignment of the marks. One of
"top","middle","bottom".Note: Expression reference is not supported for range marks.
- blendanyOf(
Blend,ExprRef) - coloranyOf(
Color,Gradient,ExprRef) -
Default color.
Default value: ■
"#4682b4"Note: - This property cannot be used in a style config. - The
fillandstrokeproperties have higher precedence thancolorand will overridecolor. - cornerRadiusanyOf(float,
ExprRef) - cornerRadiusBottomLeftanyOf(float,
ExprRef) - cornerRadiusBottomRightanyOf(float,
ExprRef) - cornerRadiusTopLeftanyOf(float,
ExprRef) - cornerRadiusTopRightanyOf(float,
ExprRef) - cursoranyOf(
Cursor,ExprRef) - descriptionanyOf(string,
ExprRef) - diranyOf(
TextDirection,ExprRef) - dxanyOf(float,
ExprRef) - dyanyOf(float,
ExprRef) - ellipsisanyOf(string,
ExprRef) - endAngleanyOf(float,
ExprRef) - fillanyOf(
Color,Gradient, None,ExprRef) -
Default fill color. This property has higher precedence than
config.color. Set tonullto remove fill.Default value: (None)
- fillOpacityanyOf(float,
ExprRef) - filledboolean
-
Whether the mark’s color should be used as fill color instead of stroke color.
Default value:
falsefor allpoint,line, andrulemarks as well asgeoshapemarks for graticule data sources; otherwise,true.Note: This property cannot be used in a style config.
- fontanyOf(string,
ExprRef) - fontSizeanyOf(float,
ExprRef) - fontStyleanyOf(
FontStyle,ExprRef) - fontWeightanyOf(
FontWeight,ExprRef) - heightanyOf(float,
ExprRef) - hrefanyOf(
URI,ExprRef) - innerRadiusanyOf(float,
ExprRef) -
The inner radius in pixels of arc marks.
innerRadiusis an alias forradius2. - interpolateanyOf(
Interpolate,ExprRef) - invalidenum(‘filter’, None)
-
Defines how Vega-Lite should handle marks for invalid values (
nullandNaN). - 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). - Ifnull, all data items are included. In this case, invalid values will be interpreted as zeroes. - limitanyOf(float,
ExprRef) - lineBreakanyOf(string,
ExprRef) - lineHeightanyOf(float,
ExprRef) - opacityanyOf(float,
ExprRef) -
The overall opacity (value between [0,1]).
Default value:
0.7for non-aggregate plots withpoint,tick,circle, orsquaremarks or layeredbarcharts and1otherwise. - orderanyOf(None, boolean)
-
For line and trail marks, this
orderproperty can be set tonullorfalseto make the lines use the original order in the data sources. - orient
Orientation -
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.sortLineByis not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored. - outerRadiusanyOf(float,
ExprRef) -
The outer radius in pixels of arc marks.
outerRadiusis an alias forradius. - padAngleanyOf(float,
ExprRef) - radiusanyOf(float,
ExprRef) -
For arc mark, the primary (outer) radius in pixels.
For text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the
xandyproperties. - radius2anyOf(float,
ExprRef) -
The secondary (inner) radius in pixels of arc marks.
- shapeanyOf(anyOf(
SymbolShape, string),ExprRef) - sizeanyOf(float,
ExprRef) -
Default size for marks. - For
point/circle/square, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value. - Forbar, this represents the band size of the bar, in pixels. - Fortext, this represents the font size, in pixels.Default value: -
30for point, circle, square marks; width/height’sstep-2for bar marks with discrete dimensions; -5for bar marks with continuous dimensions; -11for text marks. - smoothanyOf(boolean,
ExprRef) - startAngleanyOf(float,
ExprRef) - strokeanyOf(
Color,Gradient, None,ExprRef) -
Default stroke color. This property has higher precedence than
config.color. Set tonullto remove stroke.Default value: (None)
- strokeCapanyOf(
StrokeCap,ExprRef) - strokeDashanyOf(List(float),
ExprRef) - strokeDashOffsetanyOf(float,
ExprRef) - strokeJoinanyOf(
StrokeJoin,ExprRef) - strokeMiterLimitanyOf(float,
ExprRef) - strokeOffsetanyOf(float,
ExprRef) - strokeOpacityanyOf(float,
ExprRef) - strokeWidthanyOf(float,
ExprRef) - tensionanyOf(float,
ExprRef) - textanyOf(
Text,ExprRef) - thetaanyOf(float,
ExprRef) -
For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)
For text marks, polar coordinate angle in radians.
- theta2anyOf(float,
ExprRef) -
The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise.
- timeUnitBandfloat
-
Default relative band size for a time unit. If set to
1, the bandwidth of the marks will be equal to the time unit band step. If set to0.5, bandwidth of the marks will be half of the time unit band step. - timeUnitBandPositionfloat
-
Default relative band position for a time unit. If set to
0, the marks will be positioned at the beginning of the time unit band step. If set to0.5, the marks will be positioned in the middle of the time unit band step. - tooltipanyOf(float, string, boolean,
TooltipContent,ExprRef, None) -
The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.
-
If
tooltipistrueor{"content": "encoding"}, then all fields fromencodingwill be used. - Iftooltipis{"content": "data"}, then all fields that appear in the highlighted data point will be used. - If set tonullorfalse, then no tooltip will be used.
See the tooltip documentation for a detailed discussion about tooltip in Vega-Lite.
Default value:
null -
- urlanyOf(
URI,ExprRef) - widthanyOf(float,
ExprRef) - xanyOf(float, string,
ExprRef) -
X coordinates of the marks, or width of horizontal
"bar"and"area"without specifiedx2orwidth.The
valueof this channel can be a number or a string"width"for the width of the plot. - x2anyOf(float, string,
ExprRef) -
X2 coordinates for ranged
"area","bar","rect", and"rule".The
valueof this channel can be a number or a string"width"for the width of the plot. - yanyOf(float, string,
ExprRef) -
Y coordinates of the marks, or height of vertical
"bar"and"area"without specifiedy2orheight.The
valueof this channel can be a number or a string"height"for the height of the plot. - y2anyOf(float, string,
ExprRef) -
Y2 coordinates for ranged
"area","bar","rect", and"rule".The
valueof this channel can be a number or a string"height"for the height of the plot.
- alignanyOf(
- __init__(align=Undefined, angle=Undefined, aria=Undefined, ariaRole=Undefined, ariaRoleDescription=Undefined, aspect=Undefined, baseline=Undefined, blend=Undefined, color=Undefined, cornerRadius=Undefined, cornerRadiusBottomLeft=Undefined, cornerRadiusBottomRight=Undefined, cornerRadiusTopLeft=Undefined, cornerRadiusTopRight=Undefined, cursor=Undefined, description=Undefined, dir=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, endAngle=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, height=Undefined, href=Undefined, innerRadius=Undefined, interpolate=Undefined, invalid=Undefined, limit=Undefined, lineBreak=Undefined, lineHeight=Undefined, opacity=Undefined, order=Undefined, orient=Undefined, outerRadius=Undefined, padAngle=Undefined, radius=Undefined, radius2=Undefined, shape=Undefined, size=Undefined, smooth=Undefined, startAngle=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOffset=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, tension=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, timeUnitBand=Undefined, timeUnitBandPosition=Undefined, tooltip=Undefined, url=Undefined, width=Undefined, x=Undefined, x2=Undefined, y=Undefined, y2=Undefined, **kwds)
Methods
__init__([align, angle, aria, ariaRole, ...])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