Boxplot

A boxplot is a statistical chart used to display data distribution, central tendency, and outliers. The box represents the interquartile range, the whiskers represent the range of data extremes, and outliers are marked individually. It is well-suited for visually comparing the distribution characteristics of different groups of data.

Use Cases

  • Used to display the distribution of one or more groups of data, such as score distributions, experimental results, financial data, etc.
  • Suitable for highlighting the median, range, and outliers of data

Visual Examples

Four-Subject Exam Score Distribution: Score distribution comparison of 20 students each in Math, History, English, and Physics.

Penguin Flipper Length Distribution (Grouped by Species and Sex, Custom Colors)

Air Quality Index Distribution of Five Cities: 25 AQI samples each from Beijing, Shanghai, Guangzhou, Chengdu, and Shenzhen, Custom Palette

Options

Configuration Options

PropertyTypeRequiredDescription
typestringrequiredValue must be "boxplot".
dataObject[]requiredChart data.
data.categorystringrequiredCategory name.
data.valuenumberrequiredData value.
data.groupstringoptionalGroup name, used for multi-group data comparison.
titlestringoptionalChart title.
axisXTitlestringoptionalX-axis title.
axisYTitlestringoptionalY-axis title.
theme'default' | 'dark' | 'academy'optionalChart theme, default is "default".
styleObjectoptionalChart style.
style.backgroundColorstringoptionalMust be a valid color value.
style.palettestring[]optionalColor palette.
style.startAtZerobooleanoptionalWhether the Y-axis starts from zero, default is false.
axisXTitlestringoptionalX-axis title.
axisYTitlestringoptionalY-axis title.