Level-2 Plot Applications (Language: IDL)
==========================================

Program name EPHIN data plots: L2PLOT.PRO
Program name LION data plots:  LIO2PLOT.PRO

Thought this description refers only to L2PLOT, LIO2PLOT is covered
as well, because it is coded likewise. It only got some fewer 
functions.


Contact address:
----------------
Christian Albrechts University of Kiel
Otto-Hahn-Platz 1

Reinhold Mueller-Mellin
e-mail: mueller_m@ifkki.kernphysik.uni-kiel.de 

Holger Boll
e-mail: boll@ifkki.kernphysik.uni-kiel.de

L2plot is a more or less self explaining widget guided program. The
author regards this documentation as a short supplement to better understand
the program behavior. 


Contents
1 INTRODUCTION	
2 THE WIDGET STRUCTURE	
 2.1 THE >EPHIN LEVEL-2 MAIN MENU< WIDGET	
 2.2 THE >EPHIN L2 PLOT-MENU< WIDGET	
  2.2.1 Left button column	
   2.2.1.1 >Plot All< Button and single plots	
   2.2.1.2 >Y-Scaling< Button.	
   2.2.1.3 >Y-Range< Button	
   2.2.1.4 >Save Data< Button	
  2.2.2 Right Button Column	
   2.2.2.1 >Set Color< Button	
   2.2.2.2 >Plotmode< Button	
   2.2.2.3 >Help O-fac< Button	
   2.2.2.4 >O-fac< Input Field	
   2.2.2.5 >Annotation< Button	
   2.2.2.6 >Plot Title> Button	
   2.2.2.7 >Help Corr Fac> Button	
   2.2.2.8 >Correction factor <Button	
   2.2.2.9 >open PS<, >close PS<, >toggle x/PS< Buttons	
   2.2.2.10 >Config Plotwindow< Button	
   2.2.2.11 >Config Plotpanel< Button	



1 Introduction
The program is a comprehensive packet of several subroutines and
functions. It should run on all platforms. To simplify the installation all
source files are copied together into one library file:
				 >L2PLOT.PRO<. 
It is recommended to copy the program file onto a hard disk, because it
generates output files, used to save file paths and plot panel configuration
data. While UNIX has got no special switches, mount the CD on DEC 

VMS or OPEN-VMS systems with :
	mount/over=id/media=CD/undef=(stream_lf:512)   device    (AXP) 
	cd_mount/over=id/media=CD/undef=(stream_lf:512)   device    (VMS)
and copy L2PLOT.PRO to your disk

To run L2PLOT
  start up IDL
  .compile  L2PLOT
  type in: main

and the program will start up.

If it is started the very first time on that actual directory two input
requests must be answered: First enter the file input path for the level-2
files, then the output file path for the plot files (PostScript). 

The path information, ASCII data dumps and panel configuration files will be
placed on the actual directory.

Now the main menu will appear.

Note:
If the program does not behave as it is supposed to (after several restarts or
new data read-ins), it is a good practice to exit IDL and make a new start.



2 The widget structure
 2.1 The >EPHIN Level-2 Main Menu< widget
     The following steps lead to a data read-in and opens the plot menu:

      1. select channel(s)  or unselect to correct selection 
      2. read in data (a plot time setting menu appears)

      ! Note:  Every time new channels are selected, a new read-in must be 
	       performed.

      The channel selection: 
        There are 2 listings in this widget. The left one shows all selectable 
        channels. Up to 8 channels may be selected by mouseclicking. The 
        selected channels appear on the right list. It is now possible to 
        unselect them by mouseclicking in the right list.

     A f t e r	channel selection the read-in must be performed.

     Data read-in:
	Mouseclicking the >Select Period  -  Start Plot< button lets a 
	widget appear, where plot start date, number of days to plot and the 
	averaging interval are requested. To change input fields use mouseclick.
 	After clicking on the >ok---exit< button the read-in starts. 
	While reading the input files, no further clicks should be done. 
	A >Wait-Window< appears as long as the read-in continues. After its 
	disappearance the plot menu is called automatically or may be called by
	clicking on the>Start Plot< button at other occasions.

 2.2 The >EPHIN L2 Plot-Menu< widget

  2.2.1 Left button column
  ------------------------
   2.2.1.1 >Plot All< Button and single plots
	This menu offers the possibility to plot all channels in one step 
	(clicking on >Plot All< button). In this case the number of panels 
	in the plot page (plotwindow) is automatically set to the number of 
	channels. If the user wants a different plot sequence he can doubleclick
 	on the channels in the list. By changing the plotwindow configuration 
	it is possible to plot for example just 3 of 4 selected channels on one 
	plot page
   2.2.1.2 >Y-Scaling< Button.
	Selection between linear (default) or logarithmic scaling.
   2.2.1.3 >Y-Range< Button
	There are 3 selection items on this button. A default setting of 
	Y minimum and maximum values is fixed in the source code. The user may 
	set its own values (right button column >Set Y-Range) and use then by 
	selecting the >selfmade range< item. The third option is 
	>IDL Automatic< , which is recommended to use to get a first idea of 
	the data range. >selfmade< is recommended for overplotting or plotting 
	with logarithmic scale.
   2.2.1.4 >Save Data< Button
	Generates an ASCII data listing of all selected channels. A 
	submenu gives a selection of different time tags.

  2.2.2 Right button column
  -------------------------
   2.2.2.1 >Set Color< Button
	Little submenu to alter the actual plot color. Load first color table 
	by clicking >Color< button, then use slider to set color. The 
	>black and white < button resets all plotted data to black lines.
	This option is useful for overplot purpose.
   2.2.2.2 >Plotmode< Button
	Switches between single panel plots and multi panel plots (O-Plot mode) 
   2.2.2.3 >Help O-fac< Button
	Opens a message widget with short reminder how to use the overplot 
	factor 
   2.2.2.4 >O-fac< Input Field
	Type in your desired overplot factor. In linear plots the factor is 
        added to the data, in logarithmic plots it is multiplied. After each 
	overplot the o-fac is reset to its defaults (0 for linear plot,  
	1 for logarithmic plot)
   2.2.2.5 >Annotation< Button
	Submenu with options to set annotation font and size. The 
        positioning is done with mouseclick into the plotpanel. 
	Caution: The positioning in the X-window and in the PostScript files 
	differs sometimes very strong. The author is working on that problem.
   2.2.2.6 >Plot Title> Button
	Little submenu with 3 input fields to alter the default plot titles for
 	x- and y-axes and main title. If the input field remains empty the 
	default title is used.
   2.2.2.7 >Help Corr Fac> Button
	Help on correction factor. The Plots may be done with or without PHA 
	correction. Correction factors are provided for proton and helium 
	channels. 

===============================================================================
!!Remark : 2.2.2.8 was wrong in all program version less equal V3.01 Nov-97 !!
                   dividend and divisor were mixed up 
                   affected is only the documentation text, not the plot program
===============================================================================
   2.2.2.8 >Correction factor <Button
	Selection of 4 items: 	
	  - no correction
	  - arbitr incidnc: PHA matrix correction 
		# particles in proton+deuterium box / total # particles in p PHA
		resp. 
		# particles in 3He+4He box / total # particles in He PHA
	  - paral incidnc-1: 
		# particles in proton box' / total # particles in p PHA
		resp.
		# particles in 3He box / total # particles in He PHA
	  - paral incidnc-2:
		# particles in deuterium box' / total # particles in p PHA
		resp.
		# particles in 4He box / total # particles in He PHA
   2.2.2.9 >open PS<, >close PS<, >toggle x/PS< Buttons
	The plot output may be directed into a PostScript file. The PS file is 
	opened with button >open PS<. This does  not mean that the output is 
	sent into the file immediately. The user can test the plots first on 
	the x-window and may then, after clicking on >toggle x/PS<   direct 
	the output into the file and click again on one of the plot switches.
	The user may close the PostScript file and open another one, to 
	distinguish the plots by the file names. The PostScript file status 
	(open/ not open, plot into file) is displayed in info boxes. It is wise
	 to watch these info boxes, so that the user knows where the plot is 
	sent to and how the plot pages are configured.
   2.2.2.10 >Config Plotwindow< Button
	Submenu to alter default number of plot panels (1) per page. It is 
	possible to increase the number of panels into both, x and y direction
   2.2.2.11 >Config Plotpanel<
	Submenu to set plotsymbol and size and number of ticks 
	(major and minor) in x and/or y direction.