plotOI

 Gateway routine to plot optical image properties

       udata = plotOI([oi],[pType='hlineilluminance'],[xy])

   This plots the irradiance or illuminance data in the optical image.
   Mainly these are plotted as a function of spatial position or spatial
   frequency. 

   These values of plot type are 

     {'hlineirradiance'}     - Horizontal line radiance plot (space x wavelength)
     {'hlineilluminance'}    - Horizontal line illuminance
     {'hlineilluminancefft'} - Horizontal line illuminance fft
     {'hlinecontrast'}       - Horizontal line contrast at a wavelength
     {'vlineirradiance'}     - Vertical line irradiance (space x wavelength)
     {'vlineilluminance'}    - Vertical line luminance
     {'vlineilluminancefft'} - Vertical line luminance FFT
     {'vlinecontrast'}       - Vertical line contrast
     {'radiancefft'}         - 2D FFT of radiance at some wavelength
     {'illuminancefft'}      - 2D FFT of illuminance
     {'irradianceimagewithgrid'}  - Show spatial grid on irradiance image

   When called from the oiWindow callbacks, the user is presented with a
   cursor to indicate the horizontal or vertical position.  Because of
   difficulties in setting the focus for  ieGetXYCoords(oi), when called
   from the command line you should set the (x,y) position.
 
 See also:  plotScene, plotOTF

 Example:
     oi = vcGetObject('OI');
     rows = round(oiGet(oi,'rows')/2);
     plotOI(oi,'hlineirradiance',[1,rows])
     uData = plotOI(oi,'ffthlineilluminance',[1,rows])

     plotOI(oi,'hlinecontrast',[1,rows])

     plotOI(oi,'irradianceimagewithgrid')

 Copyright ImagEval Consultants, LLC, 2005.