MATLAB Function Reference

scatter3

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(...,)
  

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 the handles to the line objects created by scatter3 (see line 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

Scatter Plots for related functions

scatter

schur