Accelerating the pace of engineering and science

# Documentation Center

• Trial Software
• Product Updates

# quiver3

3-D quiver or velocity plot

## Syntax

quiver3(x,y,z,u,v,w)
quiver3(z,u,v,w)
quiver3(...,scale)
quiver3(...,LineSpec)
quiver3(...,LineSpec,'filled')
quiver3(...,'PropertyName',PropertyValue,...)
quiver3(axes_handle,...)
h = quiver3(...)

## Description

A three-dimensional quiver plot displays vectors with components (u,v,w) at the points (x,y,z), where u,v,w,x,y, and z all have real (non-complex) values.

quiver3(x,y,z,u,v,w) plots vectors with components (u,v,w) at the points (x,y,z). The matrices x,y,z,u,v,w must all be the same size and contain the corresponding position and vector components.

quiver3(z,u,v,w) plots the vectors at the equally spaced surface points specified by matrix z. quiver3 automatically scales the vectors based on the distance between them to prevent them from overlapping.

quiver3(...,scale) automatically scales the vectors to prevent them from overlapping, and then multiplies them by scale. scale = 2 doubles their relative length, and scale = 0.5 halves them. Use scale = 0 to plot the vectors without the automatic scaling.

quiver3(...,LineSpec) specifies line style, marker symbol, and color using any valid LineSpec. quiver3 draws the markers at the origin of the vectors.

quiver3(...,LineSpec,'filled') fills markers specified by LineSpec.

quiver3(...,'PropertyName',PropertyValue,...) specifies property name and property value pairs for the quivergroup object the function creates.

quiver3(axes_handle,...) plots into the axes with the handle axes_handle instead of into the current axes (gca).

h = quiver3(...) returns a handle to the quivergroup object.

## Examples

expand all

### Plot Surface Normals

Plot the surface normals of the function .

```[X,Y] = meshgrid(-2:0.25:2,-1:0.2:1);
Z = X.* exp(-X.^2 - Y.^2);
[U,V,W] = surfnorm(X,Y,Z);

figure
quiver3(X,Y,Z,U,V,W,0.5);

hold on
surf(X,Y,Z);
view(-35,45)
axis ([-2 2 -1 1 -.6 .6])
hold off
```

## See Also

Was this topic helpful?