bubblechart3

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.

bubblechart3(1,2,3,10)

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)

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)

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-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.

bubblechart3(1,2,3,10)

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)

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)

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-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.

bubblechart3(1,2,3,10)

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)

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)

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

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.

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)

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)

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)

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

Bubble color, specified as a color name, RGB triplet, matrix of RGB triplets, or a vector of colormap indices.

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.

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")

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])

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")

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)

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

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB^® uses in many types of plots.

Source table containing the data to plot, specified as a table or a timetable.

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.

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])

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.

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])

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.

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])

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.

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'})

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.

Plotting Your Data

The table variables you specify can contain values of any numeric type. Each variable can be:

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'})

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.