PROCEDURE: ctime2 PURPOSE: A version of ctime. May become obsolete. $LastChangedBy: dmitchell $ $LastChangedDate: 2014-10-31 14:15:03 -0700 (Fri, 31 Oct 2014) $ $LastChangedRevision: 16106 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/maven/swea/ctime2.pro $ CREATED BY: David L. Mitchell 2013-07-26 FILE: ctime2.pro

NAME: ctime_get_exact_data PROCEDURE: ctime_get_exact_data PURPOSE: Get a data structure for ctime. if var is a string or a strarr, create a structure of data structures. Get the new values for hx and hy, the crosshairs position. Also check the spec option. ctime need never see the actual data structures. All work is done with pointers to reduce data duplication and increase speed. COMMON BLOCKS: CTIME_COMMON HISTORY: First appeared in ctime version 1.29

PROCEDURE: ctime2,time,y,z INPUT: time: Named variable in which to return the selected time (seconds since 1970) y: Named variable in which to return the y value z: Named variable in which to return the z value KEYWORDS: PROMPT: Optional prompt string NPOINTS: Max number of points to return PSYM: If set to a psym number, the cooresponding psym is plotted at selected points SILENT: Do not print data point information PANEL: Set to a named variable to return an array of tplot panel numbers coresponding to the variables points were chosen from. APPEND: If set, points are appended to the input arrays, instead of overwriting the old values. VNAME: Set to a named variable to return an array of tplot variable names, cooresponding to the variables points were chosen from. COLOR: An alternative color for the crosshairs. 0<=color<=!d.n_colors-1 SLEEP: Sleep time (seconds) between polling the cursor for events. Defaults to 0.1 seconds. Increasing SLEEP will slow ctime down, but will prevent ctime from monopolizing cpu time. INDS: Return the indices into the data arrays for the points nearest the recorded times to this named variable. VINDS: Return the second dimension of the v or y array. Thus TIME(i) is data.x(INDS(i)) and Y(i) is data.y(INDS(i),VINDS(i)) and V(i) is data.v(VINDS(i)) or data.v(INDS(i),VINDS(i)) for get_data,VNAME(i),data=data,INDS=INDS,VINDS=VINDS EXACT: Get the time,y, and (if applicable) z values from the data arrays. If on a multi-line plot, get the value from the line closest to the cursor along y. NOSHOW: Do not show the plot window. DEBUG: Avoids default error handling. Useful for debugging. DAYS, HOURS, MINUTES, SECONDS: Sets time granularity. For example with MINUTES=1, CTIME will find nearest minute to cursor position. BUTTON: Returns the last button pressed. PURPOSE: Interactively uses the cursor to select a time (or times) NOTES: If you use the keyword EXACT, ctime may run noticeablly slower. Reduce the number of time you cross panels, especially with tplots of large data sets. SEE ALSO: "crosshairs" CREATED BY: Davin Larson & Frank Marcoline LAST MODIFICATION: @(#)ctime.pro 1.40 99/04/22 WARNING! If ctime crashes, you may need to call: IDL> device,set_graph=3,/cursor_crosshair