imat_fn/plot3


Purpose

Plot an imat_fn on a 3D axis in a special figure window.

Syntax

plot3(f)
plot3(f1,f2,...)
h=plot3(f)
[h,ha]=plot3(f,handle)
plot3(f,'xscale','linear','yscale','log','grid','','complex','m','xwin',[100 200],'ywin',[1e-1 1e4],'tags',[100 1; 200 2],'silent')

Description

PLOT3(F, ...) plots all the functions in F as a sequence of adjacent lines in 3 dimensions.H is an optional output containing the figure handle. HA is an optional output containing the axis handle.

If an axis or figure handle is supplied, PLOT3 will draw the new plot into the existing axis or figure.

You can control the plot formatting by passing in the following string or strings followed by the appropriate value. To save typing, you can use only a prefix of the option name, as long as that prefix is unique.

'style' Choose the plot style ('wires', 'plates', 'surface', 'mesh'). 'wires' plots each function as a single line. 'plates' displays functions as parallel filled plates. 'surface' covers the functions with a faceted mesh. 'mesh' displays the functions as a 3-D mesh surface whose colors are a function of the magnitude (Z axis) of the data being displayed.
'complex' Set the complex option. Valid choices are

'm'

Modulus (amplitude).

'p'

Phase in degrees. Append 'c' to enable Cleaned Phase (i.e. 'pc').

'r'

Real portion.

'i'

Imaginary portion.

'tags' Draw tags into the plot window. To tag on data, provide an Mx2 matrix with [x y] values in each row. To tag in space, provide an Mx3 matrix with rows containing [x y z]. You may also tag on data using an Mx3 with rows containing [x y Inf].
'taglbls' Choose which dimensions ('x','y','z') to display in the text label for each tag. (i.e. 'xyz','zyx','xz'). This setting applies to all tags which come after it, but not before.
'xwindow' Set the X axis window range. Follow with a 1x2 vector containing the minimum and maximum window values. Use -Inf and/or Inf to enable automatic tight fitting in that direction. The default is [-Inf,Inf] for all dimensions.
'ywindow' Set the Y axis window range. Follow with a 1x2 vector containing the minimum and maximum window values. Use -Inf and/or Inf to enable automatic tight fitting in that direction. The default is [-Inf,Inf] for all dimensions.
'zwindow' Set the Z axis window range. Follow with a 1x2 vector containing the minimum and maximum window values. Use -Inf and/or Inf to enable automatic tight fitting in that direction. The default is [-Inf,Inf] for all dimensions.
'xscale' Set the X axis type ('linear' or 'log')
'yscale' Set the Y axis type ('linear' or 'log')
'zscale' Set the Z axis type ('linear' or 'log')
'grid' Set the grid option. Use any combination of 'x','y', and 'z'. (i.e. '', 'xy', 'xz', or 'xyz')
'renderer' Select a graphics renderer, either 'opengl' or 'zbuffer'. OpenGL is typically faster, but it does not currently support Log scales. Each renderer has its own quirks, so you may want to try both, depending on your needs.
'silent' Suppress message output.

 

All plot options (except tag in space) are also available through the GUI's context menus.

Examples

>> plot3(f,'style','plates','complex','p','grid','xyz')    % Plate plot of phase with X,Y, and Z gridlines

See Also

imat_fn/plot