Document title: Readme for IMP 8 GME PHAS data
Project: IMP8
NDADS Datatype: GME_PHAS_IEEE_GZ
Super-EID: 
There may be other documents also identified by this super-EID.
NDADS filename: IMP8_GME_ANALIMP_F.README
TRF entry: b46768.txt in NSSDC's controlled digital document library, Aug. 1998
Document text follows:
----------------------

READ-ME FILE FOR THE IMP 8 GME PHAS DATA

[Prepared by H. K. Hills, July 23, 1998. This file is itself an NSSDC-served 
document available at ftp://nssdc.gsfc.nasa.gov/controlled_docs/b46768.txt.]

Last modified August 27, 1999.


I. SELECTED WWW PAGES FOR THE IMP 8 GME EXPERIMENT

Home pages:
   http://spdf.gsfc.nasa.gov/imp8_GME/GME_home.html 
   http://voycrs.gsfc.nasa.gov/lo/imp8/.

Full time resolution data:
There are two primary data products, the so-called "CNTS" (i.e.
counts) format files and the so-called "PHAS" (i.e. pulse-height-analysis)
format files. All VLET plus full LED and MED rate data are contained in the
CNTS files; all LED and MED pulse-height data (with appropriate
normalizing rates) are carried in the PHAS format files. See
   http://spdf.gsfc.nasa.gov/imp8_GME/GME_data_FTR.html
for further information.
 
File format for the PHAS data:
   http://voycrs.gsfc.nasa.gov/lo/imp8/pha.html       (Project)
   ftp://nssdc.gsfc.nasa.gov/controlled_docs/bxxxxxalpha.txt   (NSSDC)

ANALIMP-F program software package, tarred and gzipped. See Section II below.
   Soon to be available:
   ftp://nssdc.gsfc.nasa.gov/controlled_docs/bxxxxx   (NSSDC)

User's Guide for the ANALIMP-F program:
   http://voycrs.gsfc.nasa.gov/lo/imp8/analimpf.html  (Project)
   ftp://nssdc.gsfc.nasa.gov/controlled_docs/b46769   (NSSDC)

Table of IMP Interval numbers and dates:
   http://voycrs.gsfc.nasa.gov/lo/imp8/interval.table  (Project) 
   ftp://nssdc.gsfc.nasa.gov/controlled_docs/b46767.txt    (NSSDC) 
      The NSSDC version extends to later years but is about half the size.

      The interval numbers are retained because the project software 
      references the files by use of the interval numbers.

      The IMP GME data are contained in files of four days each, and the
      successive intervals are numbered as "IMP Intervals", starting with
      1 for the four-day interval starting on September 23, 1972, which 
      was the IMP-H (IMP 7) launch date. 


II. ANALIMPF PROGRAM

To run the ANALIMPF program on the IMP 8 GME PHAS data, the following steps
are used, starting with obtaining the data and software files via ftp from the
NDADS output staging area. The software was created to run on a SUN system. 

1. Obtain the analimpf.tar.gz file of software (soon to be available). See 
above for source locations.

2. Uncompress it with gz

3. Extract all the files with tar

4. Give the command "make" to compile modules and generate the executable 
   program.

5. Run analimpf.input_script to define the input parameters and write them to
   a data file analimpf.input_data. The input parameters include the time 
   span of data to be processed, as well as many other parameters. Refer to 
   the ANALIMP-F User's Guide for more detail. The ANALIMP-F User's Guide is
   available both as a document available from NSSDC's controlled digital
   documentation library and as a WWW page. See Section I. above.

6. Obtain all of the input PHA data files needed. Their names must be PHASn,
   where n is the IMP interval number (4-day periods starting with launch of
   IMP-H (IMP 7) on 9/23/72; see Section I. above). The script is written
   with the assumption that these data files will be in the same directory as
   the software.

7. Run analimpf.script

If the input data files were obtained in compressed form, then they must be 
uncompressed and properly named (#6 above) before using.

Permissions might have to be reset to allow execution of the scripts and
executable program.