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)