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.