bubblechart3
Syntax
Description
Vector and Matrix Data
bubblechart3(
displays colored circular markers (bubbles) at the locations specified by
x
,y
,z
,sz
)x
, y
, and z
, with bubble sizes
specified by sz
.
To plot one set of coordinates, specify
x
,y
,z
, andsz
as vectors of equal length.To plot multiple sets of coordinates on the same set of axes, specify at least one of
x
,y
,z
, orsz
as a matrix.
Table Data
bubblechart3(
plots the variables tbl
,xvar
,yvar
,zvar
,sizevar
)xvar
, yvar
, and
zvar
from the table tbl
and uses the variable
sizevar
for the bubble sizes. To plot one data set, specify one
variable each for xvar
, yvar
,
zvar
, and sizevar
. To plot multiple data sets,
specify multiple variables for at least one of those arguments. The arguments that specify
multiple variables must specify the same number of variables.
Additional Options
bubblechart3(
displays
the bubble chart in the target axes ax
,___)ax
. Specify the axes before all
other input arguments.
bubblechart3(___,
specifies Name,Value
)BubbleChart
properties using one or more name-value
arguments. Specify the properties after all other input arguments. For example,
bubblechart3(x,y,z,'LineWidth',2)
creates a bubble chart with 2-point
marker outlines. For a list of properties, see BubbleChart Properties.
bc = bubblechart3(___)
returns the
BubbleChart
object. Use bc
to modify properties of
the chart after creating it. For a list of properties, see BubbleChart Properties.
Examples
Plot Random Bubbles
Define a set of bubble coordinates as the vectors x
, y
, and z
. Define sz
as a vector that specifies the bubble sizes. Then create a bubble chart of x
, y
, and z
.
x = rand(1,20); y = rand(1,20); z = rand(1,20); sz = rand(1,20); bubblechart3(x,y,z,sz);
Specify Bubble Colors
Define a set of bubble coordinates as the vectors x
, y
, and z
. Define sz
as a vector that specifies the bubble sizes. Then create a bubble chart of x
, y
, and z
, and specify the color as red. By default, the bubbles are partially transparent.
x = rand(1,20);
y = rand(1,20);
z = rand(1,20);
sz = rand(1,20);
bubblechart3(x,y,z,sz,'red');
For a custom color, you can specify an RGB triplet or a hexadecimal color code. For example, the hexadecimal color code '#7031BB'
, specifies a shade of purple.
bubblechart3(x,y,z,sz,'#7031BB');
You can also specify a different color for each bubble. For example, specify a vector to select colors from the figure's colormap.
c = 1:20; bubblechart3(x,y,z,sz,c)
Specify Bubble Transparency and Outline Color
Define a set of bubble coordinates as the vectors x
, y
, and z
. Define sz
as a vector that specifies the bubble sizes. Then create a bubble chart of x
, y
, and z
. By default, the bubbles are 60% opaque, and the edges are completely opaque with the same color.
x = rand(1,20); y = rand(1,20); z = rand(1,20); sz = rand(1,20); bubblechart3(x,y,z,sz);
You can customize the opacity and the outline color by setting the MarkerFaceAlpha
and MarkerEdgeColor
properties, respectively. One way to set a property is by specifying a name-value pair argument when you create the chart. For example, you can specify 20% opacity by setting the MarkerFaceAlpha
value to 0.20
.
bc = bubblechart3(x,y,z,sz,'MarkerFaceAlpha',0.20);
If you create the chart by calling the bubblechart3
function with a return argument, you can use the return argument to set properties on the chart after creating it. For example, you can change the outline color to purple.
bc.MarkerEdgeColor = [0.5 0 0.5];
Add a Bubble Legend
Define a data set that shows the contamination levels of a certain toxin across different towns in a metropolitan area.
Define
towns
as the populations of the towns.Define
nsites
as the number of industrial sites in the corresponding towns.Define
nregulated
as the number of industrial sites that conform to the local environmental regulations.Define
levels
as the contamination levels in the towns.
towns = randi([25000 500000],[1 30]); nsites = randi(10,1,30); nregulated = (-3 * nsites) + (5 * randn(1,30) + 20); levels = (3 * nsites) + (7 * randn(1,30) + 20);
Display the data in a bubble chart. Create axis labels using the xlabel
, ylabel
, and zlabel
functions. Use the bubblesize
function to make all the bubbles between 5 and 30 points in diameter. Then add a bubble legend that shows the relationship between bubble size and population.
bubblechart3(nsites,nregulated,levels,towns) xlabel('Industrial Sites') ylabel('Regulated Sites') zlabel('Contamination Level') bubblesize([5 30]) bubblelegend('Town Population','Location','eastoutside')
Plot Data from a Table
A convenient way to plot data from a table is to pass the table to the bubblechart3
function and specify the variables you want to plot. For example, create a table with five variables of random numbers. Plot the X1
, Y
, Z
and Sz
variables by passing the table as the first argument to the bubblechart3
function followed by the variable names. By default, the axis labels match the variable names.
tbl = table(randn(15,1)-10,randn(15,1)+10,rand(15,1), ... rand(15,1),rand(15,1), ... 'VariableNames',{'X1','X2','Y','Z','Sz'}); bubblechart3(tbl,'X1','Y','Z','Sz')
You can also plot multiple variables at the same time. For example, plot X1
and X2
on the x-axis by specifying the xvar
argument as the cell array {'X1','X2'}
. Then add a legend. The legend labels match the variable names.
bubblechart3(tbl,{'X1','X2'},'Y','Z','Sz') legend
Plot Table Data with Custom Colors
You can plot data from a table and customize the colors by specifying the cvar
argument when you call bubblechart3
.
For example, create a table with five variables of random numbers, and plot the X
, Y
, and Z
variables. Vary the bubble sizes according to the Sz
variable, and vary the colors according to the Colors
variable.
tbl = table(randn(15,1)-10,randn(15,1)+10,rand(15,1), ... rand(15,1),rand(15,1), ... 'VariableNames',{'X','Y','Z','Sz','Colors'}); bubblechart3(tbl,'X','Y','Z','Sz','Colors');
Display Bubbles in Different Axes on the Same Scale
Define two sets of data that show the contamination levels of a certain toxin across different towns on the east and west sides of a certain metropolitan area.
Define
towns1
and
towns2
as the populations of the towns.Define
nsites1
andnsites2
as the number of industrial sites in the corresponding towns.Define
nregulated1
andnregulated2
as the number of industrial sites that conform to the local environmental regulations.Define
levels1
andlevels2
as the contamination levels in the towns.
towns1 = randi([25000 500000],[1 30]); towns2 = towns1/3; nsites1 = randi(10,1,30); nsites2 = randi(10,1,30); nregulated1 = (-3 * nsites1) + (5 * randn(1,30) + 20); nregulated2 = (-2 * nsites2) + (5 * randn(1,30) + 20); levels1 = (3 * nsites1) + (7 * randn(1,30) + 20); levels2 = (5 * nsites2) + (7 * randn(1,30) + 20);
Create a tiled chart layout so you can visualize the data side-by-side. Then create an axes object in the first tile and plot the data for the east side of the city. Add a title and axis labels. Then repeat the process in the second tile to plot the west side data.
tiledlayout(2,1,'TileSpacing','compact') ax1 = nexttile; % East side bubblechart3(ax1,nsites1,nregulated1,levels1,towns1); title('East Side') xlabel('Industrial Sites') ylabel('Regulated Sites') zlabel('Contamination Level') % West side ax2 = nexttile; bubblechart3(ax2,nsites2,nregulated2,levels2,towns2); title('West Side') xlabel('Industrial Sites') ylabel('Regulated Sites') zlabel('Contamination Level')
Reduce all the bubble sizes to make it easier to see all the bubbles. In this case, change the range of diameters to be between 5
and 20
points.
bubblesize(ax1,[5 20]) bubblesize(ax2,[5 20])
The east side towns are three times the size of the west side towns, but the bubble sizes do not reflect this information in the preceding charts. This is because the smallest and largest bubbles map to the smallest and largest data points in each of the axes. To display the bubbles on the same scale, define a vector called alltowns
that includes the populations from both sides of the city. The use the bubblelim
function to reset the scaling for both charts.
alltowns = [towns1 towns2]; newlims = [min(alltowns) max(alltowns)]; bubblelim(ax1,newlims) bubblelim(ax2,newlims)
Input Arguments
x
— x-coordinates
scalar | vector | matrix
x-coordinates, specified as a scalar, vector, or matrix. The size
and shape of x
depends on the shape of your data. This table
describes the most common situations.
Type of Bubble Chart | How to Specify Coordinates |
---|---|
Single bubble | Specify bubblechart3(1,2,3,10) |
One set of bubbles | Specify x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles | If all the data sets share coordinates in one or more dimensions, specify the shared coordinates as a vector and the other coordinates as matrices. The length of the vector must match one of the dimensions of the matrices. For example, plot two data sets that share the same x-coordinates and size values. x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) bubblechart3 plots a separate
set of bubbles for each column in the matrices.Alternatively,
specify x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz) |
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
y
— y-coordinates
scalar | vector | matrix
y-coordinates, specified as a scalar, vector, or matrix. The size
and shape of y
depends on the shape of your data. This table
describes the most common situations.
Type of Bubble Chart | How to Specify Coordinates |
---|---|
Single bubble | Specify bubblechart3(1,2,3,10) |
One set of bubbles | Specify x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles | If all the data sets share coordinates in one or more dimensions, specify the shared coordinates as a vector and the other coordinates as matrices. The length of the vector must match one of the dimensions of the matrices. For example, plot two data sets that share the same x-coordinates and size values. x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) bubblechart3 plots a separate
set of bubbles for each column in the matrices.Alternatively,
specify x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz) |
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
z
— z-coordinates
scalar | vector | matrix
z-coordinates, specified as a scalar, vector, or matrix. The size
and shape of z
depends on the shape of your data. This table
describes the most common situations.
Type of Bubble Chart | How to Specify Coordinates |
---|---|
Single bubble | Specify bubblechart3(1,2,3,10) |
One set of bubbles | Specify x = [1 2 3 4]; y = [4; 5; 6; 7]; z = [8 9 10 11]; sz = [12 13 14 15]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles | If all the data sets share coordinates in one or more dimensions, specify the shared coordinates as a vector and the other coordinates as matrices. The length of the vector must match one of the dimensions of the matrices. For example, plot two data sets that share the same x-coordinates and size values. x = [1 2 3 4]; y = [4 5 6 7; 7 8 9 10]; z = [10 11 12 13; 14 15 16 17]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz) bubblechart3 plots a separate
set of bubbles for each column in the matrix.Alternatively,
specify x = [1 1; 2 2; 3 3; 4 4]; y = [4 7; 5 8; 6 9; 7 10]; z = [10 14; 11 15; 12 16; 13 17]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz) |
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
sz
— Bubble sizes
numeric scalar | vector | matrix
Relative bubble sizes, specified as a numeric scalar, vector, or matrix.
The sz
values control the relative distribution of the bubble
sizes. By default, bubblechart3
linearly maps a range of bubble
areas across the range of the sz
values for all the bubble charts in
the axes. For more control over the absolute bubble sizes, and how they map across the
range of the sz
values, see bubblesize
and bubblelim
.
Whether you specify sz
as a scalar, vector, or matrix depends on
how you specify x
, y
, and z
and
how you want the chart to look. This table describes the most common situations.
Type of Bubble Chart | x , y , and z
| sz | Example |
---|---|---|---|
One set of bubbles | Vectors of the same length | A vector with the same length as | Specify x = [1 2 3 4]; y = [4 5 6 7]; z = [8 9 10 11]; sz = [80 150 700 50]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles that have varied coordinates and bubble sizes | At least one of | A matrix that has the same size as the | Specify x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; z = [10 11; 12 13; 14 15; 16 17]; sz = [80 30; 150 900; 50 2000; 200 350]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles, where all the coordinates are shared, but the sizes are different for each data set | Vectors of the same length | A matrix with at least one dimension that matches the lengths of
| Specify x = [1 2 3 4]; y = [5 6 7 8]; z = [9 10 11 12]; sz = [80 30; 150 900; 50 500; 200 350]; bubblechart3(x,y,z,sz) |
Multiple sets of bubbles, where the coordinates vary in at least one dimension, but the sizes are shared between data sets | At least one of | A vector with the same number of elements as there are bubbles in each data set | Specify x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; z = [2 8; 3 10; 4 7; 4 12]; sz = [80 150 200 350]; bubblechart3(x,y,z,sz) |
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
c
— Bubble color
[0 0.4470 0.7410]
(default) | color name | RGB triplet | matrix of RGB triplets | vector of colormap indices
Bubble color, specified as a color name, RGB triplet, matrix of RGB triplets, or a vector of colormap indices.
Color name — A color name such as
"red"
, or a short name such as"r"
.RGB triplet — A three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]
; for example,[0.4 0.6 0.7]
. RGB triplets are useful for creating custom colors.Matrix of RGB triplets — A three-column matrix in which each row is an RGB triplet.
Vector of colormap indices — A vector of numeric values that is the same length as the
x
,y
, andz
vectors.
The way you specify the color depends on the preferred color scheme and whether you are plotting one set of bubbles or multiple sets of bubbles. This table describes the most common situations.
Color Scheme | How to Specify the Color | Example |
---|---|---|
Use one color for all the bubbles. | Specify a color name or a short name from the table below, or specify one RGB triplet. | Display one set of bubbles, and specify the color as
x = [1 2 3 4];
y = [2 5 3 6];
z = [10 6 4 7];
sz = [1 2 3 4];
bubblechart3(x,y,z,sz,"red") Display
two sets of bubbles, and specify the color as red using the RGB triplet
x = [1 2 3 4]; y = [2 5 3 6]; z = [2 5; 1 2; 8 4; 7 9]; sz = [1 2; 3 4; 5 6; 7 8]; bubblechart3(x,y,z,sz,[1 0 0]) |
Assign different colors to each bubble using a colormap. | Specify a row or column vector of numbers. The numbers map into the current colormap array. The smallest value maps to the first row in the colormap, and the largest value maps to the last row. The intermediate values map linearly to the intermediate rows. If your chart has three bubbles, specify a column vector to ensure the values are interpreted as colormap indices. You can use this method only when
| Create a vector c = [1 2 3 4];
x = [1 2 3 4];
y = [5 6 7 8];
z = [7 8 9 10];
sz = [1 2 3 4];
bubblechart3(x,y,z,sz,c)
colormap(gca,"winter") |
Create a custom color for each bubble. | Specify an m-by-3 matrix of RGB triplets, where m is the number of bubbles. You can use this method only when
| Create a matrix c = [0 1 0; 1 0 0; 0.5 0.5 0.5; 0.6 0 1]; x = [1 2 3 4]; y = [5 6 7 8]; z = [7 8 9 10]; sz = [1 2 3 4]; bubblechart3(x,y,z,sz,c) |
Create a different color for each data set. | Specify an n-by-3 matrix of RGB triplets, where n is the number of data sets. You can use this method only when at least one of
| Create a matrix c = [1 0 0; 0.6 0 1]; x = [1 2 3 4]; y = [5 6 7 8]; z = [2 5; 1 2; 8 4; 11 9]; sz = [1 1; 2 2; 3 3; 4 4]; bubblechart3(x,y,z,sz,c) |
Color Names and RGB Triplets for Common Colors
Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan"
| "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB® uses in many types of plots.
RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
tbl
— Source table
table | timetable
Source table containing the data to plot, specified as a table or a timetable.
xvar
— Table variables containing x-coordinates
one or more table variable indices
Table variables containing the x-coordinates, specified as one or more table variable indices.
Specifying Table Indices
Use any of the following indexing schemes to specify the desired variable or variables.
Indexing Scheme | Examples |
---|---|
Variable names:
|
|
Variable index:
|
|
Variable type:
|
|
Plotting Your Data
The table variables you specify can contain numeric, categorical, datetime, or duration values.
To plot one data set, specify one variable each for xvar
,
yvar
, zvar
, sizevar
, and
optionally cvar
. For example, read Patients.xls
into
the table tbl
. Plot the Height
,
Weight
, and Diastolic
variables, and vary the
bubble sizes according to the Age
variable.
tbl = readtable('Patients.xls'); bubblechart3(tbl,'Height','Weight','Diastolic','Age')
To plot multiple data sets together, specify multiple variables for at least one of
xvar
, yvar
, zvar
,
sizevar
, or optionally cvar
. If you specify
multiple variables for more than one argument, the number of variables must be the same for
each of those arguments.
For example, plot the Weight
variable on the x-axis, the
Height
variable on the y-axis, and the
Systolic
and Diastolic
variables on the
z-axis. Specify the Age
variable for the bubble
sizes.
bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')
You can also use different indexing schemes for the table variables. For example, specify xvar
and xvar
as variable names, zvar
as an index number, and sizevar
as a logical vector.
bubblechart3(tbl,'Height','Weight',9,[false false true])
yvar
— Table variables containing y-coordinates
one or more table variable indices
Table variables containing the y-coordinates, specified as one or more table variable indices.
Specifying Table Indices
Use any of the following indexing schemes to specify the desired variable or variables.
Indexing Scheme | Examples |
---|---|
Variable names:
|
|
Variable index:
|
|
Variable type:
|
|
Plotting Your Data
The table variables you specify can contain numeric, categorical, datetime, or duration values.
To plot one data set, specify one variable each for xvar
,
yvar
, zvar
, sizevar
, and
optionally cvar
. For example, read Patients.xls
into
the table tbl
. Plot the Height
,
Weight
, and Diastolic
variables, and vary the
bubble sizes according to the Age
variable.
tbl = readtable('Patients.xls'); bubblechart3(tbl,'Height','Weight','Diastolic','Age')
To plot multiple data sets together, specify multiple variables for at least one of
xvar
, yvar
, zvar
,
sizevar
, or optionally cvar
. If you specify
multiple variables for more than one argument, the number of variables must be the same for
each of those arguments.
For example, plot the Weight
variable on the x-axis, the
Height
variable on the y-axis, and the
Systolic
and Diastolic
variables on the
z-axis. Specify the Age
variable for the bubble
sizes.
bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')
You can also use different indexing schemes for the table variables. For example, specify xvar
and xvar
as variable names, zvar
as an index number, and sizevar
as a logical vector.
bubblechart3(tbl,'Height','Weight',9,[false false true])
zvar
— Table variables containing z-coordinates
one or more table variable indices
Table variables containing the z-coordinates, specified as one or more table variable indices.
Specifying Table Indices
Use any of the following indexing schemes to specify the desired variable or variables.
Indexing Scheme | Examples |
---|---|
Variable names:
|
|
Variable index:
|
|
Variable type:
|
|
Plotting Your Data
The table variables you specify can contain numeric, categorical, datetime, or duration values.
To plot one data set, specify one variable each for xvar
,
yvar
, zvar
, sizevar
, and
optionally cvar
. For example, read Patients.xls
into
the table tbl
. Plot the Height
,
Weight
, and Diastolic
variables, and vary the
bubble sizes according to the Age
variable.
tbl = readtable('Patients.xls'); bubblechart3(tbl,'Height','Weight','Diastolic','Age')
To plot multiple data sets together, specify multiple variables for at least one of
xvar
, yvar
, zvar
,
sizevar
, or optionally cvar
. If you specify
multiple variables for more than one argument, the number of variables must be the same for
each of those arguments.
For example, plot the Weight
variable on the x-axis, the
Height
variable on the y-axis, and the
Systolic
and Diastolic
variables on the
z-axis. Specify the Age
variable for the bubble
sizes.
bubblechart3(tbl,'Weight','Height',{'Systolic','Diastolic'},'Age')
You can also use different indexing schemes for the table variables. For example, specify xvar
and xvar
as variable names, zvar
as an index number, and sizevar
as a logical vector.
bubblechart3(tbl,'Height','Weight',9,[false false true])
sizevar
— Table variables for bubble sizes
one or more table variable indices
Table variables containing the bubble size data, specified as one or more table variable indices.
Specifying Table Indices
Use any of the following indexing schemes to specify the desired variable or variables.
Indexing Scheme | Examples |
---|---|
Variable names:
|
|
Variable index:
|
|
Variable type:
|
|
Plotting Your Data
The table variables you specify can contain any type of numeric values.
If you are plotting one data set, specify one variable for
sizevar
. For example, read Patients.xls
into
the table tbl
. Plot the Height
,
Weight
, and Diastolic
variables, and vary the
bubble sizes according to the Age
variable.
tbl = readtable('Patients.xls'); bubblechart3(tbl,'Height','Weight','Diastolic','Age')
If you are plotting multiple data sets, you can specify multiple variables for at
least one of xvar
, yvar
,
zvar
, sizevar
, or optionally
cvar
. If you specify multiple variables for more than one
argument, the number of variables must be the same for each of those arguments.
For example, plot the Weight
variable on the
x-axis, the Height
variable on the
y-axis, and the Age
variable on the
z-axis. Specify the Systolic
and
Diastolic
variables for the bubble sizes. The resulting plot
shows two sets of bubbles with the same coordinates, but different bubble
sizes.
bubblechart3(tbl,'Weight','Height','Age',{'Systolic','Diastolic'})
cvar
— Table variables for bubble colors
one or more table variable indices
Table variables containing the bubble color data, specified as one or more table variable indices.
Specifying Table Indices
Use any of the following indexing schemes to specify the desired variable or variables.
Indexing Scheme | Examples |
---|---|
Variable names:
|
|
Variable index:
|
|
Variable type:
|
|
Plotting Your Data
The table variables you specify can contain values of any numeric type. Each variable can be:
A column of numbers that linearly map into the current colormap.
A three-column array of RGB triplets. RGB triplets are three-element vectors whose values specify the intensities of the red, green, and blue components of specific colors. The intensities must be in the range
[0,1]
. For example,[0.5 0.7 1]
specifies a shade of light blue.
If you are plotting one data set, specify one variable for
cvar
. For example, create a table with seven variables of random
numbers. Plot the X1
, Y
, and
Z
variables. Vary the bubble sizes according to the
SZ
variable, and vary the colors according to the
Color1
variable.
tbl = table(randn(50,1)-10,randn(50,1)+10,rand(50,1), ... rand(50,1),rand(50,1),rand(50,1),rand(50,1),... 'VariableNames',{'X1','X2','Y','Z','SZ','Color1','Color2'}); bubblechart3(tbl,'X1','Y','Z','SZ','Color1')
If you are plotting multiple data sets, you can specify multiple variables for at
least one of xvar
, yvar
,
zvar
, sizevar
, or cvar
. If
you specify multiple variables for more than one argument, the number of variables
must be the same for each of those arguments.
For example, plot the X1
and X2
variables on
the x-axis, the Y
variable on the
y-axis, and the Z
variable on the
z-axis. Vary the bubble sizes according to the
SZ
variable. Specify the Color1
and
Color2
variables for the colors. The resulting plot shows two
sets of bubbles with the same y-coordinates,
z-coordinates, and bubble sizes, but different
x-coordinates and
colors.
bubblechart3(tbl,{'X1','X2'},'Y','Z','SZ',{'Color1','Color2'})
ax
— Target axes
Axes
object
Target axes, specified as an Axes
object. If you do not specify
the axes, MATLAB plots into the current axes, or it creates an Axes
object if one does not exist.
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: bubblechart3([2 1 5],[4 10 9],[1 2 3],[1 2
3],'MarkerFaceColor','red')
creates red bubbles.
Note
The properties listed here are only a subset. For a complete list, see BubbleChart Properties.
MarkerEdgeColor
— Marker outline color
"flat"
(default) | RGB triplet | hexadecimal color code | "r"
| "g"
| "b"
| ...
Marker outline color, specified "flat"
, an RGB triplet, a hexadecimal color
code, a color name, or a short name. The default value of "flat"
uses
colors from the CData
property.
For a custom color, specify an RGB triplet or a hexadecimal color code.
An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]
, for example,[0.4 0.6 0.7]
.A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (
#
) followed by three or six hexadecimal digits, which can range from0
toF
. The values are not case sensitive. Therefore, the color codes"#FF8800"
,"#ff8800"
,"#F80"
, and"#f80"
are equivalent.
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.
Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan"
| "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | Not applicable | Not applicable | Not applicable | No color |
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.
RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
Example: [0.5 0.5 0.5]
Example: "blue"
Example: "#D2F9A7"
MarkerFaceColor
— Marker fill color
'flat'
(default) | 'auto'
| 'none'
| RGB triplet | hexadecimal color code | 'r'
| 'g'
| 'b'
| ...
Marker fill color, specified as 'flat'
, 'auto'
, an RGB triplet, a hexadecimal color code, a color name, or a short name. The 'flat'
option uses the CData
values. The 'auto'
option uses the same color as the Color
property for the axes.
For a custom color, specify an RGB triplet or a hexadecimal color code.
An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]
, for example,[0.4 0.6 0.7]
.A hexadecimal color code is a string scalar or character vector that starts with a hash symbol (
#
) followed by three or six hexadecimal digits, which can range from0
toF
. The values are not case sensitive. Therefore, the color codes"#FF8800"
,"#ff8800"
,"#F80"
, and"#f80"
are equivalent.
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.
Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan"
| "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" | |
"none" | Not applicable | Not applicable | Not applicable | No color |
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.
RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
Example: [0.3 0.2 0.1]
Example: 'green'
Example: '#D2F9A7'
LineWidth
— Width of marker edge
0.5
(default) | positive value
Width of marker edge, specified as a positive value in point units.
Example: 0.75
MarkerEdgeAlpha
— Marker edge transparency
1
(default) | scalar in range [0,1]
| 'flat'
Marker edge transparency, specified as a scalar in the range [0,1]
or 'flat'
. A value of 1 is opaque and 0 is completely transparent.
Values between 0 and 1 are semitransparent.
To set the edge transparency to a different value for each point in the plot, set the
AlphaData
property to a vector the same size as the
XData
property, and set the
MarkerEdgeAlpha
property to 'flat'
.
MarkerFaceAlpha
— Marker face transparency
0.6
(default) | scalar in range [0,1]
| 'flat'
Marker face transparency, specified as a scalar in the range [0,1]
or 'flat'
. A value of 1 is opaque and 0 is completely transparent. Values between 0 and 1 are partially transparent.
To set the marker face transparency to a different value for each point, set the AlphaData
property to a vector the same size as the XData
property, and set the MarkerFaceAlpha
property to 'flat'
.
Version History
Introduced in R2020bR2022b: Plots created with tables preserve special characters in axis and legend labels
When you pass a table and one or more variable names to the bubblechart3
function, the axis and legend labels now display any special characters that are included in the table variable names, such as underscores. Previously, special characters were interpreted as TeX or LaTeX characters.
For example, if you pass a table containing a variable named Sample_Number
to the bubblechart3
function, the underscore appears in the axis and
legend labels. In R2022a and earlier releases, the underscores are interpreted as
subscripts.
Release | Label for Table Variable "Sample_Number" |
---|---|
R2022b |
|
R2022a |
|
To display axis and legend labels with TeX or LaTeX formatting, specify the labels manually.
For example, after plotting, call the xlabel
or
legend
function with the desired label strings.
xlabel("Sample_Number") legend(["Sample_Number" "Another_Legend_Label"])
R2022a: Plot multiple data sets at once using matrices
The bubblechart3
function now accepts combinations of vectors and matrices for the coordinates and size data. As a result, you can visualize multiple data sets at once rather than using the hold
function between plotting commands.
R2021b: Pass tables directly to bubblechart3
Create plots by passing a table to the bubblechart3
function followed by the variables you want to plot. When you specify your data as a table, the axis labels and the legend (if present) are automatically labeled using the table variable names.
See Also
Functions
Properties
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)