PROCEDURE specplot,x,y,z NAME: specplot PURPOSE: Creates a spectrogram plot. All plot limits and plot positions are handled by the keyword LIMITS. INPUT: x: xaxis values: dimension N. y: yaxis values: dimension M. (Future update will allow (N,M)) Z: color axis values: dimension (N,M). All options are passed in through a single structure. KEYWORDS: LIMITS: A structure that may contain any combination of the following elements: X_NO_INTERP: Prevents interpolation along the x-axis. Y_NO_INTERP: Prevents interpolation along the y-axis. NO_INTERP: Prevents interpolation along either axis NO_COLOR_SCALE: Prevents drawing of color bar scale. BOTTOM, TOP: Sets the bottom and top colors for byte-scaling ALL plot keywords such as: XLOG, YLOG, ZLOG, XRANGE, YRANGE, ZRANGE, XTITLE, YTITLE, TITLE, POSITION, REGION etc. (see IDL documentation for a description) The following elements can be included in LIMITS to effect DRAW_COLOR_SCALE: ZTICKS, ZRANGE, ZTITLE, ZPOSITION, ZOFFSET DATA: A structure that provides an alternate means of supplying the data and options. This is the method used by "TPLOT". X_NO_INTERP: Prevents interpolation along the x-axis. Y_NO_INTERP: Prevents interpolation along the y-axis. OVERPLOT: If non-zero then data is plotted over last plot. OVERLAY: If non-zero then data is plotted on top of data from last last plot. PS_RESOLUTION: Post Script resolution. Default is 150. NO_INTERP: If set, do no x or y interpolation. IGNORE_NAN: If nonzero, ignore data points that are not finite. DX_GAP_SIZE = Maximum time gap over which to interpolate the plot. Use this keyword when overlaying spectra plots, allowing the underlying spectra to be shown in the data gaps of the overlying spectra. Overrides value set by DATAGAP in dlimits. Note: if either DX_GAP_SIZE or DATAGAP is set to less than zero, then the 20 times the smallest delta x is used. Notes: - The arrays x and y MUST be monotonic! (increasing or decreasing) - The default is to interpolate in both the x and y dimensions. - Data gaps can be included by setting the z values to NAN (!values.f_nan). - If ZLOG is set then non-positive zvalues are treated as missing data. See Also: "XLIM", "YLIM", "ZLIM", "OPTIONS", "TPLOT", "DRAW_COLOR_SCALE" Author: Davin Larson, Space Sciences Lab $LastChangedBy: davin-mac $ $LastChangedDate: 2014-02-02 17:11:43 -0800 (Sun, 02 Feb 2014) $ $LastChangedRevision: 14136 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/general/tplot/specplot.pro $