WOLFRAM

BubbleChart[{{x1,y1,z1},{x2,y2,z2},}]

makes a bubble chart with bubbles at positions {xi,yi} with sizes zi.

BubbleChart[{,wi[{xi,yi,zi},],,wj[{xj,yj,zj},],}]

makes a bubble chart with bubble features defined by the symbolic wrappers wk.

BubbleChart[{data1,data2,}]

makes a bubble chart from multiple datasets datai.

Details and Options

Examples

open allclose all

Basic Examples  (3)Summary of the most common use cases

Create a bubble chart for a list of triples:

Out[1]=1

Multiple datasets:

Out[1]=1

Set the style for bubbles:

Out[1]=1

Pictorial bubbles:

Out[2]=2

Procedural bubbles:

Out[3]=3

Scope  (32)Survey of the scope of standard use cases

Data and Wrappers  (14)

Items in a dataset are colored the same:

Out[1]=1

Nonreal data is taken to be missing:

Out[1]=1
Out[2]=2

The data may include units:

Out[1]=1

Specify the units to use:

Out[1]=1

The time stamps in TimeSeries, EventSeries, and TemporalData are ignored:

Out[1]=1

The values in associations are taken as bubble values:

Out[1]=1

Use the keys as labels:

Out[2]=2

Use the keys as legends:

Out[3]=3

Associations can be nested down to the point level:

Out[1]=1

Or up to the group level:

Out[2]=2

The weights in WeightedData are ignored:

Out[1]=1

Use wrappers on individual data, datasets, or collections of datasets:

Out[2]=2

Wrappers can be nested:

Out[2]=2

Override the default tooltips:

Out[1]=1

Use any object in the tooltip:

Out[2]=2

Use PopupWindow to provide additional drilldown information:

Out[1]=1

Button can be used to trigger any action:

Out[1]=1

Tabular Data  (1)

Get tabular data:

Out[1]=1

Plot horsepower against displacement, with bubbles sized according to the mileage:

Out[2]=2

Pivot the data to create columns of mileage per region:

Out[3]=3

Plot the data by region of origin:

Out[4]=4

Styling and Appearance  (8)

Use an explicit list of styles for the bubbles:

Out[1]=1

Use any gradient or indexed color schemes from ColorData:

Out[1]=1

Use color schemes designed for charting:

Out[1]=1
Out[2]=2

ChartBaseStyle can be used to set an initial style for all chart elements:

Out[1]=1

Style can be used to override styles:

Out[1]=1

Use any graphic for pictorial bubbles:

Out[1]=1

Use built-in programmatically generated bubbles:

Out[1]=1
Out[2]=2

For detailed settings, use Palettes ChartElementSchemes:

Out[3]=3

Use a theme with simple ticks and grid lines in a bright color scheme:

Out[1]=1

Use a theme with a high contrast color scheme and 3D bubbles:

Out[2]=2

Labeling and Legending  (9)

Use Labeled to add a label to a bubble:

Out[1]=1

Use symbolic positions for label placement:

Out[1]=1

Use Placed to control the positioning of labels, using the same positions as for Labeled:

Out[1]=1

Provide value labels for bubbles by using LabelingFunction:

Out[2]=2

Specify the maximum size of labels:

Out[2]=2

Use the full label:

Out[3]=3

For dense sets of points, some labels may be turned into tooltips by default:

Out[2]=2

Increasing the size of the plot will show more labels:

Out[3]=3

Use legend entries for different datasets:

Out[2]=2

Use Legended to add additional legend entries:

Out[1]=1

Use Placed to affect the positioning of legends:

Out[2]=2

Options  (118)Common values & functionality for each option

AspectRatio  (3)

By default, BubbleChart uses the same width and height:

Out[4]=4

Use a numerical value to specify the height to width ratio:

Out[1]=1

AspectRatioAutomatic determines the range from the values:

Out[1]=1

Axes  (3)

By default, BubbleChart uses a frame instead of axes:

Out[1]=1

Use axes instead of a frame:

Out[1]=1

Turn each axis on individually:

Out[1]=1

AxesLabel  (4)

No axes labels are drawn by default:

Out[1]=1

Place a label on the axis:

Out[1]=1

Specify axes labels:

Out[1]=1

Use units as labels:

Out[1]=1

AxesOrigin  (2)

The position of the axes is determined automatically:

Out[1]=1

Specify an explicit origin for the axes:

Out[1]=1

AxesStyle  (4)

Change the style for the axes:

Out[2]=2

Specify the style of each axis:

Out[1]=1

Use different styles for the ticks and the axes:

Out[1]=1

Use different styles for the labels and the axes:

Out[1]=1

BubbleScale  (2)

By default, the area of a bubble is proportional to the z value:

Out[1]=1

Compare area scale to diameter scale:

Out[2]=2

BubbleSizes  (1)

Change the size range of the bubbles:

Out[2]=2

ChartBaseStyle  (5)

Use ChartBaseStyle to style all bubbles:

Out[2]=2

ChartBaseStyle combines with ChartStyle:

Out[1]=1

ChartStyle may override settings for ChartBaseStyle:

Out[1]=1

ChartBaseStyle combines with Style:

Out[1]=1

Style may override settings for ChartBaseStyle:

Out[2]=2

ChartBaseStyle combines with ColorFunction:

Out[1]=1

ColorFunction may override settings for ChartBaseStyle:

Out[2]=2

ChartElementFunction  (5)

Get a list of built-in settings for ChartElementFunction:

Out[1]=1

For more settings, use Palettes ChartElementSchemes:

Out[2]=2
Out[3]=3
Out[4]=4

Write a custom ChartElementFunction:

Out[2]=2
Out[4]=4

Use metadata passed on from the input, in this case charting the data:

Out[3]=3

The built-in element function may have options; use Palettes ChartElementSchemes to set them:

Out[1]=1
Out[2]=2

ChartElements  (5)

Create a pictorial chart based on any Graphics object:

Out[2]=2

Graphics3D:

Out[3]=3

Image:

Out[4]=4

Use a different graphic for each dataset:

Out[2]=2

Graphics are used cyclically:

Out[1]=1

Styles are inherited from styles set through ChartStyle etc.:

Out[1]=1

Explicit styles set in the graphic will override other style settings:

Out[2]=2

Create true 3D shaded bubbles:

Out[2]=2

ChartLabels  (7)

By default, labels are placed in the bubbles:

Out[1]=1

Labeled wrappers in data will place additional labels:

Out[2]=2

Use Placed to control label placement:

Out[1]=1

Coordinate-based placement relative to a bubble:

Out[1]=1

Place all labels at the center of each bubble and vary the coordinates within the label:

Out[1]=1

Use the third argument to Placed to control formatting:

Out[1]=1

Use a hyperlink label:

Out[2]=2

Use Callout to connect the labels to the bubbles:

Out[1]=1

Place multiple labels:

Out[1]=1

ChartLegends  (7)

Generate a legend based on chart style:

Out[1]=1

Use Legended to add additional legend entries:

Out[1]=1

Use Legended to specify individual legend entries:

Out[1]=1

Generate a legend for datasets:

Out[2]=2

Unused legend labels are dropped:

Out[2]=2

Legends can be applied to several dimensions:

Out[2]=2

Use Placed to control the placement of legends:

Out[2]=2

ChartStyle  (14)

Use ChartStyle to set the style:

Out[1]=1

Give a list of styles:

Out[1]=1

Use "Gradient" colors from ColorData:

Out[1]=1

Use "Indexed" colors from ColorData:

Out[1]=1

Styles are used cyclically:

Out[2]=2

Style each column of data:

Out[1]=1

Style each row of data:

Out[1]=1

Style both rows and columns of data:

Out[1]=1

With both row and column styles, the last style may override earlier ones:

Out[1]=1

Style overrides settings for ChartStyle:

Out[1]=1

Style may combine with ChartStyle:

Out[1]=1

ColorFunction overrides settings for ChartStyle:

Out[1]=1

ColorFunction may combine with ChartStyle:

Out[1]=1

ChartElements may override settings for ChartStyle:

Out[1]=1

ColorFunction  (3)

Color by coordinate value:

Out[1]=1

Use ColorFunctionScaling->False to get unscaled height values:

Out[1]=1

ColorFunction overrides styles in ChartStyle:

Out[2]=2

Use ColorFunction to combine different style effects:

Out[3]=3

ColorFunctionScaling  (2)

By default, scaled values are used:

Out[1]=1

Use ColorFunctionScaling->False to get unscaled height values:

Out[1]=1

Frame  (4)

BubbleChart uses a frame by default:

Out[2]=2

Use FrameFalse to turn off the frame:

Out[1]=1

Draw a frame on the left and right edges:

Out[1]=1

Draw a frame on the left and bottom edges:

Out[1]=1

FrameLabel  (4)

Place a label along the bottom edge of a chart:

Out[2]=2

Frame labels are placed on the bottom and left frame edges by default:

Out[1]=1

Place labels on each of the edges in the frame:

Out[1]=1

Use a customized style for both labels and frame tick labels:

Out[1]=1

FrameStyle  (2)

Specify the style of the frame:

Out[2]=2

Specify style for each frame edge:

Out[1]=1

FrameTicks  (7)

Frame ticks are placed automatically by default:

Out[1]=1

By default, the top and right edges have tick marks but no tick labels:

Out[1]=1

Use All to include tick labels on all edges:

Out[1]=1

Place tick marks at the specified positions:

Out[1]=1

Draw frame tick marks at the specified positions with specific labels:

Out[1]=1

Specify tick length as a fraction of the size of the chart:

Out[1]=1

Use different sizes in the positive and negative directions for tick marks:

Out[2]=2

Specify a style for the frame tick:

Out[1]=1

FrameTicksStyle  (3)

By default, the frame ticks and frame tick labels use the same style as the frame:

Out[1]=1

Specify a style for the frame ticks:

Out[1]=1

Use a different style for the ticks on each frame edge:

Out[1]=1

ImageSize  (7)

Use named sizes such as Tiny, Small, Medium and Large:

Out[1]=1

Specify the width of the plot:

Out[1]=1

Specify the height of the plot:

Out[2]=2

Allow the width and height to be up to a certain size:

Out[1]=1

Specify the width and height for a graphic, padding with space if necessary:

Out[1]=1

Setting AspectRatioFull will fill the available space:

Out[2]=2

Use maximum sizes for the width and height:

Out[1]=1

Use ImageSizeFull to fill the available space in an object:

Out[1]=1

Specify the image size as a fraction of the available space:

Out[1]=1

LabelingFunction  (7)

Use automatic labeling by values through Tooltip and StatusArea:

Out[1]=1

Do no labeling:

Out[1]=1

Use Placed to control label placement:

Out[1]=1

Coordinate-based placement relative to a given bubble:

Out[1]=1

Use Callout to place labels automatically:

Out[1]=1

Use symbolic positions to place Callout labels:

Out[2]=2

Control the formatting of labels:

Out[1]=1

Use the given chart labels as arguments to the labeling function:

Out[3]=3

LabelingSize  (4)

Textual labels are shown at their actual sizes:

Out[5]=5

Image labels are automatically resized:

Out[1]=1

Specify a maximum size for textual labels:

Out[1]=1

Specify a maximum size for image labels:

Out[2]=2

Show image labels at their natural sizes:

Out[1]=1

PerformanceGoal  (1)

Generate a bubble chart with interactive highlighting:

Out[2]=2

Emphasize performance by disabling interactive behaviors:

Out[3]=3

Typically, less memory is required for non-interactive charts:

Out[4]=4

PlotTheme  (2)

Use a theme with simple ticks in a bold color scheme:

Out[1]=1

Change the chart style:

Out[1]=1

Ticks  (6)

Ticks are placed automatically in each chart:

Out[2]=2

Use TicksNone to draw axes without any tick marks:

Out[1]=1

Place tick marks at the specified positions:

Out[1]=1

Draw tick marks at the specified positions with specific labels:

Out[1]=1

Specify the lengths for ticks as a fraction of graphics size:

Out[1]=1

Use different sizes in the positive and negative directions for ticks:

Out[2]=2

Specify a style for ticks:

Out[1]=1

TicksStyle  (4)

By default, the ticks and tick labels use the same styles as the axis:

Out[1]=1

Specify an overall ticks style, including the tick labels:

Out[1]=1

Specify ticks style for each of the axes:

Out[1]=1

Use a different style for the tick labels and tick marks:

Out[1]=1

Applications  (5)Sample problems that can be solved with this function

Display GDP per capita, poverty fraction and population for countries in Africa:

Define a labeling function for more complex tooltips:

Mouse over the bubbles to view a country's data:

Out[3]=3

Display oil data for the G15 countries using PieChart for bubbles to indicate import and export:

Out[2]=2

Click the bubbles to hear the name of the country, its GDP per capita and its population:

Out[3]=3

Get population, weather and coordinate data of large Japanese cities:

Get a map of Japan:

Out[2]=2

Mouse over the bubbles to get city and temperature information:

Out[3]=3

Represent clusters of elements based on three properties:

Cluster the elements into groups based on the value of their properties:

Mouse over the bubbles to get element information:

Out[3]=3

Properties & Relations  (2)Properties of the function, and connections to other functions

Use BubbleChart3D to get a 3D rendering of bubble charts:

Out[1]=1

Use SectorChart3D and RectangleChart3D as alternative visualizations:

Out[1]=1

Neat Examples  (2)Surprising or curious use cases

Out[1]=1

Chartwork:

Out[1]=1
Wolfram Research (2008), BubbleChart, Wolfram Language function, https://reference.wolfram.com/language/ref/BubbleChart.html (updated 2025).
Wolfram Research (2008), BubbleChart, Wolfram Language function, https://reference.wolfram.com/language/ref/BubbleChart.html (updated 2025).

Text

Wolfram Research (2008), BubbleChart, Wolfram Language function, https://reference.wolfram.com/language/ref/BubbleChart.html (updated 2025).

Wolfram Research (2008), BubbleChart, Wolfram Language function, https://reference.wolfram.com/language/ref/BubbleChart.html (updated 2025).

CMS

Wolfram Language. 2008. "BubbleChart." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/BubbleChart.html.

Wolfram Language. 2008. "BubbleChart." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/BubbleChart.html.

APA

Wolfram Language. (2008). BubbleChart. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/BubbleChart.html

Wolfram Language. (2008). BubbleChart. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/BubbleChart.html

BibTeX

@misc{reference.wolfram_2025_bubblechart, author="Wolfram Research", title="{BubbleChart}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/BubbleChart.html}", note=[Accessed: 23-April-2025 ]}

@misc{reference.wolfram_2025_bubblechart, author="Wolfram Research", title="{BubbleChart}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/BubbleChart.html}", note=[Accessed: 23-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_bubblechart, organization={Wolfram Research}, title={BubbleChart}, year={2025}, url={https://reference.wolfram.com/language/ref/BubbleChart.html}, note=[Accessed: 23-April-2025 ]}

@online{reference.wolfram_2025_bubblechart, organization={Wolfram Research}, title={BubbleChart}, year={2025}, url={https://reference.wolfram.com/language/ref/BubbleChart.html}, note=[Accessed: 23-April-2025 ]}