MATLAB Function Reference Previous page   Next Page
scatter3

3-D scatter plot

Syntax

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

See Also

scatter, plot3

See Scattergroup Properties for property descriptions

Scatter/Bubble Plots for related functions


Previous page  scatter Scattergroup Properties Next page

© 1994-2005 The MathWorks, Inc.