NAME: spdf_plotmaster PURPOSE: To plot the data given in 1 to 10 anonymous structure of the type returned by the spdf_read_mycdf function. This function determines the plot type for each variable, and generates the plot. CALLING SEQUENCE: out = spdf_plotmaster(a,[more_structures]) INPUTS: a = structure returned by the spdf_read_mycdf procedure. KEYWORD PARAMETERS: TSTART = String of the form '1996/01/02 12:00:00' or a DOUBLE CDF_EPOCH time that is the desired start time of the plots. Data is clipped or padded to conform to this time. Default is the start time of the earliest data. TSTOP = String of the form '1996/01/02 12:00:00' or a DOUBLE CDF_EPOCH time that is the desired stop time of the plots. Data is clipped or padded to conform to this time. Default is the stop time of the latest data. GIF Set to send plot(s) to a gif file, ie. /GIF or GIF=1L. If set a file will be produced in the current working directory (see OUTDIR keyword), using the following naming conventions: Spacecraft_instrument_pid_# (see the PID keyword for customization). If GIF is not set then the plot(s) will be put into an x-window. PS Set to send plot to a ps file. Works just as GIF above. PID May be used to customize part of the name of a gif file. The value of PID may be either a number or a string and will be inserted in the gif file name as follows: Spacecraft_instrument_pid_#.gif. If GIF is not set then the plot(s) will be put into an x-window and this keyword is ignored. OUTDIR This keyword indiates the output directory where a gif file will be placed. If GIF is set but OUTDIR is not, then the gif file will be put in the user's current working directory.GIF AUTO Set this keyword to use autoscaling instead of the variables SCALEMIN and SCALEMAX attribute values. The scales will be set to the min and max values of the data, after fill values have been filtered from the data (see also NONOISE keyword). If the user wishes to modify variable scale values for plotting purposes, you may do so by changing the appropriate data structure values, ie. struct.variable.scalemin = 0.0. Please use great care in modifying the data structures values since they will greatly influence what your plots or listings may look like. CDAWEB Set this keyword to force the margin on the right side of time series plots to be 100 pixels. This is the same margin used for spectrograms for the color bar. By default, spdf_plotmaster will examine the data, and if ANY spectrograms will be produced, then it will align the margins properly. This keyword is only necessary for use in the CDAWeb system. SLOW Set this keyword to have spectrogram plotted using the POLYFILL method. This method is slower but more accurate than TV (used in the QUICK method). SMOOTH Set this keyword to have spectrogram data reduced prior to plotting. This will increase plotting speed significantly. QUICK Set this keyword to have spectrograms plotted using the TV method. This method is very fast, but will produce inaccurate spectrograms if scales are non-linear or if fill data or data gaps are present in the data. THUMBSIZE Set this to change the "thumbnail" size of each image when plotting a series of images. The default is 50w x 62h. 12 pixels is added to the height to allow for the time stamps under each image. So, if you specify a thumsize of 70 pixels, each will actually be 70x82. FRAME Used to indicate the frame number within a series of images. If you specify FRAME = 2, then spdf_plotmaster will produce a "full size" version of the 3rd image in a sequence of images. COMBINE = if set, all time series and spectrogram plots will be combined into a single window or gif file. NONOISE = if set, filter values outside 3-sigma from the mean DEBUG = if set, turns on additional debug output. ELEMENTS = if set, then only these elements of a dimensional variable will be plotted for stack_plot use only (right now). LIMIT_MOVIE = if set, then the number of frames in a movie file will be limited by the underlying s/w routines (to 200 or so as of 2/2006) if not set, no limit on the # of frames (TJK 2/9/2006) OUTPUTS: out = status flag, 0=0k, -1 = problem occurred. AUTHOR: Richard Burley, NASA/GSFC/Code 632.0, Feb 22, 1996 burley@nssdca.gsfc.nasa.gov (301)286-2864 MODIFICATION HISTORY: 8/13/96 : R. Burley : Add NONOISE keyword 8/30/96 : R. Baldwin : Add error handling STATUS,DATASET,IMAGE,GIF 8/30/96 : R. Baldwin : Add orbit plotting 1/7/97 ; T. Kovalick : Modified many of the code that goes w/ the keywords; GIF, CDAWEB, TSTART, TSTOP and added the header documentation for them. Still more work to do... 2/10/97 ; R. Baldwin : Add SSCWEB keyword and map_keywords.pro function 6/6/97 ; T. Kovalick : Added the Stacked time series plot type. 9/4/97 ; T. Kovalick : Added the ELEMENTS keyword for stack_plot usage, it could also be used in time_series. 4/98 ; R. Baldwin : Added virtual variable plot types; plot_map_images.pro 11/98 ; R. Baldwin : Added movie_images and movie_map_images Copyright 1996-2013 United States Government as represented by the Administrator of the National Aeronautics and Space Administration. All Rights Reserved.