PROCEDURE: tplot [,datanames] PURPOSE: Creates a time series plot of user defined quantities. INPUT: datanames: A string of space separated datanames. wildcard expansion is supported. if datanames is not supplied then the last values are used. Each name should be associated with a data quantity. (see the "STORE_DATA" and "GET_DATA" routines.) Alternatively datanames can be an array of integers or strings. run "TPLOT_NAMES" to show the current numbering. KEYWORDS: TITLE: A string to be used for the title. Remembered for future plots. ADD_VAR: Set this variable to add datanames to the previous plot. If set to 1, the new panels will appear at the top (position 1) of the plot. If set to 2, they will be inserted directly after the first panel and so on. Set this to a value greater than the existing number of panels in your tplot window to add panels to the bottom of the plot. LASTVAR: Set this variable to plot the previous variables plotted in a TPLOT window. PICK: Set this keyword to choose new order of plot panels using the mouse. WINDOW: Window to be used for all time plots. If set to -1, then the current window is used. VAR_LABEL: String [array]; Variable(s) used for putting labels along the bottom. This allows quantities such as altitude to be labeled. VERSION: Must be 1,2,3, or 4 (3 is default) Uses a different labeling scheme. Version 4 is for rocket-type time scales. OVERPLOT: Will not erase the previous screen if set. NAMES: The names of the tplot variables that are plotted. NOCOLOR: Set this to produce plot without color. TRANGE: Time range for tplot. NEW_TVARS: Returns the tplot_vars structure for the plot created. Set aside the structure so that it may be restored using the OLD_TVARS keyword later. This structure includes information about various TPLOT options and settings and can be used to recreates a plot. OLD_TVARS: Use this to pass an existing tplot_vars structure to override the one in the tplot_com common block. GET_PLOT_POSITION: Returns an array containing the corners of each panel in the plot, to make it easier to overplot and annotate plots HELP: Set this to print the contents of the tplot_vars.options (user-defined options) structure. RESTRICTIONS: Some data must be loaded prior to trying to plot it. Try running "_GET_EXAMPLE_DAT" for a test. EXAMPLES: (assumes "_GET_EXAMPLE_DAT" has been run) tplot,'amp slp flx2' ;Plots the named quantities tplot,'flx1',/ADD ;Add the quantity 'flx1'. tplot ;Re-plot the last variables. tplot,var_label=['alt'] ;Put Distance labels at the bottom. For a long list of examples see "_TPLOT_EXAMPLE" OTHER RELATED ROUTINES: Examples of most usages of TPLOT and related routines are in the crib sheet: "_TPLOT_EXAMPLE" Use "TNAMES" function to return an array of current names. Use "TPLOT_NAMES" to print a list of acceptable names to plot. Use "TPLOT_OPTIONS" for setting various global options. Plot limits can be set with the "YLIM" procedure. Spectrogram limits can be set with the "ZLIM" procedure. Time limits can be set with the "TLIMIT" procedure. The "OPTIONS" procedure can be used to set all IDL plotting keyword parameters (i.e. psym, color, linestyle, etc) as well as some keywords that are specific to tplot (i.e. panel_size, labels, etc.) For example, to change the relative panel width for the quantity 'slp', run the following: OPTIONS,'slp','panel_size',1.5 TPLOT calls the routine "SPECPLOT" to make spectrograms and calls "MPLOT" to make the line plots. See these routines to determine what other options are available. Use "GET_DATA" to retrieve the data structure (or limit structure) associated with a TPLOT quantity. Use "STORE_DATA" to create new TPLOT quantities to plot. The routine "DATA_CUT" can be used to extract interpolated data. The routine "TSAMPLE" can also be used to extract data. Time stamping is performed with the routine "TIME_STAMP". Use "CTIME" or "GETTIME" to obtain time values. tplot variables can be stored in files using "TPLOT_SAVE" and loaded again using "TPLOT_RESTORE" CREATED BY: Davin Larson June 1995 QUESTIONS? See the archives at: http://lists.ssl.berkeley.edu/mailman/listinfo/tplot Still have questions: Send e-mail to: tplot@ssl.berkeley.edu someone might answer! $LastChangedBy: davin-mac $ $LastChangedDate: 2014-06-27 14:34:15 -0700 (Fri, 27 Jun 2014) $ $LastChangedRevision: 15459 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/general/tplot/tplot.pro $