
\documentstyle[12pt,a4,psfig]{book}
\title{fonction graphiques }
\author{G.Zehnacker et L. Michel}
\date{Edition 1.1\\Decembre 1990}
\begin{document}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% TITRE %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{titlepage}
{

\hoffset=0.truein
\hsize=5.25truein
\vsize=10.25truein
\font\small=cmssbx10 at 14.4truept
\font\medium=cmssbx10 at 17.28truept
\font\large=cmssbx10 at 20.74truept
\hrule height 0pt
\parindent=0pt
%\parskip=0pt
\hskip 3.9truein
\large
\par
\vskip .5truein
\large
Eurogam project
\hskip 5cm
EDOC112\par
\vskip 1.5truein
\hrule height 2pt
\vskip 20pt
\large
Developpement graphique\par
\vskip .5truein
\small
ANALYSIS FUNCTIONS and ERGONOMICS\par
\vskip 20pt
\hrule height 2pt
\vskip 1truein
\medium
Edition 1.2\par
\vskip 3pt
22 Janvier 1991\par
\vfill
\small
G.ZEHNACKER et L. MICHEL\par
\vskip 30pt
\medium
Centre de Recherches Nucl\'{e}aires de Strasbourg (SATD)\par
\vskip 5pt
CNRS-IN2P3 France\par
\vskip 5pt
}
\end{titlepage}

\small
%%%%%%%%%%%%%%%%%%%%%%%%%%% INTRODUCTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{INTRODUCTION}

	The purpose of the present paper is to outline the major aspects of the 
	graphical interface for offline-online.

	Specifications concerning ergonomics, functions and data structures are
	presented.

	At the beginning of each section, the general requirements are defined 
	and the essential elements are subseqently specified.

	For the following, we require that:
\begin{itemize}
\item	A spectrum is stored like it appears on the screen.
\item 	The commands are focused on a single independant display area of the position
      	of the cursor.
\item 	The applications functions can be easily modified.
\end{itemize}

	This work is independant of the toolkit used in the development environment. 
	The mack-ups show a graphic structure and not a look. 

	We expect to show more precise screen models created under 
	Dev-Guide (Open Look).

\begin{figure}
\psfig{figure=edoc112_fig1.ps,width=13cm,height=20cm}
\end{figure}


%%%%%%%%%%%%%%%%%%%% ERGONOMICS %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{ERGONOMICS}
\section{General rules} %%%%%%%%%%%% section general rules %%%%%

	The user can store his work like it appears on screen.

	The user doesn't have to manage several windows belonging to the same
	application.

	The user has to be able to run and set parameters of a function without 
	the need of specific syntax.

	The commnads for image manipulations are always available on the screen 
	(scope area).

\section{Storage of an analyse work} %%%%%%%%%%%%%% section analyse storage %%%%%%%

	A lot of physicists would like to store the result of work realized on the screen. 
	The peaks detected, the fits and so on would be stored on disk, and
	systematically displayed with the spectrum. This characteristic should always be
	active and transparent for the user.

	The command SAVE assumes the storage of the spectrum and its attributs
	(CALIBRATION, BACKGROUND, ...).

	The work attributs are associated with the spectrum and not with the display
	software. They have to be able to be used by others programs. This
	specification imposes a data structure sufficiently flexible to describe the
	attributs (see Chapt IV).

\section{Structure of the visualisation screen}
\subsection{Structure of the visual window}

	The window has 3 fonctionnal areas:
\begin{itemize}
\item 	THE MENU BAR.
\item	THE SCOPE AREA.
\item 	THE DISPLAY AREA.
\end{itemize}

\subsection{The menu bar}
	The popup menu buttons are drawn on top of the screen.

	The popup menu buttons have to be at the same position in different 
	applications.

	We propose the following outline (from left to right)
\begin{itemize}
\item 	HELP 	menu
\item 	STORAGE menu (data storage, print,....)
\item 	IMAGE 	menu (Display management: color, cut-paste,......) 
\item 	The other popup menus specific to the application (calcul, set up, .... )
\item 	DATA BASE menu
\end{itemize}

\subsection{The DISPLAY area}

	The display area can be divided in seveal areas in witch the spectra are drawn.
	The partition must be set by the user. Several spectra can be drawn in each
	display area, but, in this case, the commands act on all the spectra.

	At the same time, a single display area is active.

	The active display area receives the commands independently of the position
	of the mouse cursor. The pointed channel it value and other informations are 
	written at the top of each display.

	The color of the frame of the display area depends on its status (see SCOPE AREA)
	so that the user can identify the active display area and its associates.

\subsection{The SCOPE area}
	The scope area permits to manage the images. Its functions are:

\begin{itemize}
\item 	DISPLAY AREA's STATUS: A four position commutator define the status of the
	selected area.
\item	DISPLAY AREA's SELECTION: A diagramm symbolises the partition of the display
	area. The part selected is set with the status of the display area's
	status commutator.
\item 	ZOOM: The ZOOM command is runing on the active display area and its associates.
\item 	MOVE: Move the active display area and its associates step by step.
\item 	MARKERS: A three position commutator defines the markers that can be created 
	(X: vertical, Y: horizontal, XY: rectangular area). A two positions commutator 
	sets the create or delete mode.
\item 	PRINT: Print the active spectrum and its associates
\item 	RESTORE: Restore (from disk) the active spectrum.
\item 	CHANNEL-ENERGY: Set the display mode (counts or energy).
\item 	LOG: Set the LOG axes display (X, Y or the both).
\item 	PTS-HIST-VECT: Set the display mode for the histogramms (points, vectors or
	histogram).
\end{itemize}

	All this commands don't need confirmation or validation.

\section{Display screen partition}

	The software permits to display several spectra simultaneously on the screen.
	
	Every spectrum has its display area. The status of the display area is managed
	by the user.

\begin{itemize}
\item 	WORK AREA: A work area is a part of the display area. A work area can display
	one or more spectra. The command acts on all the spectra drawn in a work area.
\item 	ACTIVE AREA: A single work area is simultaneously active . All the commands are
	applied to the active area. All the commands are apply to this area
	independently of position of the mouse cursor.
\item	ASSOCIATED AREA: This aera is associated with the active dislpay area. The 
	associated area receives some command simultaneously with the active area.
\item 	EXPAND AREA: The expand display area displays the part between markers of the
	active display area.
\item 	LOCK AREA: The lock area cannot be activated or associated. Lock is a flipflop
	command. 
\end{itemize}

\section{Command system}

	The commands are executed from menus. There parameters are set by dialog boxes. 
	The mouse is used to manipulate buttons, menus and to check spectra channels.

	The most frequently used commands can be executed directly from the keyboard.

\begin{itemize}
\item 	USE OF THE DIALOG BOXES: All the keyboard X-events are focused to the opened
	dialog box independently of the position of the mouse cursor. The dialog box must
	be drawn out of the active dislay area and its associates, but in the screen. 
	It must be possible to use the mouse to check channel when a dialog box is 
	opened.
\item 	USE OF THE MOUSE: All the commands of all the applications must have the same
	usage of the mouse buttons. The functions of the buttons can be defined by the
	toolkit.
\item 	USE OF THE KEYBOARD: The most frequently used commands can be executed directly 
	with a key code without using the menu.(CTRL S for "save" p.e.). One of the 
	validation buttons must be overlined and activated in case of "RETURN" key input 
	(default).
\end{itemize}

%%%%%%%%%%%%%%%%%%%%%%% CHAP FONCTIONNALITE %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{FUNCTIONS}
\section{Menu structure}
	Each group of functions is associate with a menu (Fig 2).

\begin{itemize}
\item	HELP menu: 	Access to the online help.
\item 	STORAGE menu: 	Management of the data file of the application.
\item 	IMAGE menu: 	Management of the image on screen.
\item 	CALIB. menu:	Commands used to calibrate the spectra.
\item 	CALCUL. menu: 	Commands used to do mathematical operations among the spectra.
\item 	BACKGND: menu 	Commands used to describe and extract the background.
\item	PEAKS menu: 	Commands used to search and describe peaks.
\item 	2 DIM. menu: 	Commands associated with 2 dim's spectra.
\item	DATA BASE menu:	Access to the data base.
\end{itemize}

\begin{figure}
\psfig{figure=edoc112_fig2.ps,width=13cm,height=20cm}
\end{figure}

\section{Function description}
\tiny
\begin{tabbing}
01 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \=:  \rm ACTIVATE\\
\bf FUNCTION \>:  \rm Activate the selected display area.\\
\bf CALL     \>:  \rm SCOPE area.\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm This command is one of the 4 positions of the commutator.\\\\
02 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ASSOCIATE\\
\bf FUNCTION \>:  \rm Associate the selected display area with the active display area.\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm This command is one of the 4 positions of the commutator.\\\\
03 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm EXPAND\\ 
\bf FUNCTION \>:  \rm The selected area display the part between markers of the active 
                      display area.\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The EXPAND display area cannot execute commands.\\\\
04 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm LOCK\\
\bf FUNCTION \>:  \rm The selected display area can't be active or associated.\\
\bf CALL     \>:  \rm SCOPE area.\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm LOCK-UNLOCK is a flipflop command.\\\\
05 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ZOOM\\
\bf FUNCTION \>:  \rm Make a zoom on the image of the active and the associated display 
                      areas. The zoom display the zone between \\
             \>:  \rm the markers. If no markers 
                      exist, the images are zoomed step by step.\\
\bf CALL     \>:  \rm SCOPE area.\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm zoom step\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm Part to draw\\
\bf MODIFIED \>:  \rm Part to draw\\\\
\bf COMMENTS \>:  \rm \\\\
06 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm MOVE\\
\bf FUNCTION \>:  \rm Move step by step the image of the active and the associated 
                      display areas.\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm move step\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm Part to draw\\
\bf MODIFIED \>:  \rm Part to draw\\\\
\bf COMMENTS \>:  \rm \\\\
07 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm MARK.\\
\bf FUNCTION \>:  \rm Create or delete markers in the active and the associated display
	              areas.\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm MARKERS\\
\bf MODIFIED \>:  \rm MARKERS\\\\
\bf COMMENTS \>:  \rm The position of the markers is selected with the mouse.\\\\
08 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm PRINT\\
\bf FUNCTION \>:  \rm Print the spectrum of he active and the associated display
                      areas with the print \\
             \>:  \rm header (list of attributs to print).\\
\bf CALL     \>:  \rm zone SCOPE\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
09 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm REFRESH\\
\bf FUNCTION \>:  \rm Draw the active spectrum from storage device (annul the modifications
                      in memory).\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
10 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CHANNEL-ENERGY\\
\bf FUNCTION \>:  \rm Display the channels values in count or energy.\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm \\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm calibration, scale.\\
\bf MODIFIED \>:  \rm scale.\\\\
\bf COMMENTS \>:  \rm \\\\
11 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm Log X-Y-XY\\
\bf FUNCTION \>:  \rm Display the axe X, Y or the both in log scale.\\
\bf CALL     \>:  \rm SCOPE\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm LOG-LIN\\
\bf MODIFIED \>:  \rm LOG-LIN\\\\
\bf COMMENTS \>:  \rm The axes are display in linear scale by default.\\\\
12 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm PTS-HIS-VECT\\
\bf FUNCTION \>:  \rm Select the display mode for histogramms (points, vector ou 
                      histogram).\\
\bf CALL     \>:  \rm SCOPE area\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm PHV\\
\bf MODIFIED \>:  \rm PHV\\\\
\bf COMMENTS \>:  \rm \\\\
13 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm AUTOMATIC ON-OFF (help)\\
\bf FUNCTION \>:  \rm Set the automatic display of an help window with each command.\\
\bf CALL     \>:  \rm Menu HELP\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
14 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SEARCH INFORMATIONS. (help)\\
\bf FUNCTION \>:  \rm Display a page of informations about the selected keyword.\\
\bf CALL     \>:  \rm Menu HELP\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Keyword.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
15 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm NEW (storage)\\
\bf FUNCTION \>:  \rm Clear the display area, delete the spectra from memory and set the
                      software with default values.\\
\bf CALL     \>:  \rm menu STORAGE\\
\bf DIAL     \>:  \rm yes: alert box for confirmation.\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm A storage is proposed for each modified spectra.\\\\\
16 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm COMPACT LIST (storage\\
\bf FUNCTION \>:  \rm Compact the numerotation of the list of spectra in memory.\\
\bf CALL     \>:  \rm Menu STORAGE\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
17 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm LOAD (storage)\\
\bf FUNCTION \>:  \rm Load in memory, from storage device, the selected spectrum.\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm YES\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Pathname of the spectrum.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
18 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CLOSE (storage)\\
\bf FUNCTION \>:  \rm Clear on the display area and in memory the selected spectra.\\
\bf CALL     \>:  \rm yes\\
\bf DIAL     \>:  \rm \\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm Spectra idfentifier\\
\bf READ     \>:  \rm Spectra idfentifier\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm Propose a storage for a modified spectrum.\\\\
19 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SAVE (storage)\\
\bf FUNCTION \>:  \rm Save the selected spectrum\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm \\\\
\bf - PARAMETERS -\\
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
20 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SAVE AS ... (storage)\\
\bf FUNCTION \>:  \rm Save the selected spectrum with a new file name\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm New file name (defaut: old name\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
21 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm PRINT CHANLS (storage)\\
\bf FUNCTION \>:  \rm Print the list of the channels value of the active spectrum\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm list of the channels\\
\bf READ     \>:  \rm first and last channel to print (default: all channels)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
22 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm P.S. OUTPUT (storage)\\
\bf FUNCTION \>:  \rm Create a Post-Script file describing the active spectrum\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm create file - print temporary file - create+print\\
\bf READ     \>:  \rm file name.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
23 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm HEADER TO PR (storage)\\
\bf FUNCTION \>:  \rm select the attributs to print with the "print" command of the
                      SCOPE area\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm list of the knwon attributs\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The list is unique for all the spectra.\\\\
24 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SEL PRINTER (storage)\\
\bf FUNCTION \>:  \rm Select the default printer.\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm List of the avalaibles printers (default: last selection)\\
\bf READ     \>:  \rm Name of a new printer.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm All the print output are redirected to the default printer.\\\\
25 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm QUIT (storage)\\
\bf FUNCTION \>:  \rm Quit the visualisation soft\\
\bf CALL     \>:  \rm STORAGE menu\\
\bf DIAL     \>:  \rm yes: alert box for confiramtion.\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm Propose to save the modified spectra (save all in option).\\\\
26 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DRAW SPECT. (image)\\
\bf FUNCTION \>:  \rm Draw the selected spectrum in the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm list of the spectra in memory.\\
\bf READ     \>:  \rm name of a spectrum\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm Need an empty active display area.\\\\
27 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CLEAR SPECT. (image)\\
\bf FUNCTION \>:  \rm Clear spectrum from the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm In case of overlap, all spectra are cleared.\\\\
28 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm OVERLAP (image)\\
\bf FUNCTION \>:  \rm Draw a new spectrum in the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm List of available spectra.\\
\bf READ     \>:  \rm Name of a spectrum.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm all\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
29 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ADD COMMENT. (image)\\
\bf FUNCTION \>:  \rm Add a comment in the active display area\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm Max length of the comment\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm text ot the comment.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm comment.\\\\
\bf COMMENTS \>:  \rm The position of the comment in the image is selected with the 
		      mouse.\\\\
30 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DEL. COMMENT. (image)\\
\bf FUNCTION \>:  \rm Delete a comment in the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes: alert box for confiramation\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm comment.\\
\bf MODIFIED \>:  \rm comment.\\\\
\bf COMMENTS \>:  \rm \\\\
31 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ADD DATE (image)\\
\bf FUNCTION \>:  \rm Write the date and the hour at configurable position in the
                      active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm Position of the date into the image.\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm date of the last edition\\
\bf MODIFIED \>:  \rm date of the last edition\\\\
\bf COMMENTS \>:  \rm \\\\
32 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DEL. DATE (image)\\
\bf FUNCTION \>:  \rm Delete the date from the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm date of the last edition\\\\
\bf COMMENTS \>:  \rm The date of last edition is deleted in the attributs list.\\\\
33 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DEFINE AXES (image)\\
\bf FUNCTION \>:  \rm Define the axes of the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm type of axes (arrow, ..)\\
\bf READ     \>:  \rm Name of the axes, graduation step,....\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm axes\\
\bf MODIFIED \>:  \rm axes\\\\
\bf COMMENTS \>:  \rm \\\\
34 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SMOOTH SPECT. (image)\\
\bf FUNCTION \>:  \rm Smooth the image of the active spectra\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm SMOOTH/RAW\\
\bf MODIFIED \>:  \rm SMOOTH/RAW\\\\
\bf COMMENTS \>:  \rm SMOOTH SPECT is a flipflop command.\\\\
35 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DIVIDE SCREEN\\
\bf FUNCTION \>:  \rm Divide the display area in several display areas.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm Minimum size of a display area.\\
\bf SELECTED \>:  \rm Standards screens.\\
\bf READ     \>:  \rm User's screen\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm A new cutting of the display area provoke a new adjustment of drawn
                spectra.\\\\
36 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm BACKGND COLOR (image)\\
\bf FUNCTION \>:  \rm Define the background color of the active display area.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm availables colors.\\
\bf SELECTED \>:  \rm  background color\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm background color\\\\
\bf COMMENTS \>:  \rm \\\\
37 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm FORGND COLOR (image)\\
\bf FUNCTION \>:  \rm define the color used for draw the active spectrum\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm available colors\\
\bf SELECTED \>:  \rm color of the spectra and name of the spectrum to modify in case of 
                      overlap.\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm Color of the spectrum, bidim/histo\\
\bf MODIFIED \>:  \rm Color of the spectrum\\\\
\bf COMMENTS \>:  \rm Command unavailable for 2 dimensions. spectra.\\\\
38 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm AUTO REFRESH\\
\bf FUNCTION \>:  \rm Set the autorefresh mode for the active spectrum, his associates 
                      and expand spectra.\\
\bf CALL     \>:  \rm IMAGE menu\\
\bf DIAL     \>:  \rm YES\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm Frequency mini, maxi and default.\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Refresh frequency.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
39 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm LIST VALUE (CALIB.)\\
\bf FUNCTION \>:  \rm Make a calibration from a list of points selected with the mouse or
                      with entered with the keyboard.\\
\bf CALL     \>:  \rm CALIB. menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm degree max of the calibration polynome.\\
\bf SELECTED \>:  \rm Calibration functions availables.\\
\bf READ     \>:  \rm degree of the polyn. and list of points\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm calibration, units.\\\\
\bf COMMENTS \>:  \rm \\\\
40 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm POLYN. CALIB. (calib.)\\
\bf FUNCTION \>:  \rm Calibrate the active spectrum with a user's defined polynomial
                      function.\\
\bf CALL     \>:  \rm CALIB.  menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm degree max for a calibration polynome.\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm degree et coefficients.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
41 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm FUNC. CALIB. (CALIB.)\\
\bf FUNCTION \>:  \rm Calibrate the active spectrum with a function from the data base.\\
\bf CALL     \>:  \rm CALIB. menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm available functions\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm calibration, units\\\\
\bf COMMENTS \>:  \rm In this case, the calibration attribut is an entry point in the
                data base.\\\\
42 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CLEAR CHANLS (calcul.)\\
\bf FUNCTION \>:  \rm Reset the values of the channels between the markers\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes: alert box for confirmation\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm This fonction modify the value of the count array\\\\
43 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ADJUST GAIN (calcul.)\\
\bf FUNCTION \>:  \rm Adjust the gain af the active spectrum and his associates.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes + alert box for confirmation.\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm gain\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm This function modify the values of the count array.\\\\
44 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SUBST. SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm Substract 2 spectra.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm spectra to substract\\
\bf READ     \>:  \rm spectre result (default: 1st operand)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The attributs of the result spectrum came from the 1st operand.\\\\
45 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm ADD SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm add 2 spectra.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm spectra to add.\\
\bf READ     \>:  \rm spectra result (default: 1st operand)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The attributs of the result spectrum came from the 1st operand.\\\\
46 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm MULTI. SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm multiply 2 spectra.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm spectra to multiply.\\
\bf READ     \>:  \rm spectrum result (default: 1st operand)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm The attributs of the result spectrum came from the 1st operand.\\\\
\bf COMMENTS \>:  \rm Les attributs du spectre resulat sont ceux du 1er operande.\\\\
47 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DIVID SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm divide 2 spectra.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm spectra to divide\\
\bf READ     \>:  \rm spectra result (default: 1st operand)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The attributs of the result spectrum came from the 1st operand.\\\\
48 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm LIN. COMB. (calcul.)\\
\bf FUNCTION \>:  \rm Calculate a linear combination of several spectra.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm operands spectra\\
\bf READ     \>:  \rm coefficients, operands spectra, spectrum result (default: 1st
                      operand)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\\\
\bf MODIFIED \>:  \rm The attributs of the result spectrum came from the 1st operand.\\
\bf COMMENTS \>:  \rm Les attributs du spectre resulat sont ceux du 1er operande.\\\\
49 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DERIV SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm calculate the derived du spectrum of the active spectrum.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm spectrum result (default: active spectrum)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm  The derived spectrum had the attributs of the active spectrum.\\\\
50 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm INTEG. SPECT. (calcul.)\\
\bf FUNCTION \>:  \rm Calculate the integrated spectra of the active spectrum.\\
\bf CALL     \>:  \rm CALCUL menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm spectrum result (default: active spectrum)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm Les attributs du spectre resulat sont ceux du spectre actif .\\\\
51 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SELECT POINTS (backgnd.)\\
\bf FUNCTION \>:  \rm Describe the background from a list of segments.\\
\bf CALL     \>:  \rm BACKGND menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm degree max of the calibration polynome.\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm list of segments, degree of the calibration polynome.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm background\\\\
\bf COMMENTS \>:  \rm The segments can be chosen with the mouse or the keyboard.\\\\
52 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm POLYNOMIALS (backgnd.)\\
\bf FUNCTION \>:  \rm Describe the background with a polynomial function.\\
\bf CALL     \>:  \rm BACKGND menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm degree max of the polynome.\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm coefficents, degree of the polynome.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm background\\\\
\bf COMMENTS \>:  \rm \\\\
53 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm BG FUNCTIONS (backgnd.)\\
\bf FUNCTION \>:  \rm Describe the background with a function of the data base.\\
\bf CALL     \>:  \rm BACKGND menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm available functions.\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm background\\\\
\bf COMMENTS \>:  \rm The background attribut is an entry point in the data base.\\\\
54 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SEARCH PEAKS (peaks)\\
\bf FUNCTION \>:  \rm Search, in the channels between the markers, the peaks in the
                      activate spectrum and his associates and \\
             \>:  \rm expand spectra.\\
\bf CALL     \>:  \rm PEAK menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Detection threshold.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm peaks\\
\bf MODIFIED \>:  \rm peaks\\\\
\bf COMMENTS \>:  \rm The found peaks are overlined on the screen.\\\\
55 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SELECT PEAKS (peaks)\\
\bf FUNCTION \>:  \rm Give the characteristics of the peak selected with the mouse on the
                      active spectrum.\\
\bf CALL     \>:  \rm PEAKS menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm comment\\\\
\bf COMMENTS \>:  \rm The result is written on the display area like a comment\\\\
56 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm FIT (peaks)\\
\bf FUNCTION \>:  \rm Fit the peaks detected between the markers.\\
\bf CALL     \>:  \rm PEAKS menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm Fit Function, suppress the background(on/off).\\
\bf READ     \>:  \rm Number of peaks.\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm Background\\
\bf MODIFIED \>:  \rm peaks-fit\\\\
\bf COMMENTS \>:  \rm The fit line is plotted on the display area.\\\\
57 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm INTEGRATION\\
\bf FUNCTION \>:  \rm Integrate the spectrum between the markers\\
\bf CALL     \>:  \rm PEAKS ,menu\\
\bf DIAL     \>:  \rm yes for display the result.\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm suppress the background (on/off), write the result on the screen
                (on/off).\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm background\\
\bf MODIFIED \>:  \rm Comment\\\\
\bf COMMENTS \>:  \rm If the display of the result is on, the result is stored in the
                attribut list like a comment.\\\\
58 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CREATE CONT. (2 dim.)\\
\bf FUNCTION \>:  \rm Create a contour in a 2 dims spectrum. The points defining the
                      contour are selected with the mouse. \\
             \>:  \rm The contour is automatically
                      closed\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm contour\\\\
\bf COMMENTS \>:  \rm \\\\
59 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm RESTORE CONTOUR (2 dim.)\\
\bf FUNCTION \>:  \rm Display in the active display area a contour stored in the list of
                      attributs.\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm stored contours\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm contours\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
60 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm DELETE CONTOUR (2 dim.)\\
\bf FUNCTION \>:  \rm Delete from the active display area a contour but let it in the
                      list of attributs.\\
\bf CALL     \>:  \rm 2 DIM menu\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
61 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm RESTORE CONTOUR (2 dim.)\\
\bf FUNCTION \>:  \rm Display on the active display area a contour stored in the list
                      of attributs\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm Stored contours\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm contours\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
62 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm Erase CONTOUR\\
\bf FUNCTION \>:  \rm Delete a contour from the active display area and rase it from the
                      list of attributs.\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm no\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm La selection du contour se fait en cliquant sur le point de depart\\\\
63 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm EXTRACT CONTOUR (2 dim.)\\
\bf FUNCTION \>:  \rm Annul the channels out of the selected contour.\\
\bf CALL     \>:  \rm 2 DIM menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Name of the new spectrum (default: active spectrum)\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm contours\\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm The new spectrum had the sames attributs that the active spectrum.\\\\
64 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm INTEGR. CONTOUR (2 dim.)\\
\bf FUNCTION \>:  \rm Integrate the count number in the selected contour.\\
\bf CALL     \>:  \rm 2 DIM menu\\
\bf DIAL     \>:  \rm yes for display the result\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm display the result on the screen (on/off)\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm comments\\\\
\bf COMMENTS \>:  \rm The result can be stored like a comment attribut.\\\\
65 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SLICE X (Y) (2 dim.)\\
\bf FUNCTION \>:  \rm Show a slice (X or Y) of the active spectrum.\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm yes for diplay the result.\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm save (on/off)\\
\bf READ     \>:  \rm Name of the result spectrum\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm slice (link to the spectrum slice)\\\\
\bf COMMENTS \>:  \rm \\\\
66 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm PROJECTION X (Y) (2 dim.)\\
\bf FUNCTION \>:  \rm Show a projection of the active spectra.\\
\bf CALL     \>:  \rm Menu 2 DIM.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm save (on/off)\\
\bf READ     \>:  \rm Name of the result spectrum\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm projection (link to the spectrum slice)\\\\
\bf COMMENTS \>:  \rm \\\\
67 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm COLOR SCALE (2 dim.)\\
\bf FUNCTION \>:  \rm Define the color scale for a 2 dims spectum\\
\bf CALL     \>:  \rm 2 DIM menu.\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm Colors available\\
\bf SELECTED \>:  \rm \\
\bf READ     \>:  \rm Selection of the color slices\\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm color scale\\
\bf MODIFIED \>:  \rm color scale\\\\
\bf COMMENTS \>:  \rm Must be used for define the display threshold.\\\\
68 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm SPECTRA (data base)\\
\bf FUNCTION \>:  \rm access to the references spectra in the data base\\
\bf CALL     \>:  \rm DATA BASE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm Available spectra.\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
69 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm GAMMA DATA BASE (data base)\\
\bf FUNCTION \>:  \rm access to the gamma data base.\\
\bf CALL     \>:  \rm DATA BASE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm available datas\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm \\\\
70 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\bf COMMAND  \>:  \rm CALIBRATION (BACKGROUND) FUNCTIONS (data base)\\
\bf FUNCTION \>:  \rm access to the calibration (background ) function of the data base.
                      donnee.\\
\bf CALL     \>:  \rm DATA BASE menu\\
\bf DIAL     \>:  \rm yes\\\\
\bf - PARAMETERS -\\ 
\bf FIXED    \>:  \rm \\
\bf SELECTED \>:  \rm available functions.\\
\bf READ     \>:  \rm \\\\
\bf - ATTRIBUTS -\\
\bf READ     \>:  \rm \\
\bf MODIFIED \>:  \rm \\\\
\bf COMMENTS \>:  \rm Protocoles d'acces a la B de D non definis.\\\\
 -------------------------------------------------------------------------------
----------------------------------------------------------------------------------\\\\
\end{tabbing}
\small

%%%%%%%%%%%%%%%%%%%%%%% CHAP DATA STRUCTURE %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{DATA STRUCTURE}
\section{Spectrum's state}

	A spectrum can be in one of the three following states:

\begin{itemize}
\item 	STORED: A stored spectrum must be copied into memory from a storage
	device before displayed. The data associated with the spectrum are the header 
	block, the count block and the attribut list.
\item 	IN MEMORY: A spectrum loaded in memory can be drawn on the screen. The data
	associated with the spectrum are the header block, the count block the
	attribut list,and the status. The status indicates the state of the spectrum 
	with respect to the dislay screen ((not)drawn, permissions,....).
\item 	ON THE SCREEN: To manipulate a spectrum, it is necessary to
	add to the previous data a description of the display environment. (colors,
	cursors,.... ).
\end{itemize}

\section{Spectrum's description}
	Each state of a spectrum has specific data (Fig 3).

\begin{itemize}
\item 	The spectrum body (header block + data block+ attributs) is stored on disk
	during the life of the spectrum.
\item 	The spectrum state (body + status) is stored in memory during the life of the 
	spectrum in memory.
\item 	The spectrum image (state + positions) is stored in memory while the spectrum
	is drawn on the screen.
\end{itemize}

\begin{figure}
\psfig{figure=edoc112_fig3.ps,width=13cm,height=10cm}
\end{figure}

\section{Spectrum body}

	The spectrum body regroups the header block, the count array and the attribut
	list and is stored on disk.
\subsection{Data, header}

	These blocks are defined in EDOC102. (header bloc=n*512 bytes, data block =
	n*512 bytes).

\subsection{Attributs}

	The attribut list contains the datas (count chanel + analysis work).

	Exemples of attributs:

\begin{itemize}
\item	DRAWING WINDOW: part of the spectrum to draw(Xm, XM, Ym, YM)
\item 	AXES: Graduation, mame of axes.
\item 	ECHELLE: drawing scale.
\item 	LOG-LIN: Flag for lin-log axes
\item 	HISTO-BIDIM: 
\item 	SMOOTH-RAW: Flag for smooth drawing
\item 	CALIBRATION: Calibration function.
\item 	CANAL POINTED: Last canal pointed.
\item 	MARKERS: Definition of the markers.
\item 	FIT: Fit of peaks.
\item 	PEAKS: Definition of selected peaks.
\item 	BRUIT: Background definition.
\item 	PATH: Pathname of the storage file.
\item 	ASSOCIATE SPECTRA: Identification of the associate spectra.
\item 	COLORATION: Drawing color.
\item 	PERMISSIONS: .
\item 	OTHERS ........
\end{itemize}

	The content of the attributs depend on the functions of the different software 
	using the spectrum.
	It should be possible to add new attributs without modifying those already 
	recorded.

	A spectrum hase not necessarily all the available attributs. We store only the
	defined attributs for a spectrum.

	The diversity of attributs doesn't permit recording them with the same
	format. Ther considerations bring us to structure the attributs in a list 
	composed of a variable  number of items. Each item has a varaiable length.


	Each function reads the list and interpret the recognized attribut. 
	Each attribut has an identifier, followed by a status, followed by the data
	length, followed by the data (see fig 4).

	Each attribut has a specific data format.

\begin{figure}
\psfig{figure=edoc112_fig4.ps,width=13cm,height=10cm}
\end{figure}

\section{Spectrum state}
\subsection{Spectrum body}
	The spectrum state contains the spectrum body (see previous section). 

\subsection{Status}
	The status describes in memory the state of the spectrum relativeled to the
	display software.

	This structure is created when loaded from disk, and destroy with the "close"
	command.
	
	Content of the status structure:

\begin{itemize}
\item 	MODIFICATION: The spectrum is modified since the last save.
\item 	ACCUMULATION: The spectrum is accumulating (anywhere)
\item 	RERESH FREQUENCY: Frequency used for the auto refresh mode.
\item 	DRAWN: The spectrum is actually drawn on the screen.
\item 	OTHERS......
\end{itemize}

\section{Image}
\subsection{Spectrum state}
	The spectrum image content the spectrum state (see previous section).

\subsection{Positions}
	The position structure contains the paremeters necessary to draw the spectrum on
	screen.

\begin{itemize}
\item IDENTIFICATION OF THE DISPLAY AREA:
\item SIZE OF THE DISPLAY AREA: Depends on the screen partition.
\item MONOCHROME-COLOR:
\item BACKGROUND COLOR:
\item ACTIVE/ASSOCIATE/EXPAND/LOCK: Status of the display area.
\item OTHERS......
\end{itemize}

\section{Structure in memory}
	The spectrum implantation in memory is defined in document EDOC061. We expect
	to link the attribut list to the information-1-pointer field of the header 
	(Fig 5). 

\begin{figure}
\psfig{figure=edoc112_fig5.ps,width=13cm,height=10cm}
\end{figure}
	
\end{document}

