This documents the write paneldata slice function.

;* The "mouse writes paneldata" function allows the user to read off data from 
;* panels using the mouse and to write that data to a file. This is a PAPCO
;* supplied utility slice which by default only writes the time and y-value of
;* the mouse-click to file. The user can however interface his own routine to
;* add auxiliary data to the string written to file.
;* The output file is written in ASCII and has the same format as the .event
;* files used by the event times utility module. The files can thus be used
;* in the events time module to mark events on panels.
;* -> user defined interface routine possible, template included in 
;* $PAPCO_modules/plot_type/papco_interface/plot_type_slice.pro

This utility slice is used to interactively read data off plots. By default
only the time and the y-value at the mouse position are read, but the user can
add auxiliary data of his choice.  PAPCO provides the Write Paneldata window,
only the User labels and the user Data need to be supplied.


--- Default info group --------------------------------------------------------

The top part of the widget simply contains the labels and data for the time
and y-value of the last mouse click.

--- User info group -----------------------------------------------------------

Here 6 writable text lines are provided for the user to add his/her own
information. User label is for providing a label for the data in the line
below.

--- Choose file group ---------------------------------------------------------

The user can enter a filename to which to write or browse for existing
ones. Filenames have the extention ".event" by default. If your filename
entered does not have the extention ".event" it is automatically added. All
files written here are compatible with the Event Times utility module, and are
stored/searched for in the same directory set by the Event Times utility
module. This path is set in the idl_papco_startup file and by default is set
to:

setenv,'EVENT_DATA='+HOME+'/PAPCO_products/event_times/'

where HOME is the user's home directory.

If the file specified is found, it can be edited, if not, it can be created
and then edited. If you press "Add info to file" and have not chosen a
filename then the info is written to the default file "paneldata.event"

--- Comment group -------------------------------------------------------------

A simple text entry widget that allows the user to enter a comment for the
event chosen. The comment line automatically starts with a space, DO NOT
DELETE this space, it is used to seperate the string from user_data_3 (see
below). 

NOTE: pressing return in this field has no affect. 

--- Action button group -------------------------------------------------------

"Add info to file" : 

Use to add the current information displayed in the default info group, the
user info group and the comment group. The ACTUAL TEXT displayed is written to
file in the following order:

date_time_string + yvalue_string + 
              user_data_1 + user_data_2 + user_data_3 +
                            comment_string

NOTE: The info displayed will update automatically as you drag the mouse in
the panel, but only if this slice type is enabled for the module that drew the
panel. If you move the mouse into a panel which does not support this slice
type, a vertical line is still drawn at the mouse position but no info is
updated in the Write Paneldata Window.

"Help" :

Displays this Help window


"Close"

Closes the Write Paneldata window. The last filename used is remembered during a given PAPCO session. 

NOTE: You can keeps this window open while you call up a series of plots