MATLAB Function Reference |

**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 Plots for related functions

scatter | schur |