README for the readuars.c program

 Name: readuars

 Synopsis:

     readuars [-?] [-b] [-s <slat> <nlat> [<wlon> <elon>]]
              [-v <zmin> <zmax>] [-u <uparam>] <filename>

 Description:

     This program reads and dumps the contents of all UARS level 3A
     data files (3AL, 3AT, 3LP, 3TP, 3AS/3BS, and UARS Correlative).

     The input file may be either the actual data file (PROD extension),
     or the metadata file (META extension).  Output can be redirected to
     an ASCII file.  Subsetting by latitude and vertical height can also
     be done.

 Options/Arguments:

     -? -- help: prints this page

     -b -- swap bytes for integers and floats

     -s <slat> <nlat> [<wlon> <elon>] -- spatial region to subset by where
	<slat> = southernmost latitude (-90 to +90)
	<nlat> = northernmost latitude (-90 to +90)
	and optionally
	<wlon> = westernmost longitude (-180 to +180 or 0 to 360)
	<elon> = easternmost longitude (-180 to +180 or 0 to 360)

     -v <zmin> <zmax> -- vertical range to subset by where
	<zmin> = minimum altitude (1000 to 1.0e-6 hPa or 0 to 400 km)
	<zmax> = maximum altitude (1000 to 1.0e-6 hPa or 0 to 400 km)

     -u <uparam> -- UKMO parameter where options include h=HEIGHT, t=TEMP,
                    m=MERWIN_P, z=ZONWIN_P, o=OMEGA, or a=ALL (default)

     <filename> -- name of the input file (META or PROD)

 Notes:

     UARS files from the DAAC are native binary with big-endian ordered data.
     Users reading these files on a PC or other litte-endian machines must
     use the byteswap option -b, or data values will come out wrong.

 Compile:

     To compile this progam : cc -o readuars readuars.c -lm

 Contact: help@daac.gsfc.nasa.gov

   Goddard Earth Sciences DAAC
   Code 902                           
   NASA Goddard Space Flight Center    
   Greenbelt, Maryland  20771

   Hours = 9AM-5PM, Monday-Friday 
   Phone = 301-614-5224
   Fax = 301-614-5268