IMP-8 High Gain Plot Program
User's guide
1. GENERAL DESCRIPTION
The IMP-8 High Gain Plot program produces up to 20 matrices from IMP-8
Summary files specified implicitly by 4-day interval number. The program
has the capability to merge data from up to 100 intervals (not
necessarily consecutive), to optionally gain shift the data on an
interval basis, and to optionally provide histogram.
Processing is controlled by event identification cards and by time
indicator cards. Each event identification card (maximum of 20)
specifies the detectors, event type, compression factor, histogram
parameters, and E-band (D vs F only) for one matrix. Each time
indicator card specifies either start and stop interval numbers to be
processed; and, optionally specifies gain shift factors to be applied
to that data. All matrices specified by event identification cards are
produced for all time periods specified by time indicator cards.
As mentioned above, a maximum of 100 intervals may be processed in any
run.
2. INPUT PARAMETER CARDS
Card 1 (Event Identification Card)
Name Column Format Description
ITYPE 1-4 A4 Plot type desired
(AVSB, DVSE or DVSF)
IEV 6-9 I4 Event type requested
LED (AVSB) plots :
IEV is a 4 digits integer I1I2I3I4 with
0<=Ij<=2 for j=1,4
If Ij=0, then the LED Tj event type bit
must be 0 for an event to be
plotted.
If Ij=1, then the LED Tj event type bit
must be 1 for an event to be
plotted.
If Ij=2, then the LED Tj event type bit
may be 0 or 1 for an event to be
plotted.
(see Specification of LED event types*)
MED (DVSE and DVSF) plots :
IEV=1 for D.E.F.G events
IEV=2 for D.E.-F.-G events
IEV=3 for D.E.F.-G events
IEV=4 for (D&E)2.E.-F.-G events
IEV=5 for (D&E)1.E.-F.-G events
ICMP 11 I1 Compression Factor
=1, plot first 128 channels on each axis
of matrix with no compression
=2, compress first 256 channels on each axis
onto a 128xl28 matrix
=4, compress first 512 channels on each axis
onto a 128xl28 matrix
=8, compress first 1024 channels on each axis
onto a 128xl28 matrix
Bounds of E for DVSF plots :
HEB(1) 13-15 I3 Lower bound of E
HEB(2) 17-19 I3 Upper bound of E
Range of histogram along the abscissa of the
matrix (do not provide any values if the
option is not desired) :
HIST(1) 21-23 I3 Lower bound of abscissa
HIST(2) 25-27 I3 Upper bound of abscissa
Range of histogram along the ordinate of the
matrix (do not provide any values if the
option is not desired) :
HIST(3) 29-31 I3 Lower bound of ordinate
HIST(4) 33-35 I3 Upper bound of ordinate
Card 2 (Time Indicator Card)
Name Column Format Description
HSW 1 I1 Matrix print indicator
0= to print each accumulated matrix after the
time period specified on this card has been
processed.
1= do not print accumulated matrices, more data
accumulation will follow.
IORBS 3- 7 I5 Start 4-day interval number
IORBE 9-13 I5 End 4-day interval number
GFACT(1)14-18 F5.3 Gain shift factor for A element of LED
GFACT(2)19-23 F5.3 Gain shift factor for B element of LED
GFACT(3)24-28 F5.3 Gain shift factor for D element of MED
GFACT(4)29-33 F5.3 Gain shift factor for E element of MED
GFACT(4)34-38 F5.3 Gain shift factor for F element of MED
If GFACT(1) and GFACT(2) are zero, no gain
shifting will be done for LED
If GFACT(3), GFACT(4) and GAFCT(5) are zero, no
gain shifting will be done for MED.
GTABLE 50 I1 Gain factor table switch
Gain table may be accessed if desired for
D, E and F events. A and B events must specify
gain factors on the time card if gain factor
correction is desired.
For D, E, and F events
=0 Gain factors must be on the time card if
gain correction is desired
=1 The gain tables will be accessed for gain
correction factors
=2 The IMP-6 normalization factors will be
applied to the gain table values in gain
correcting the data
*Specification of LED event types
Each LED event on the IMP-8 Summary files contains a four-bit event type
indicator T1T2T3T4. The meaning of each of these bits is as follows :
T1 = a6 bit at accumulation time (1/2 sequence before readout)
= 1 for (A&B)2.A.B.-C or (A&B)2.A.-B.-C (high gain only)
= 0 for A.B.-C or A.-B.-C events (High gain only)
(For Low gain events, the event is always (A&B)1.A.B.-C or
(A&B)1.A.-B.-C T1 is irrelevant)
T2 = 0 if a rate readout was available that would have counted this
event
= 1 if no such rate readout was available
T3 = 0 if T2=1 or if T2=0 and the rate readout was > 0
= 1 if T2=0 and the rate readout was = 0
T4 = 0 if the L1 and R bits were not equal
= 1 if the L1 and R bits were equal
The event type specification(IEV) on the event identification card for AVSB
plots consists of an analogous 4 digits number, with each digit being 0,1,
or 2. Consider the event type specification expressed as D1D2D3D4. Then
if Di = 0, an event is not accumulated unless Ti = 0
if Di = 1, an event is not accumulated unless Ti = 1
if Di = 2, the Ti bit is not tested in determining if an event is
to be accumulated.
Examples :
IEV: D1 D2 D3 D4 Events accumulated :
0 0 0 0 only events with T1=T2=T3=T4=0
2 2 2 2 All events
2 2 2 0 All events with L1 not equal R(T4=0)
2 2 2 1 All events with L1 = R(T4=1)
0 2 2 2 All A.B.-C and A.-B.-C events
1 2 2 0 All (A&B)2.A.B.-C and (A&B)2.A.-B.-C
events with L1 not equal R
0 0 0 1 All A.B.-C and A.-B.-C events with an
non-zero rate readout found that would
have counted the event and L1=R
0 1 1 0 No events. The combination T1=0,T2=1,
T3=1 and T4=0 should not occur
2 1 1 2 No events. The combination T2=1, T3=1
should not occur
3. PROCESSING ENVIRONMENT
The IMP-8 High Gain Plot program (HGPLT) is developed on an Sun worksation
Sun 4.1.4 operating system. The source codes are written in Sun FORTRAN
and C languages. A local I/O system FTIO package was developed. A local
shell program was developed to execute the IMP-8 HGPLT program.