This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)


Updated In 8 Graphic
makes a bubble chart with bubbles at positions with sizes .
makes a bubble chart with bubble features defined by the symbolic wrappers .
makes a bubble chart from multiple datasets .
  • Data elements for BubbleChart can be given in the following forms:
{xi,yi,zi}a pure bubble value
wi[{xi,yi,zi},...]a bubble with value and wrapper
formi->mia sector form with metadata
  • The values should be positive.
  • Data not given in these forms is ignored in forming the bubble chart.
  • Datasets for BubbleChart can be given in the following forms:
{e1,e2,...}list of elements with or without wrappers
w[{e1,e2,...},...]wrapper applied to a whole dataset
w[{data1,data1,...},...]wrapper applied to all datasets
  • The following wrappers can be used for chart elements:
Annotation[e,label]provide an annotation
Button[e,action]define an action to execute when the element is clicked
EventHandler[e,...]define a general event handler for the element
Hyperlink[e,uri]make the element act as a hyperlink
Labeled[e,...]display the element with labeling
Legended[e,...]include features of the element in a chart legend
Mouseover[e,over]make the element show a mouseover form
PopupWindow[e,cont]attach a popup window to the element
StatusArea[e,label]display in the status area when the element is moused over
Style[e,opts]show the element using the specified styles
Tooltip[e,label]attach an arbitrary tooltip to the element
Top,Bottom,Left,Right,Centerpositions within bubbles
Above,Below, Before, Afterpositions outside bubbles
{{bx,by},{lx,ly}}scaled position in the label at scaled position in the bubble
AspectRatio1overall ratio of width to height
BubbleScale"Area"feature scale used for bubbles
BubbleSizesAutomaticsize range to use for bubbles
ChartBaseStyleAutomaticoverall style for bubbles
ChartElementFunctionAutomatichow to generate raw graphics for bubbles
ChartElementsAutomaticgraphics to use for each of the bubbles
ChartLabelsNonelabels for data elements and datasets
ChartLegendsNonelegends for data elements and datasets
ChartStyleAutomaticstyle for bubbles
ColorFunctionAutomatichow to color bubbles
ColorFunctionScalingTruewhether to normalize arguments to ColorFunction
FrameTruewhether to draw a frame around the chart
LabelingFunctionAutomatichow to label bubbles
LegendAppearanceAutomaticoverall appearance of legends
PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
ScalingFunctionsNonehow to scale individual coordinates
  • BubbleChart layers bubbles from largest to smallest for maximal visibility.
  • The arguments supplied to ChartElementFunction are the bubble region , the values , and the metadata from each level in a nested list of datasets.
Create a bubble chart for a list of triples:
Multiple datasets:
Set the style for bubbles:
Pictorial bubbles:
Procedural bubbles:
Create a bubble chart for a list of triples:
Click for copyable input
Multiple datasets:
Click for copyable input
Set the style for bubbles:
Click for copyable input
Pictorial bubbles:
Click for copyable input
Procedural bubbles:
Click for copyable input
Items in a dataset are colored the same:
Nonreal data is taken to be missing:
Use wrappers on individual data, datasets, or collections of datasets:
Wrappers can be nested:
Override the default tooltips:
Use any object in the tooltip:
Use PopupWindow to provide additional drilldown information:
Button can be used to trigger any action:
Use an explicit list of styles for the bubbles:
Use any gradient or indexed color schemes from ColorData:
Use color schemes designed for charting:
ChartBaseStyle can be used to set an initial style for all chart elements:
Style can be used to override styles:
Use any graphic for pictorial bubbles:
Use built-in programmatically generated bubbles:
For detailed settings, use PalettesChartElementSchemes:
Use Labeled to add a label to a bubble:
Use symbolic positions for label placement:
Use Placed to control the positioning of labels, using the same positions as for Labeled:
Provide value labels for bubbles by using LabelingFunction:
Use legend entries for different datasets:
Use Legended to add additional legend entries:
Use Placed to affect the positioning of legends:
By default the area of a bubble is proportional to the z value:
Compare area scale to diameter scale:
Change the size range of the bubbles:
Use ChartBaseStyle to style all bubbles:
ChartBaseStyle combines with ChartStyle:
ChartStyle may override settings for ChartBaseStyle:
ChartBaseStyle combines with Style:
Style may override settings for ChartBaseStyle:
ColorFunction may override settings for ChartBaseStyle:
Create a pictorial chart based on any Graphics object:
Use a different graphic for each dataset:
Graphics are used cyclically:
Styles are inherited from styles set through ChartStyle etc.:
Explicit styles set in the graphic will override other style settings:
Create true 3D shaded bubbles:
Get a list of built-in settings for ChartElementFunction:
For more settings, use PalettesChartElementSchemes:
Write a custom ChartElementFunction:
Use metadata passed on from the input, in this case charting the data:
The built-in element function may have options; use PalettesChartElementSchemes to set them:
By default, labels are placed in the bubbles:
Labeled wrappers in data will place additional labels:
Use Placed to control label placement:
Coordinate-based placement relative to a bubble:
Place all labels at the center of each bubble and vary the coordinates within the label:
Use the third argument to Placed to control formatting:
Use a hyperlink label:
Place multiple labels:
Generate a legend based on chart style:
Use Legended to add additional legend entries:
Use Legended to specify individual legend entries:
Generate a legend for datasets:
Unused legend labels are dropped:
Legends can be applied to several dimensions:
Use Placed to control the placement of legends:
Use ChartStyle to set the style:
Give a list of styles:
Use colors from ColorData:
Use colors from ColorData:
Styles are used cyclically:
Style each column of data:
Style each row of data:
Style both rows and columns of data:
With both row and column styles, the last style may override earlier ones:
Style overrides settings for ChartStyle:
Style may combine with ChartStyle:
ColorFunction overrides settings for ChartStyle:
ColorFunction may combine with ChartStyle:
ChartElements may override settings for ChartStyle:
Color by coordinate value:
Use ColorFunctionScaling->False to get unscaled height values:
ColorFunction overrides styles in ChartStyle:
Use ColorFunction to combine different style effects:
By default, scaled values are used:
Use ColorFunctionScaling->False to get unscaled height values:
Use automatic labeling by values through Tooltip and StatusArea:
Do no labeling:
Use Placed to control label placement:
Coordinate-based placement relative to a given bubble:
Control the formatting of labels:
Use the given chart labels as arguments to the labeling function:
Generate a bubble chart with interactive highlighting:
Emphasize performance by disabling interactive behaviors:
Typically less memory is required for non-interactive charts:
Display GDP per capita, poverty fraction, and population for countries in Africa:
Define a labeling function for more complex tooltips:
Mouseover the bubbles to view a country's data:
Display oil data for the G15 countries using PieChart for bubbles to indicate import and export:
Click on the bubbles to hear the name of the country, its GDP per capita, and its population:
Get population, weather, and coordinate data of large Japanese cities:
Get a map of Japan:
Mouseover the bubbles to get city and temperature information:
Represent clusters of elements based on three properties:
Cluster the elements into groups based on the value of their properties:
Mouseover the bubbles to get element information:
Use BubbleChart3D to get a 3D rendering of bubble charts:
Use SectorChart3D and RectangleChart3D as alternative visualizations:
New in 7 | Last modified in 8