File Applications/SpinW/m_files/sw_plotspec.m

  plots spin wave spectrum
 
  [fHandle, pHandle] = SW_PLOTSPEC(spectra, 'option1', value1 ...)
 
  Options:
 
  mode      Choose the type of plot, either a string (or number):
                'disp'  dispersion (1),
                'int'   intensity of the correlation functions (2),
                'color' convoluted spectrum (3),
                'fancy' FANCY PLOT MODE (default, 4).
  imag      Whether to plot the imaginary values of the dispersion
            and the correlation functions. For convoluted spectra, if true,
            the imaginary part is plotted. Default is false.
  aHandle   Handle of the axis object for plotting, if undefined the
            active axis will be used (gca).
  colorbar  Plot colorbar for dispersion and intensity, default is true.
  nCol      Number of colors in the colormap, default is 500.
  dashed    Whether to plot dashed vertical line between multiple linear
            scans. Defult is false.
  dE        FWHM value of convoluted Gaussian in energy to simulate finite
            energy resolution. Only works for mode=3. If zero, no
            convolution performed. Default is 0.
  fontSize  Font size on the plot, default is 14 pt.
  colormap  Colormap for plotting, default is @fireprint (good for color
            and B&W printing) for single plot and for multiple plot it will
            be a continuous scale from white to different color. This is
            the 'auto' mode. Also colormap can be given directly using
            standard colormaps, like @jet. To overplot multiple spectras
            'colormap' option will be a matrix, with dimensions [3 nConv],
            where every column defines a color for the maximum intensity.
            It is also used for plotting dispersion curves. In case a
            single color all dispersion curves have the same color (e.g.
            [255 0 0] for red), or as many colors as dispersion curves
            (dimensions are [3 nMode]), or any colormap can be given, like
            @jet. In this case every mode will have different colors, the
            color is determined from the index of the mode. Default is
            'auto'.
  sortMode  Sorting the modes before plotting. Default is false.
  axLim     Upper limit for y axis (mode 1,2) or z axis (mode 3), default
            is 'auto'. For color plot of multiple cross section the c axis
            cannot be changed after the plot.
  legend    Whether to plot legend for multiple convoluted spectras,
            default is true.
  title     Whether to plot figure title, default is true.
  twin      Select which twins to plot for omega plots, default plots all
            twins, dimensions are [1 nTwinToPlot].
  lineStyle Line style for line plots (dispersion and intensity), default
            is {'-' 'o-' '--'}. For example '--' gives dashed lines.
  lineWidth Line width of line plots, default is 0.5 point.
  log       Plot 10based logarithmic intensity, default is false.
  plotf     Plot function for color plot. Default is @surf.
  maxPatch  Maximum number of pixels that can be plotted using the patch()
            function within sw_surf(). Using patch for color plot can be
            slow on older machines, but the figure can be exported
            afterwards as a vector graphics, using the print() function.
            Default is 1000.
  norm      If true, the convolution with a Gaussian function (in case of
            non-zero 'dE' option) keeps the energy integrated intensity. If
            false the amplitude is kept constant. Default is the input
            spectra.norm value.
  figPos    Position of the figure window on the screen. The [1,1] position
            is the upper left corner of the screen, [2,1] is shifted
            downwards by 1 figure window height, [1,2] is shifted right by
            1 figure window width relative to the [1,1] position. Default
            is [0,0] where the figure window will not be moved from the
            original position.
 
  Output:
 
  fHandle   Handle of the plot figure.
  pHandle   Handle of the graphics objects on the figure.
 
  See also SW.PLOT, SW.SPINWAVE, SW_SURF.