read_l3a.README 1/12/94

This directory contains the shell script "read_uars" that interfaces with 
simple read/dump programs for all of the UARS level 3 data file types.  
Both C and Fortran versions of the read programs are available for each data 
type.  

To install the GSFC DAAC "read_uars" tool, the user will first have to 
uncompress and untar the read_l3a.tar.Z file.  This file contains the 
Makefiles and the source codes for all the instrument read programs (both C 
and Fortran versions).  Enter the command

		uncompress -c read_l3a.tar.Z | tar xvf -

* Once uncompressed and untared, this file is approximately 1.2 MBytes.

This will create the following directories and source files within a new
directory called "readump"

	read_uars_F
	read_uars_c   
	readump/
	readump/Makefile  
	readump/bin/
	readump/src/
	        src/READUMP_HALOE_L3TP_DATA.F
	        src/READUMP_ISAMS_L3LP_DATA.F
				:
				:
	        src/READUMP_WINDII_L3LP_DATA.F
	        src/READUMP_WINDII_L3TP_DATA.F
	        src/readump_haloe_l3tp_data.c
	        src/readump_isams_l3lp_data.c
				:
				:
	        src/readump_windii_l3lp_data.c
	        src/readump_windii_l3tp_data.c

Create the executables in a bin directory by changing to the readump directory
( cd readump ) and entering the command

	        make 

The available makefile options will listed in menu form

	Please choose the appropriate make option,
	then type 'make OPTION' (e.g. make SGIF)

	 HPC     compile C programs (HP machine)
	 SGIC    compile C programs (SGI machine)
	 SUNC    compile C programs (SUN machine)
	 DECF    compile Fortran programs (DEC Alpha machine)	 
	 HPF     compile Fortran programs (HP machine)
	 SGIF    compile Fortran programs (SGI machine)
	 SUNF    compile Fortran programs (SUN machine)

 
A user with an SGI computer wanting to compile the C programs would use the 
following command

	        make SGIC


A user with an SGI computer wanting to compile the Fortran  programs would use
the following command

	        make SGIF


*Note: the UNIX systems used must have an ANSI compatible C compiler
     
The C compiler will create the following files within the bin directory

	readump/bin/readump_haloe_l3tp_data
	        bin/readump_isams_l3lp_data
	        bin/	:
	        bin/	:
	        bin/readump_windii_l3lp_data
	        bin/readump_windii_l3tp_data

The Fortran compiler will create the following files within the bin directory

	readump/bin/READUMP_HALOE_L3TP_DATA
	        bin/READUMP_ISAMS_L3LP_DATA
	        bin/	:
	        bin/	:
	        bin/READUMP_WINDII_L3LP_DATA
	        bin/READUMP_WINDII_L3TP_DATA


After successfully installing the software, you may want to insert the bin 
directory in your UNIX path.  Since each system is very different, consult 
your system administrator for instructions.


Once you have compiled your programs using either a C or Fortran compiler,
return to the directory containing the two "read_uars" programs ( cd .. )

If you used the C compiler, type the following command lines
	
	mv read_uars_F readump/.
	mv read_uars_c read_uars
	rm read_l3a.tar.Z

If you used the Fortran compiler, type the following command lines

	mv read_uars_c readump/.
	mv read_uars_F read_uars
	rm read_l3a.tar.Z  
	
In line 1, the "mv" option moves the extra read_uars into the readump
directory. 

In line 2, you are renaming the executable program to "read_uars".

In line 3, you are deleting the compressed software package.


You may now use the "read_uars" tool to dump the contents of a file either to
the screen, or to a file.  Copy your data files to the directory containing 
the "read_uars" program.
 
* Make sure that each granuale came with a data file (*PROD extension), and its
accompanying metadata file (*META extension).  The metadata file is required
because it contains the record length information for the data file.



An example session when redirecting your output to a file. 

	$ read_uars

	The following data files are available for reading :

	1) HALOE_L3TP_SLAT_D0031.V0016_C01_PROD   
	2) HALOE_L3TP_SLAT_D0032.V0016_C01_PROD
	Please enter the number of the file you want to read : 1


	1) Screen
	2) Screen using 'more'
	3) Output to a file
	0) Quit
	Please choose a display option : 3
 
	Enter output file name : data_Haloe




User information and assistance for DAAC tools is available from the 
Goddard DAAC User Support Office:

   Goddard DAAC User Services Office    
   Code 902.2                           
   Global Change Data Center            
   NASA Goddard Space Flight Center    
   Greenbelt, Maryland  20771

   Hours: 9AM-5PM, Monday-Friday 
   Voice Line: 301-286-3209
   Fax: 301-286-1775
   Email: daacuso@daac.gsfc.nasa.gov