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

`scatter`, `plot3`