scatter3 (MATLAB Functions)

3-D scatter plot

Syntax

scatter3(X,Y,Z,S,C)
scatter3(X,Y,Z)
scatter3(X,Y,Z,S)
scatter3(...,markertype)
scatter3(...,'filled')
h = scatter3(...,)
hpatch = scatter3('v6',...)

Description

scatter3(X,Y,Z,S,C) displays colored circles at the locations specified by the vectors X, Y, and Z (which must all be the same size).

S determines the size of each marker (specified in points). S can be a vector the same length as X, Y, and Z or a scalar. If S is a scalar, MATLAB draws all the markers the same size.

C determines the colors of each marker. When C is a vector the same length as X, Y, and Z, the values in C are linearly mapped to the colors in the current colormap. When C is a length(X)-by-3 matrix, it specifies the colors of the markers as RGB values. C can also be a color string (see ColorSpec for a list of color string specifiers).

scatter3(X,Y,Z) draws the markers in the default size and color.

scatter3(X,Y,Z,S) draws the markers at the specified sizes (S) with a single color.

scatter3(...,markertype) uses the marker type specified instead of 'o' (see LineSpec for a list of marker specifiers).

scatter3(...,'filled') fills the markers.

h = scatter3(...) returns handles to the scattergroup objects created by scatter3. See Scattergroup Properties for property descriptions.

Backward Compatible Version

hpatch = scatter3('v6',...) returns the handles to the patch objects created by scatter3 (see Patch for a list of properties you can specify using the object handles and set).

Remarks

Use plot3 for single color, single marker size 3-D scatter plots.

Examples

[x,y,z] = sphere(16);
X = [x(:)*.5 x(:)*.75 x(:)];
Y = [y(:)*.5 y(:)*.75 y(:)];
Z = [z(:)*.5 z(:)*.75 z(:)];
S = repmat([1 .75 .5]*10,prod(size(x)),1);
C = repmat([1 2 3],prod(size(x)),1);
scatter3(X(:),Y(:),Z(:),S(:),C(:),'filled'), view(-60,60)

See Also

scatter, plot3

See Scattergroup Properties for property descriptions

Scatter/Bubble Plots for related functions

scatter Scattergroup Properties