NAME: timebar PURPOSE: plot vertical (or horizontal) lines on TPLOTs at specified times (or values) CALLING SEQUENCE: timebar,t INPUTS: t: dblarr of times at which to draw vertical lines, seconds since Jan, 1, 1970. (Or a single datavalue at which to draw a horizontal line in units of the TPLOT variable named in VARNAME). KEYWORD PARAMETERS: DATABAR: Set to plot horizontal lines. *** Must set VARNAME also (for the time being) ***. COLOR: byte or bytarr of color values LINESTYLE: int or intarr of linestyles THICK: int or intarr of line thicknesses for any of the above keywords, a scalar input will apply to all times VERBOSE: print more error messages; useful for debugging VARNAME: TPLOT variable name or index indicating panel in which to plot bar BETWEEN: array of two TPLOT variable names indicating between which two panels to plot timebar TRANSIENT: timebar,t,/transient called once plots a timebar. Called twice, it deletes the timebar. Note: 1) all other keywords except VERBOSE be the same for both calls. 2) COLOR will most likely not come out what you ask for, but since it's transient anyway, shouldn't matter. OUTPUTS: OPTIONAL OUTPUTS: COMMON BLOCKS: tplot_com EXAMPLE: load_3dp_data,'95-01-01',2 & get_pmom tplot,['Np','Tp','Vp'] t=time_double('95-01-01/1:12') timebar,t ;put a white line at 1:12 am, Jan, 1, 1995 ctime,t1,t2 ;select two times from the plot timebar,[t1,t2],color=!d.n_colors-2 ;plot them in red SEE ALSO: "CTIME","TPLOT" CREATED BY: Frank V. Marcoline LAST MODIFICATION: 2009/05/14, W.M.Feuerstein FILE: timebar.pro VERSION: 1.91