altair.BoxPlotDef#
- class altair.BoxPlotDef(type=Undefined, box=Undefined, clip=Undefined, color=Undefined, extent=Undefined, invalid=Undefined, median=Undefined, opacity=Undefined, orient=Undefined, outliers=Undefined, rule=Undefined, size=Undefined, ticks=Undefined, **kwds)#
BoxPlotDef schema wrapper.
- Parameters:
- type
BoxPlot
, Literal[‘boxplot’] The mark type. This could a primitive mark type (one of
"bar"
,"circle"
,"square"
,"tick"
,"line"
,"area"
,"point"
,"geoshape"
,"rule"
, and"text"
) or a composite mark type ("boxplot"
,"errorband"
,"errorbar"
).- boxbool, dict,
BarConfig
,AreaConfig
,LineConfig
,MarkConfig
,RectConfig
,TickConfig
,AnyMarkConfig
- clipbool
Whether a composite mark be clipped to the enclosing group’s width and height.
- colorstr, dict,
Color
,ExprRef
,Gradient
,HexColor
,ColorName
,LinearGradient
,RadialGradient
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’] Default color.
Default value: ■
"#4682b4"
Note:
This property cannot be used in a style config.
The
fill
andstroke
properties have higher precedence thancolor
and will overridecolor
.
- extentfloat, Literal[‘min-max’]
The extent of the whiskers. Available options include:
"min-max"
: min and max are the lower and upper whiskers respectively.A number representing multiple of the interquartile range. This number will be multiplied by the IQR to determine whisker boundary, which spans from the smallest data to the largest data within the range [Q1 - k * IQR, Q3 + k * IQR] where Q1 and Q3 are the first and third quartiles while IQR is the interquartile range (Q3-Q1).
Default value:
1.5
.- invalidNone,
MarkInvalidDataMode
, Literal[‘filter’, ‘break-paths-filter-domains’, ‘break-paths-show-domains’, ‘break-paths-show-path-domains’, ‘show’] Invalid data mode, which defines how the marks and corresponding scales should represent invalid values (
null
andNaN
in continuous scales without defined output for invalid values)."filter"
— Exclude all invalid values from the visualization’s marks and scales. For path marks (for line, area, trail), this option will create paths that connect valid points, as if the data rows with invalid values do not exist."break-paths-filter-domains"
— Break path marks (for line, area, trail) at invalid values. For non-path marks, this is equivalent to"filter"
. All scale domains will exclude these filtered data points."break-paths-show-domains"
— Break paths (for line, area, trail) at invalid values. Hide invalid values for non-path marks. All scale domains will include these filtered data points (for both path and non-path marks)."show"
ornull
— Show all data points in the marks and scale domains. Each scale will use the output for invalid values defined inconfig.scale.invalid
or, if unspecified, by default invalid values will produce the same visual values as zero (if the scale includes zero) or the minimum value (if the scale does not include zero)."break-paths-show-path-domains"
(default) — This is equivalent to"break-paths-show-domains"
for path-based marks (line/area/trail) and"filter"
for non-path marks.
Note: If any channel’s scale has an output for invalid values defined in
config.scale.invalid
, all values for the scales will be considered “valid” since they can produce a reasonable output for the scales. Thus, fields for such channels will not be filtered and will not cause path breaks.- medianbool, dict,
BarConfig
,AreaConfig
,LineConfig
,MarkConfig
,RectConfig
,TickConfig
,AnyMarkConfig
- opacityfloat
The opacity (value between [0,1]) of the mark.
- orient
Orientation
, Literal[‘horizontal’, ‘vertical’] Orientation of the box plot. This is normally automatically determined based on types of fields on x and y channels. However, an explicit
orient
be specified when the orientation is ambiguous.Default value:
"vertical"
.- outliersbool, dict,
BarConfig
,AreaConfig
,LineConfig
,MarkConfig
,RectConfig
,TickConfig
,AnyMarkConfig
- rulebool, dict,
BarConfig
,AreaConfig
,LineConfig
,MarkConfig
,RectConfig
,TickConfig
,AnyMarkConfig
- sizefloat
Size of the box and median tick of a box plot
- ticksbool, dict,
BarConfig
,AreaConfig
,LineConfig
,MarkConfig
,RectConfig
,TickConfig
,AnyMarkConfig
- type
- __init__(type=Undefined, box=Undefined, clip=Undefined, color=Undefined, extent=Undefined, invalid=Undefined, median=Undefined, opacity=Undefined, orient=Undefined, outliers=Undefined, rule=Undefined, size=Undefined, ticks=Undefined, **kwds)#
Methods
__init__
([type, box, clip, color, extent, ...])copy
([deep, ignore])Return a copy of the object.
from_dict
(dct[, validate])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, indent, sort_keys, ...])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.