IMP-8 Rate Plot Program
User's Guide
1. GENERAL DESCRIPTION
The IMP-6/7/8 Rates Plot Program Produces postscript rate plots files,
PC rate files, and rate reports of rates data from the IMP-6, IMP-7, and
IMP-8 Cosmic Ray Experiments. The input to the program can be counts files.
The averaging interval for the data can be specified from every readout up to
12-hour averages. The option is also provided for generating the sums,
differences, or ratios of pairs of rates.
For each time period to be plotted, the input deck must consist
cards in the following sequence
1. 1 title card
2. 1 file unit card
3. 1 print card
4. 1 time-parameter card
5. 1 to 50 frame size cards
6. 1 to 100 rates cards
7. 1 to 50 plot cards
8. 1 to 50 combination cards
2. PARAMETER CARDS
TITLE CARD
NAME COLUMN FORMAT DESCRIPTION
JTITLE 1-80 2OA4 Alphanumeric title to be written
on all print logs and plot frames.
FILE UNIT CARD
NAME COLUMN FORMAT DESCRIPTION
INUNIT(L) 1-5 I5 Logical unit number for IMP-6 input
files
INUNIT(2) 6-10 I5 Same as above, for IMP-7
INUNIT(3) 11-15 I5 Same as above, for IMP-8
XMINO 21-25 F5.1 4060 plot raster limits
(default 205. if blank)
XMAXXO 26-30 F5.1 (default 4049. if blank)
YMINO 31-35 F5.1 (default 300. if blank)
YMAXO 36-40 F5.1 (default 2700. if blank)
PRINT CARD
NAME COLUMN FORMAT DESCRIPTION
INOEV 1-3 I3 Number of events
NFRAME 4-6 I3 Number of frames
NCOMB 7-9 I3 Number of Combinations
QP 10 Ll Printing flag
QB 11 Ll Printing combination flag
TIME-PARAMETER CARD
NAME COLUMN FORMAT DESCRIPTION
IXTYPE 1-2 I2 plot x-type(see TABLE 1.)
IYTYPE 3 II Plot Y-type
1=counts/sec
2=counts/sec cm2 ster
3=counts/sec cm2 ster(Mev/nucleon)
4=no Y-axis units (used only for
ratio plats)
IPERIG 4 II sub-perigee data flag
(applies to IMP-6 only)
0=reject IMP-6 sub-perigee data
1=plot all IMP-6 data
IPOINT 5 I1 trend check rejection flag
0=apply trend check
1=do not apply trend check
IS1 6 I1 Sectored data fail flag
0=reject failed sectored data
1=accept failed sectored data
IS2 7 I1 Sectored data zero suntime flag
0=reject zero suntime sectored data
1=accept zero suntime sectored data
IDAY1 9-10 I2 Start day
MON1 11-13 A3 Start month(first 3 letters of
month name)
IYEAR1 14-15 I2 Start Year(last 2 digits of year)
IHOUR1 17-18 I2 Start hour
IMIN1 20-21 I2 Start minute
ISEC1 23-24 I2 Start second
IDAY2 29-30 I2 Stop day
IMON2 31-33 A3 Stop month
IYEAR2 34-35 I2 Stop year
IHOUR2 37-38 I2 Stop hour
IMIN2 40-41 I2 Stop minute
ISEC2 43-44 I2 Stop second
IXRNGE 55-57 I3 x-axis range(see TABLE 1. for de-
fault values)
XPERIG 59-68 F10.0 Perigee altitude in kilometers
for IMP-6 only
Optional. (default = 70,000 km.)
QEVC 69 L1 Experiment on/off option
F= in effect
T= no change
ITPE 79 I1 file type flag, for testing pur-
poses only. Normally zero
(if=l, forces Plotter to use
counts files for all cases.)
FRAME SIZE CARD
NAME COLUMN FORMAT DESCRIPTION
IYMN 1-5 I5 Lower y-axis power of 10 for plot
IYMX 6-10 I5 Upper Y-axis power of 10 for plot
RATE CARD
NAME COLUMN FORMAT DESCRIPTION
ILOC 1-3 I3 Rate card number
IEVENT 4-6 13 Event identification number of
rate to be accumulated.
ISECTR 7 I1 Sector number, if applicable.
0=sum all sectors(or not a sectored
rate)
1-8=accumulate designated sector
IIMP 8 II Satellite identification for above rate
6=IMP-6 rate
7=IMP-7 rate
8=IMP-8 rate
NUCL 9 II Detected particle nucleon number.
Need only with IYTYPE=3.
1=proton(default)
4=helium
12=carbon
16=oxygen
BAND 10-19 F10.0 Energy band for rate, in Mev.
Used only with IYTYPE=3.
FACTOR 20-29 F10.0 Override geometry factor, in cm2 ster.
If blank, the default factor from
APPENDIX is used.
(Used only with IYTYPE=2 or 3)
PLOT CARD
NAME COLUMN FORMAT DESCRIPTION
IFUNCT 1 I1 First item to be plotted:
1=plot Al only
2=plot Al + A2
3=plot Al - A2
4=plot Al / A2
IARG1 2-4 I3 Rate card number for Al
IARG2 5-7 I3 Rate card number for A2
IPLTPT 8 A1 Plot symbol for first item
11-18 Same as columns 1-8 for second
item to be plotted.
21-28 Same as columns 1-8 for third
item to be plotted.
31-38 Same as columns 1-8 for fourth
item to be plotted.
41-48 Same as columns 1-8 for fifth
item to be plotted.
51-58 Same as columns 1-8 for sixth
item to be plotted.
COMBINATION CARD
NAME COLUMN FORMAT DESCRIPTION
IFNT 1 I1 First item to be printed:
1=print Al only
2=print Al + A2
3=print Al - A2
4=print Al / A2
IAGI 2-4 I3 Rate card number for Al
IAG2 5-7 I3 Rate card number for A2
11-17 Same as columns 1-7 for second
item to be Printed.
21-27 Same as columns 1-7 for third
item to be Printed.
31-37 Same as columns 1-7 for fourth
item to be Printed.
41-47 Same as columns 1-7 for fifth
item to be Printed.
51-57 Same as columns 1-7 for sixth
item to be printed.
NOTES ON PARAMETER CARDS
This Program can plot data from up to three different satellites at
the same time. The Program makes use of only those unit numbers
(on the FILE UNIT CARD) corresponding to satellites for which rates
are acturally being requested. Thus, if data from only one satellite
is being plotted, only that satellite's file unit number will be used
(although all three numbers may be specified on the card).
The plot x-axis type (IXTYPE) should be chosen from TABLE 1. The plot
type determines the interval over which each data point is averaged.
TABLE 1 also shows the corresponding allowable values for the plot
frame X-range (IXRNGE). If IXRNGE is left blank on the input card, then
the maximum value listed will be used. The plot Y-axis type (IYTYPE)
is used to pick the plotting units. If IYTYPE=3, then the detected
particle nucleon number and the energy bands should be specified on
each RATE CARD. If it is desired to plot ratios of rates, then only
ratios should be specified (i.e., all IFUNCT=4 on the PLOT CARD), and
IYTYPE should be =4.
If IPOINT is left blank, events that fail the trend check and events that
occur immediately after bit-rate changes and data time gap will not be
processed. If IPOINT=1, all events will be processed.
The file type parameter, ITAPE, should normally be left blank. If left
blank, then counts files will be used as input for all plot jobs with
an averaging interval smaller than 15 minutes; and summary counts file
will be used with averaging intervals of 15 minutes or more. If ITAPE=1,
then counts files will be used with any averaging interval. This option
is useful for testing and for processing times for which there exist no
summary counts files. The use of this option for normal production
however, can be very costly in terms of computer time.
On the RATE CARDS, the rate identification number should be taken from
the appropriate satellite rate table in Appendix A. Also the rate
identification number has an associated read card number, the read card
number is the number in the order of reading RATE CARD from input cards.
The sector number only has meaning if a sectored rate is being processed.
The RATE CARDS are used to identify and supply input data for all rates
that are to be accumulated by the program.
On the PLOT CARDS, for each item to be plotted, the IFUNCT parameter
ter specifies which combination of rates is to be used. The Al and A2
parameters refer to the read card number on RATE CARD which contains
that rate desired. All items on the same PLOT CARD are plotted on the
same frame. The frame number is determined by the order of PLOT CARDS on
input cards.
The COMBINATION CARDS are used to print rates or combination of rates. For
each item to be printed, the IFNT parameter specifies which combination
of rates is to be printed. The Al and A2 parameter refer to the read card
number on RATE CARDS which contains that rate desired.
When IYTYPE =2 or 3, geometry factors will be used with all the rates
rates accumulated. If no value is entered on the corresponding RATE CARD,
the default value from Appendix A. Notes that certain rates have default
of 0.0 degrees, in these cases a geometry factor has been determined to be
somewhat meaningless and the user must supply a value if the rate is to
be accumulated (with IYTYPE =2 or 3)
3. PROCESSING ENVIRONMENT
The IMP-8 Rate Plot program (RATEPLOT) is developed on an Sun worksation
Sun 4.1.4 operating system. The source codes are written in Sun FORTRAN
languages. A local I/O system FTIO package was developed. A local shell
program was developed to execute the IMP-8 RATEPLOT program.
4. TABLE 1 (X-AXIS SCALING)
--------------------------------------------------------------------------
PLOT TYPE INTERVAL PLOT FRAME X-RANGE IPLOT START TIME ALIGNMENT
(=IXTYPE) AVERAGE (=IXRNGE)* ---------------------------
NORMAL PRODUCTION
--------------------------------------------------------------------------
1 EVERY READOUT 5 TO 15 MINUTES EVEN MINUTE 1/4 HOUR
2 5 MINUTES 3 TO 12 HOURS HOUR 1/2 DAY
3 10 MINUTES 6 TO 24 HOURS 2 HOURS DAY
4 15 MINUTES 12 TO 36 HOURS 3 HOURS 1/2 DAY
5 30 MINUTES 1 TO 5 DAYS DAY DAY
6 30 MINUTES 24 TO 120 HOURS 6 HOURS DAY
7 1 HOUR 1 TO 10 DAYS DAY DAY
8 1 HOUR 48 TO 240 HOURS 1/2 DAY DAY
9 6 HOURS 1 MONTH ONLY MONTH MONTH
10 12 HOURS 1 TO 3 MONTHS MONTH MONTH
11 24 HOURS I TO 6 MONTHS MONTH MONTH
------------------------------------------------------------------------
* DEFAULT FOR IXRNGE IS THE MAXIMUM RANGE VALUE SPECIFIED
5. APPENDIX A (IMP-8 RATE IDENTIFICATION TABLE)
------------------------------------------------------------------------
ID GEOMETRY LIVE RATE
FACTOR TIME
------------------------------------------------------------------------
1 2.810 10.24 DI.E.-F.-G
2 2.540 10.24 DI.E.F.-G
3 2.810 10.24 DI.-D2.E.-F.-G
4 2.810 10.24 DI.-(DI&EI)1.E.-F.-G
5 0.0 10.24 ID1
6 0.0 10.24 ID2
7 2.810 10.24 DI.(DII&EII)R.E.-F.-G
8 2.540 10.24 DI.E.F
9 2.540 10.24 DI.(DI&EI)2.-(DII&EII)R.E.F.-G
10 2.540 10.24 DI.(DII&EII)R.E.F.-G
11 0.0 10.24 DI
12 0.0 10.24 E
13 0.0 10.24 F
14 0.0 10.24 G
15 2.810 10.24 DI.(DI&EI)1.E.-F.-G
16 2.810 10.24 (DI&EI)2.E.-F.-G
17 0.390 10.24 (A&B)1.B.-C
18 0.390 10.24 A.B.-C
19 0.0 10.24 A1
20 0.390 10.24 (A&B)1.-B.-C
21 0.0 10.24 B
22 0.390 9.20 (A&B)2.A.B.-C
23 0.390 9.20 (A&B)2.A.-B.-C
24 0.0 10.24 A1.B
25 0.390 10.24 A1.-B.-C
26 0.0 10.24 C
27 4.830 5.12 DI4
28 4.830 5.12 DI3
29 4.830 5.12 DI2
30 4.830 5.12 DI1
31 0.0 5.12 F
32 0.0 5.12 E
33 0.0 5.12 DII
34 4.830 5.12 DI
35 0.165 5.12 DI.DII.S1D.-F
36 0.165 5.12 DI.DII.S2D.-F
37 2.540 SECTORED: DI.E.F.-G
38 2.900 SECTORED: DI.-D2.E.-F.-G
39 2.900 SECTORED: (DI&EI)1.E.-F.-G
40 2.900 SECTORED: DI.-(DI&EI)1.E.-F.-G
41 0.390 SECTORED: A1.-B.-C
42 0.390 SECTORED: A1.B.-C
43 0.165 SECTORED: DI.DII.-F
44 0.165 SECTORED: DI.DII.S1D.-F