OHI - Help
Select One of the following topics :
open a window for OHI
'ohi' start OHI
'a' accept setup
's' start histogram filling
open another window for PAW
'pawX11' or 'paw++' start PAW
'global ohi' access to global section created by OHI
'hi/li' list histogram names and numbers
'hi/pl ...' plot histograms
'exec ...' run macros
'...' ...
OHI is a system for online display of converter spectra.
It is written in C and uses CERN HBOOK software package.
Configuration and definition of histograms is done automatically,
using the experiment setup information in the shared memory
section created by the standard COSY data aquisition system.
Histogram ranges are based on the properties of the converters,
binsizes depend on the available storage and are therefore
determined by the total number of histograms.
Numbering is done according to the logical location of the
converters in the aquisition system, i.e. the histogram number
is combined of the instrumentation system (IS), the slot number
(SL), and the converter number (CH):
IS*1000000 + SL*10000 + CH
In addition, overview histograms are created which count
the number of hits in each converter giving a global overview
over the whole aquisition system and each instrumentation
system.
The whole setup can be overwritten by the user.
Histograms can be switched off, thus allowing to use more
storage for the remaining histograms, e.g. by increasing
the number of bins.
Furthermore, it is possible to assign several converters
to one histogram.
Histograms are created in the global section 'OHI' which
can be accessed by PAW with the command 'global OHI',
thus enabling the user to control the data aquisition
online.
OHI offers an easy to use menue system consisting of several
menue screens.
After starting the program by typing 'ohi' the first screen
shows some useful information which may differ from experiment
to experiment:
____________________________________________________________________________
| (c)T.Sefzick|
| OOO H H IIIII 11.04.94|
| O O H H I |
| O O HHHHH I |
| O O H H I |
| OOO nline H Histograms IIIIInterface |
|____________________________________________________________________________|
| |
| |
| |
| |
| p_ec->hc.exp_no = 136 |
| p_ec->hc.exp_name = "COSY#36 Experiment Instrumentation" |
| p_ec->hc.date = 22-mar-1994 15:25:00.00 |
| p_ec->hc.no_crates = 2 |
| |
| |
| ALPHA OSF_1 version |
|____________________________________________________________________________|
| | |
| number of histograms : 0 | memory needed : 0 words |
| | appr. available : 96000 words |
|_____________________________________|______________________________________|
____________________________________________________________________________
| (c)T.Sefzick|
| OOO H H IIIII 11.04.94|
| O O H H I |
| O O HHHHH I |
| O O H H I |
| OOO nline H Histograms IIIIInterface |
|____________________________________________________________________________|
| | |
| S E T U P M E N U E |
| | |
| A : Accept setup | <-- initialize HBOOK histograms |
| V : View setup | <-- view current internal setup |
| C : Change setup | <-- modify current internal setup |
| S : Show equipment | <-- print crates/modules to screen |
| | |
| X : eXit | <-- terminate OHI |
| | |
| enter selection : | |
|_____________________________________|______________________________________|
| | |
| number of histograms : 103 | memory needed : 15307 words |
| | appr. available : 96000 words |
|_____________________________________|______________________________________|
Installs current setup, i.e. histograms are defined.
After installation the Run Menue
is entered.
The setup is written to a temporary file, and a file viewer
(e.g. 'view') is started to view this
Setup File.
____________________________________________________________________________
| (c)T.Sefzick|
| OOO H H IIIII 11.04.94|
| O O H H I |
| O O HHHHH I |
| O O H H I |
| OOO nline H Histograms IIIIInterface |
|____________________________________________________________________________|
| | |
| W O R K W I T H S E T U P F I L E S |
| | |
| R : Replace setup | <-- read complete setup from file |
| M : Modify setup | <-- read modifications from file |
| W : Write setup file | <-- current internal setup to file |
| E : Edit setup file | <-- for use with modify or replace |
| A : Automatic setup | <-- reset to default setup |
| N : New setup | <-- delete current internal setup |
| Q : Quit | <-- return to SETUP MENUE |
| enter selection : | |
|_____________________________________|______________________________________|
| | |
| number of histograms : 103 | memory needed : 15307 words |
| | appr. available : 96000 words |
|_____________________________________|______________________________________|
The current setup is deleted and a new setup is read from a file.
This file has to fulfill the requirements for
replacing a setup.
The current setup is not deleted but
modified by commands read
from a file.
The current setup is written to file for editing and
later reloading.
An editor (e.g. 'vi') is started for editing an existing
setup file which can be used for later replacement or
modification of the current setup.
The default setup as generated at program start is rebuilt.
All histogram definitions are cleared, only the overview
histograms remain.
The equipment of all instrumentation systems with converter
modules is shown, other modules are not shown.
CAMAC-IS: 2 slot: 1
CAMAC-IS: 2 slot: 2
CAMAC-IS: 2 slot: 3
CAMAC-IS: 2 slot: 4
CAMAC-IS: 2 slot: 5
CAMAC-IS: 2 slot: 6
CAMAC-IS: 2 slot: 7 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 8 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 9 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 10 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 11 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 12
CAMAC-IS: 2 slot: 13 IS: 1 # of CAMAC QDC: 16 range: 2048
CAMAC-IS: 2 slot: 14
CAMAC-IS: 2 slot: 15
CAMAC-IS: 2 slot: 16
CAMAC-IS: 2 slot: 17
CAMAC-IS: 2 slot: 18
CAMAC-IS: 2 slot: 19
CAMAC-IS: 2 slot: 20
CAMAC-IS: 2 slot: 21
CAMAC-IS: 2 slot: 22
CAMAC-IS: 2 slot: 23
CAMAC-IS: 2 slot: 24
____________________________________________________________________________
| (c)T.Sefzick|
| OOO H H IIIII 11.04.94|
| O O H H I |
| O O HHHHH I |
| O O H H I |
| OOO nline H Histograms IIIIInterface |
|____________________________________________________________________________|
| | |
| R U N M E N U E |
| | |
| S : Start histogram filling | <-- start histogram filling |
| C : Clear histogram contents | <-- clear histogram contents |
| | |
| | |
| | |
| Q : Quit | <-- return to SETUP MENUE |
| | |
| enter selection : | |
|_____________________________________|______________________________________|
| | |
| number of histograms : 103 | memory needed : 15307 words |
| | appr. available : 96000 words |
|_____________________________________|______________________________________|
All histograms are cleared, i.e. their contents are set to
zero but they are still defined.
Histogram filling is started using events that are delivered
by the event distributor.
Because histograms are updated in the global section 'OHI',
histograms can be viewed with PAW.
The general syntax for setup files is:
IS slot channel fill_it hist_num 'name' xmin xmax xbin
The values must be in the allowed ranges:
1 <= IS < max_is
0 <= slot < max_slots
0 <= channel < max_chan
-1 <= fill_it <= 1
0 <= xmin < xmax
1 <= xmax < ?
1 <= xbin < xmax-xmin
All values must be given.
1 7 0 1 1070000 ' IS-1 SL-7 CH-0 CAMAC-QDC ' 0 2048 20
1 7 1 1 1070001 ' IS-1 SL-7 CH-1 CAMAC-QDC ' 0 2048 20
1 7 2 1 1070002 ' IS-1 SL-7 CH-2 CAMAC-QDC ' 0 2048 20
1 7 3 1 1070003 ' IS-1 SL-7 CH-3 CAMAC-QDC ' 0 2048 20
1 7 4 1 1070004 ' IS-1 SL-7 CH-4 CAMAC-QDC ' 0 2048 20
1 7 5 1 1070005 ' IS-1 SL-7 CH-5 CAMAC-QDC ' 0 2048 20
1 7 6 1 1070006 ' IS-1 SL-7 CH-6 CAMAC-QDC ' 0 2048 20
1 7 7 1 1070007 ' IS-1 SL-7 CH-7 CAMAC-QDC ' 0 2048 20
1 7 8 1 1070008 ' IS-1 SL-7 CH-8 CAMAC-QDC ' 0 2048 20
1 7 9 1 1070009 ' IS-1 SL-7 CH-9 CAMAC-QDC ' 0 2048 20
1 7 10 1 1070010 ' IS-1 SL-7 CH-10 CAMAC-QDC ' 0 2048 20
1 7 11 1 1070011 ' IS-1 SL-7 CH-11 CAMAC-QDC ' 0 2048 20
1 7 12 1 1070012 ' IS-1 SL-7 CH-12 CAMAC-QDC ' 0 2048 20
1 7 13 1 1070013 ' IS-1 SL-7 CH-13 CAMAC-QDC ' 0 2048 20
1 7 14 1 1070014 ' IS-1 SL-7 CH-14 CAMAC-QDC ' 0 2048 20
1 7 15 1 1070015 ' IS-1 SL-7 CH-15 CAMAC-QDC ' 0 2048 20
1 8 0 1 1080000 ' IS-1 SL-8 CH-0 CAMAC-QDC ' 0 2048 20
1 8 1 1 1080001 ' IS-1 SL-8 CH-1 CAMAC-QDC ' 0 2048 20
1 8 2 1 1080002 ' IS-1 SL-8 CH-2 CAMAC-QDC ' 0 2048 20
1 8 3 1 1080003 ' IS-1 SL-8 CH-3 CAMAC-QDC ' 0 2048 20
1 8 4 1 1080004 ' IS-1 SL-8 CH-4 CAMAC-QDC ' 0 2048 20
1 8 5 1 1080005 ' IS-1 SL-8 CH-5 CAMAC-QDC ' 0 2048 20
. . . . .
In files used to replace a setup all values must be given,
while for modifying a setup several abbreviations are allowed.
The general syntax for setup files is:
IS slot channel fill_it hist_num 'name' xmin xmax xbin
The values must be in the allowed ranges:
1 <= IS < max_is
0 <= slot < max_slots and -1 (all slots in CR or IS)
0 <= channel < max_chan and -1 (all ch's of specified slot(s))
-1 <= fill_it <= 1 (no change,no,yes)
0 <= xmin < xmax and -1 (no change)
1 <= xmax < ? and -1 (no change)
1 <= xbin < xmax-xmin and -1 (no change)
h
c f i
h i s
a l t
s n l _ n x x x
l n _ n a m m b
I o e i u m i a i
S t l t m e n x n
addressing:
2 -1 -1 -> modify all slots and channels of IS '2',
2 -1 -1 -> equal to previous line
2 4 -1 -> modify all channels of slot '4' in IS '2'
2 4 7 -> modify channel '7' of slot '4' in IS '2'
commands:
. . . 1 -> define histogram, set filling on
. . . 0 -> no histogram for this channel, filling off
. . . -1 -> don't change any fill_it settings
. . . . 99 -> define PAW histogram number
. . . . . 'abc' -> define PAW histogram name
. . . . . . 99 -> set xmin to '99'
. . . . . . -1 -> don't change xmin
. . . . . . . 99 -> set xmax to '99'
. . . . . . . -1 -> don't change xmax
. . . . . . . . 99 -> set xbin to '99'
. . . . . . . . -1 -> don't change xbin
Some examples with explanations:
1 1 -1 0 -> switch histogramming of all channels of
slot '1' in IS '1' off
3 -1 -1 0 -> switch histogramming of IS '3' off
3 18 -1 0 -> switch histogramming of all channels of
slot '18' in IS '3' off
2 1 10 0 -> switch histogramming of channel '10' of
slot '1' in IS '2' off
3 18 60 0 -> switch histogramming of channel '60' of
slot '18' in IS '3' off
3 -1 -1 0
3 18 60 1 -> switch histogramming of IS '3' off and
channel '60' of slot '18' in IS '3' on
2 1 -1 -1 1 -> histogram all channels of slot '1' in
IS '2' with fill_it='1' into PAW
histogram '1' (don't change any fill_it)
2 1 -1 -1 1 'abc' -> same as previous example plus naming
histogram 'abc'
1 1 -1 -1 -1 '' 10 -> set xmin of all histograms for all
channels of slot '1' in IS '1' to '10'
1 1 -1 -1 '' 10 -> same as previous line (omitting fill_it
means '-1')
1 1 -1 '' 10 -> same as previous line (omitting fill_it
and hist_num means '-1 -1')
1 1 -1 '' -1 1000 -> set xmax of all histograms for all
channels of slot '1' in IS '1' to '1000'
3 18 -1 '' -1 -1 5 -> set binsize of all histograms for all
channels of slot '18' in IS '3' to '5'
written by
Thomas Sefzick
t.sefzick@fz-juelich.de