Measurement program for Optical Multi-channel Analyzer. OMA Spectrum Scan application basis.
Introduction

The OMASCN module provides the basis for the spectrum scan measurement
applications for the delta-epsilon 4 setup.

To this end it provides two classes.

- Class OmaScan is a base class for the application class SpectrumScan.
  It contains the menu and plot framework used in this application.

- Class PropMeas provides a dialog class with which the measurement
  properties like 'beep after measurement' and the data filename format
  and the data directory can be specified. The datafilename format and
  the data directory are passed to theNameServer (see rulutl library).

The next sections describe the application menu and the methods to be defined
in an application.


Menu overview

OmaScan has seven menu buttons, a plot draw canvas with popup menu (View)
and a frame message field.

An overview of the menu is shown below.

File		Edit		View		Prop		Instrum		Measure         Options
----------	----------	----------	----------	----------	----------      ----------
Load...		Cursor		Clear		Load...		Initialize	Parameters...   Load setup...
Save as...	Zoom in		Reset		Print...	----------	Delay points... Save setup...
Change Dir	Zoom out	----------- 	Plot...		Detector...     Status...
-----------   	-----------	Cut		-----------	Delay-line...   ----------
Print plot	Axis      >	Delete          Instrum  >	----------      Tracks  Ref,Prb
Print screen	Color     >	Duplicate	Measure...	Timer...	Intensity Ip,Ir
		Grid      >	Move		----------      Delay_hr1...    Transmission  T
		Date      >	Scale		About           Delay_hr2...	Absorption    A
		Key       >	Smooth		Info            Delay_hr3...	Delta Abs. Ae-Ag
		Ticks     >     -----------                     Delay_hr4...	----------
				Swap                            Delay_hr5...	Measure new
				Rotate				----------	Measure continued
								Steppingmotor...


Apart from the Instrum and the Measure submenus, a description of the
submenus can be found in the 'Ezview Graphic User Interface User's Guide',
as of December 23, 1993.

The Prop|Instrum submenu let you choose between Normal and Group instrument
dialogs. With a Normal instrument dialog you set the typical instrument
properties, with a Group dialog e.g. for Rulbus devices, you specify the
Rulbus properties like rulbus converter base address, rulbus device rack
number and rulbus device base address.

The Instrum|Initialize command re-initializes all Rulbus devices with their
current settings. This can be useful when a Rulbus rack has been turned off
and on again.

With the Prop|Measure dialog measurement properties like 'beep after
measurement', the data filename format and the data directory can be
specified. The datafilename format and the data directory are passed
to theNameServer (see rulutl library).


Methods to be specified

Here is a list of methods that must be defined in a derived application class
to be able to make an instance of it.

Type information
- isA		 - type number
- nameOf	 - type name

Menu actions
- editText	 - edit the textual file of a data set
- propAbout	 - application version information
- measParm	 - measurement parameters dialog
- measNew	 - make a new measurement
- measCon	 - make a continued measurement
- loadSetup      - load setup from a file
- saveSetup      - write setup to a file

Button/dialog events
- _editTextEvent - textual file edit dialog
- _editTxt1Event - textual file edit update
- _instOma4Event - Oma4 parameter dialog
- _instDlayEvent - delay-line parameter dialog
- _measParmEvent - measurement parameters update
- _measPntsEvent - delay points parameter dialog

Other
- preProcess	 - preparation for measurement
- postProcess	 - processing after measurement
- saveAll	 - save measurement data
- discardAll     - discard measurement data
- updatePlot	 - update plot window

To implement the loading and saving of measurement parameters in separate
configuration files, the following methods must be defined.

Save/restore measurement parameter setup
- saveSetup        - write measurement parameters to file
- loadSetup	   - read measurement parameters from file

To implement the application initialization file, the following methods
must also be defined.

Save/restore setup
- _print	 - write application parameters to stream
- _scan		 - scan application parameters from stream


OMA Spectrum Scan application.
Introduction

The SPCSCN module is an Ezview application to make spectra measurements
over a range of delay-line settings with the delta-epsilon 4 setup.

A spectrum scan consists of one or more scans in which a laser pump-pulse
induced absorption difference is measured for various delays between the
laser pump-pulse and the laser probe-pulse. The traces measured are averaged
to obtain the end result.

Among other things (see OMASCN), the SpectrumScan application class provides
a dialog to specify the measurement parameters (Measure|Parameters), a dialog
to specify the delay points to use (Measure|Delay points), a dialog to specify
the Oma settings (Intrument|Detector) and commands to help adjustment of the
setup (Measure|Intensity, Measure|Transmission, Measure|Absorption and
Measure|Delta abs.), start a new measurement (Measure|Measure new), or
to continue with a measurement (Measure|Measure continued).

The next section describes the Measure|Parameters, Measure|Delay points and
Instrument|Detector dialogs.


Measure|Parameters dialog

The Measure|Parameter dialog looks like the figure below.

.------------------------------------------------------------------------------.
| .-|=)    		   Measure: Parameters				       |
|------------------------------------------------------------------------------|
| Parameters:                     Comments:                                    |
| Scans total       [#]: ______   1: ________________________________________  |
| Scans actual      [#]: ______   2: ________________________________________  |
| Points per scan   [#]: ______   3: ________________________________________  |
| Shots preparation [#]: ______   4: ________________________________________  |
| Shots per point   [#]: ______   5: ________________________________________  |
| Shots background  [#]: ______   6: ________________________________________  |
| Shots threshold   [#]: ______   7: ________________________________________  |
| Plot update       [s]: ______   8: ________________________________________  |
|                                                                              |
| Delay [s]                    From: ______  To: ______                        |
|                                                                              |
| Probe overload check range    Min: ______ Max: ______                        |
| Reference intensity threshold Min: ______ Max: ______                        |
|                                                                              |
| Measure:                           Delay Points:                             |
| [ Absorption ][ Transmission ]     [ Calculated ][ Specified ]               |
|                                                                              |
| Plot:                                                                        |
| [Ipebg][Ipgbg][Irebg][Irgbg][ Irth ][ Ag ][ Ae ][ Ad ][ Ad-1 ][ Ad-2 ]       |
|                                                                              |
|					         ( Apply )   ( Cancel )        |
|------------------------------------------------------------------------------|
| Setup file: 951212tx.000                                                     |
`------------------------------------------------------------------------------'

It contains a push-pin in the unpinned state, a block for scan
related issues, eight lines for comments, two fields to specify
the range of delay points to use, two fields to specify the range
of bins to check for overload, two fields to specify the threshold
range for the reference intensity, a radio button to select either
absorption or transmission measurement, a radio button to select
either calculated or specified delay points, eight buttons to select
the curves to plot, an Apply and Cancel button and a frame message
indicating the name of the file in which this textual information will
be saved.

The dialog entry fields have the following meaning.

Parameters
- Scans total       [#]: number of scans to average
- Scans actual      [#]: number of scans actually made
- Points per scan   [#]: number of delay points in scan
- Shots preparation [#]: number of laser shots before data acquisition
- Shots per point   [#]: number of laser shots per point to average
- Shots background  [#]: number of laser shots to determine background intensity
- Shots threshold   [#]: number of laser shots to determine threshold intensity
- Plot update       [s]: number of seconds between screen updates

Delay
- From: first delay point for calculated delay points [s]
- To  : last delay point for calculated delay points [s]

Probe overload check range
- Min: check range start (0..1)
- Max: check range end   (0..1)

Reference intensity threshold
- Min: low  check factor (0.1 ..  1)
- Max: high check factor (1   ..100)


The dialog buttons have the following meaning.

Measure
- [ Absorption ]   : measure absorption
- [ Transmission ] : measure transmission

Delay Points
- [ Calculated ]   : calculate delay points from From: and To: fields
- [ Specified ]    : use delay points as specified in Measure|Delay points

Plot
- [ Ipebg ]: plot probe excited background intensity
- [ Ipgbg ]: plot probe non-excited background intensity
- [ Irebg ]: plot reference excited background intensity
- [ Irgbg ]: plot reference non-excited background intensity
- [ Irth ] : plot reference threshold intensity
- [ Ag ]   : plot ground (non-excited) absorption  (Tg   ground transmission)
- [ Ae ]   : plot excited absorption               (Te   excited transmission)
- [ Ad ]   : plot absorption difference            (Td   difference transmission)
- [ Ad-1 ] : plot last absorption difference       (Td-1 last transmission difference)
- [ Ad-2 ] : plot beforelast absorption difference (Td-2 beforelast transmission difference)


Comments:
At last the dialog contains six lines for comments.

It is possible to increase the value of 'Scans total' between measurements
and then continue the measurement (Measure|Measure continued) to obtain a
further averaged result.


Measure|Delay points dialog

The Measure|Delay Points dialog looks like the figure below.

.--------------------------------------------------------------.
| .-|=)              Measure: Delay Points                     |
|--------------------------------------------------------------|
|  1: ______  11: ______  21: ______  31: ______  41: ______   |
|  2: ______  12: ______  22: ______  32: ______  42: ______   |
|  3: ______  13: ______  23: ______  33: ______  43: ______   |
|  4: ______  14: ______  24: ______  34: ______  44: ______   |
|  5: ______  15: ______  25: ______  35: ______  45: ______   |
|  6: ______  16: ______  26: ______  36: ______  46: ______   |
|  7: ______  17: ______  27: ______  37: ______  47: ______   |
|  8: ______  18: ______  28: ______  38: ______  48: ______   |
|  9: ______  19: ______  29: ______  39: ______  49: ______   |
| 10: ______  20: ______  30: ______  40: ______  50: ______   |
|                                                              |
|	 			      ( Apply )   ( Cancel )   |
|--------------------------------------------------------------|
| Setup file: 951212tx.000                                     |
`--------------------------------------------------------------'

It contains a push-pin in the unpinned state, fifty lines specifying the
delay value for each delay point, an Apply and Cancel button and a frame
message indicating the name of the file in which this textual information
will be saved. Delay must be specified in seconds, like 1.23n for 1.23e-9 [s].


Intrument|Detector dialog

The Intrument|Detector dialog looks like the figure below.

.-------------------------------------------------.
| .-|=)        Instrument: Detector               |
|-------------------------------------------------|
|                                                 |
| General:                                        |
|                                                 |
| Binning             (   4    > )                |
|                                                 |
| Pixel time          ( Normal > )                |
|                                                 |
| Shutter mode        ( Normal > )                |
|                                                 |
| CCD temperature [øC]: ______                    |
| Anti bloom       [%]: ______                    |
| Exposure time    [s]: ______                    |
|                                                 |
| Tracks:                                         |
| Probe          start: ______   size: ______     |
| Reference      start: ______   size: ______     |
|                                                 |
| Interface:                                      |
| Port         address: ______                    |
| Memory       address: ______   size: ______     |
|                                                 |
|	 		 ( Apply )   ( Cancel )   |
|-------------------------------------------------|
| Setup file: 951212tx.000                        |
`-------------------------------------------------'

It contains a push-pin in the unpinned state, menubuttons for binning,
pixel time and shutter mode, entry fields for the CCD temperature,
anti blooming, exposure time, entry fields for the probe and reference
track position and size, entry fields for the PC-bus interface, an Apply
and Cancel button and a frame message indicating the name of the file in
which this information will be saved.

The dialog buttons have the following meaning.

Binning
- (  1 ) :  1 pixel  per bin
- (  2 ) :  2 pixels per bin
- (  4 ) :  4 pixels per bin
- (  8 ) :  8 pixels per bin
- ( 16 ) : 16 pixels per bin
- ( 32 ) : 32 pixels per bin
- ( 64 ) : 64 pixels per bin

Pixel time
- ( Normal ) : normal digitizing of CCD charge
- ( Fast   ) : fast   digitizing of CCD charge
- ( Slow   ) : slow   digitizing of CCD charge

Shutter mode
- ( Normal ) : open shutter for exposure, close it before readout
- ( Closed ) : keep shutter closed
- ( Open   ) : keep shutter opened


The dialog entry fields have the following meaning.

General:
- CCD temperature [øC]: temperature of CCD
- Anti bloom       [%]: antiblooming percentage ( 0   ..100% )
- Exposure time    [s]: CCD exposure time       (10ms .. 12hr)

Tracks:
- Probe     start: start of probe track     (1..512)
- Probe     size : size  of probe track     (1..512)
- Reference start: start of reference track (1..512)
- Reference size : size  of reference track (1..512)

Interface:
- Port   address: PC-bus I/O port address of OMA-controller    (   0x200..   0x800)
- Memory address: PC-bus memory base address of OMA-controller (0x800000..0xC00000)
- Memory    size: PC-bus memory size of OMA-controller         (0x200000..0x800000)