ERBE S-10N WFOV Edition3 Readme
 
 
The readpgm.f program reads the ERBE S-10N WFOV data from a file for a 
particular month, year, and satellite.  This program prompts the user
for all of the information regarding the type of file to be read, the total 
number of regions to be processed, whether these regions are in consecutive 
order, and if not, will prompt the user to input the other regions which need 
to be processed.  After reaching the desired region on the file, it 
prompts the user once again regarding the type of record the user wants as 
output, the number of regions to be read, whether these regions are 
consecutive, and the first region to be read. This program uses C routines to 
open and read the data from the file.  These routines, copen and cread, are 
found in a file called io.c.  Other C routines which are used are gbytes and 
gbyte which are found in a file called gbytes.c.  The gbyte and gbytes 
routines are used to unpack the data from the NOS 60-bit format to the 
UNIX format.  Information pertaining to the io.c and to the gbytes.c
routines can be found at the end of this document.
 
If users have questions, please contact the Langley ASDC User 
and Data Services office at:
 
            Atmospheric Science Data Center
            User and Data Services Office
            Mail Code 157D
            2 South Wright Street
            NASA Langley Research Center
            Hampton, Virginia 23681-2199
            U.S.A.
 
            E-mail:   support-asdc@earthdata.nasa.gov
            Phone:    (757) 864-8656
            FAX:      (757) 864-8807
            URL:      http://eosweb.larc.nasa.gov
 
This document includes the following sections:
 
Section 2.0 - Data Set Description
Section 3.0 - Data Format and Packaging
Section 4.0 - Science Parameter Information
Section 5.0 - Description of Sample Read Software
Section 6.0 - Implementing Sample Read Software
Section 7.0 - Sample Output
 
 
2.0 Data Set Description
 
This information pertains only to the ERBE S-10N WFOV Edition 3 data
sets.  This is the second version of this data product.  For more
information, please refer to the following web site for a detailed
description of the data:
 
http://eosweb.larc.nasa.gov/PRODOCS/erbe/table_erbe.html
 
2.1 Instrumentation Description
 
For more information, please refer to the following web site for a 
detailed description of the data:
 
http://eosweb.larc.nasa.gov/PRODOCS/erbe/table_erbe.html
 
2.3 Data Quality and Known Deficiencies
 
For more information, please refer to the following web site for a 
detailed description of the data:
 
http://eosweb.larc.nasa.gov/PRODOCS/erbe/table_erbe.html
 
2.4 Science Contact
 
Takmeng Wong
Atmospheric Sciences Competency
Mail Stop 420
21 Langley Boulevard
NASA Langley Research Center
Hampton, VA 23681-2199
Phone: (757) 864-5607
FAX:   (757) 864-7996
E-mail:  takmeng.wong@larc.nasa.gov
 
 
3.0 Data Format and Packaging
 
For ease of downloading the read software, the individual files have been 
"zipped" together into one file.  To unzip the files with Info-Zip 
software, download the freeware and information from the following 
URLs:
        http://www.cdrom.com/pub/infozip/        
 
        ftp://ftp.freesoftware.com/pub/infozip/
 
 
Filename:  erbe_s10n_edition3_read.zip
Four files are in this "zipped" package:
- io.c
- gybtes.c
- readpgm.f
- makefile
 
This program is able to run only on a Sun (in 32 bit mode).  The compilers
needed are the FORTRAN 77 and a C compiler (CC or gcc).
 
 
3.1 File Naming Convention
 
ERBE S-10N WFOV Edition 3 data files naming convention is as follows:
 
ERBE_S10N_WFOV_NF_ERBS_Edition3.200104
 
           ERBE - project name
           S10N - product name
           WFOV - non-scanner instrument field of view 
                  (WFOV - Wide, MFOV - Medium)
           NF   - inversion technique used to process the data 
                  (NF - numerical filter method, SF - shape factor method)
           ERBS - spacecraft (ERBS, NOAA-9, NOAA-10 - or any combination)
                  At this time, only ERBS spacecraft is available.
           Edition3 - version of data
           yyyymm - data month
                    four digit year and two digit month format.
 
4.0 Science Parameter Information
 
The User's Guide that contains this information can be found at the
following web site:
 
http://eosweb.larc.nasa.gov/PRODOCS/erbe/table_erbe.html
 
 
5.0 Description of Sample Read Software
 
This program is able to run only on a Sun (in 32 bit mode).  The compilers
needed are the FORTRAN 77 and a C compiler (CC or gcc).
 
 
6.0 Implementation of the Sample Read Software
 
To compile the program, the user should edit the makefile as needed reflecting
correct library paths on the designated Unix system.
 
To compile the program, at the Unix command line prompt, enter the
command, make.  The following information should appear on the screen:
 
unixcommand % make
/usr/ucb/cc -O  -c io.c
/usr/ucb/cc -O  -c gbytes.c
ar rv erbelib.a io.o gbytes.o readpgm.f
a - io.o
a - gbytes.o
a - readpgm.f
ar: creating erbelib.a
ar: writing erbelib.a
ranlib erbelib.a
f77 -o mtsa_reads10.exe readpgm.f erbelib.a 
readpgm.f:
 MAIN dump:
        init:
        iwords:
        setup:
"readpgm.f", line 768: Warning: namelist "tp10" never used
        readdata:
        recone:
        hrboxes:
        rectwo:
"readpgm.f", line 1135: Warning: local variable "ndata" never used
        scaleone:
        scaletwo:
        sesprd:
        spread:
        shift:
        setloc:
 
unixcommand %

To execute the program, at the Unix command line, enter the
following command:
 
unixcommand % ./mtsa_reads10.exe

 ERBE_S10N_WFOV_NF_ERBS_Edition3.198411 
----------------------------------------
 PLEASE ENTER 1= S9 TAPE, 2= S10 OR S10N TAPE:
2
 PLEASE ENTER FILENAME (COMPLETE PATH IF NOT IN
 CURRENT DIRECTORY): 
ERBE_S10N_WFOV_NF_ERBS_Edition3.198411
 PLEASE ENTER 0=SCANNER 1=NONSCANNER: 
1
 PLEASE ENTER RESOLUTION 25(SC), 50(NF), 100(SF): 
50
 PLEASE ENTER SATELLITE CODE (1-7): 
2
 PLEASE ENTER DATA MONTH (1-12): 
11
 PLEASE ENTER DATA YEAR (YYYY): 
1984
 PLEASE ENTER FIRST REGION ON FILE: 
450
 PLEASE ENTER LAST REGION ON FILE: 
455
 ENTER TOTAL NUMBER OF REGIONS TO BE PROCESSED
5
 WILL THIS BE A CONSECUTIVE SERIES OF REGIONS?
      1=YES,  0=NO    
1
 ENTER FIRST REGION IN THE SERIES
450
 REGION NUMBER            2 IS          451
 REGION NUMBER            3 IS          452
 REGION NUMBER            4 IS          453
 REGION NUMBER            5 IS          454
 TAPE PARAMETERS: 
 ERBE_S10N_WFOV_NF_ERBS_Edition3.198411                                          
             1           1
 NUMBER OF FILES ON TAPE:            1
 FIRST REGION ON THE TAPE:            1
 LAST REGION IN EACH FILE:          455
 RETRIEVING REQUESTED REGIONS FROM FILE...
 FOUND REGION          450
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          451
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
 FOUND REGION          452
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
3
 FOUND REGION          453
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          454
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
======================================= 
 ERBE_S10N_WFOV_NF_ERBS_Edition3.198412 
----------------------------------------
 PLEASE ENTER 1= S9 TAPE, 2= S10 OR S10N TAPE:
2
 PLEASE ENTER FILENAME (COMPLETE PATH IF NOT IN
 CURRENT DIRECTORY): 
ERBE_S10N_WFOV_NF_ERBS_Edition3.198412
 PLEASE ENTER 0=SCANNER 1=NONSCANNER: 
1
 PLEASE ENTER RESOLUTION 25(SC), 50(NF), 100(SF): 
50
 PLEASE ENTER SATELLITE CODE (1-7): 
2
 PLEASE ENTER DATA MONTH (1-12): 
12
 PLEASE ENTER DATA YEAR (YYYY): 
1984
 PLEASE ENTER FIRST REGION ON FILE: 
450
 PLEASE ENTER LAST REGION ON FILE: 
455
 ENTER TOTAL NUMBER OF REGIONS TO BE PROCESSED
5
 WILL THIS BE A CONSECUTIVE SERIES OF REGIONS?
      1=YES,  0=NO    
1
 ENTER FIRST REGION IN THE SERIES
450
 REGION NUMBER            2 IS          451
 REGION NUMBER            3 IS          452
 REGION NUMBER            4 IS          453
 REGION NUMBER            5 IS          454
 TAPE PARAMETERS: 
 ERBE_S10N_WFOV_NF_ERBS_Edition3.198412                                          
             1           1
 NUMBER OF FILES ON TAPE:            1
 FIRST REGION ON THE TAPE:            1
 LAST REGION IN EACH FILE:          455
 RETRIEVING REQUESTED REGIONS FROM FILE...
 FOUND REGION          450
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          451
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
 FOUND REGION          452
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
3
 FOUND REGION          453
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          454
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2

*******************************************************

unixcommand % ./mtsa_reads10.exe 

 ERBE_S10N_WFOV_SF_ERBS_Edition3.198411 
----------------------------------------
 PLEASE ENTER 1= S9 TAPE, 2= S10 OR S10N TAPE:
2
 PLEASE ENTER FILENAME (COMPLETE PATH IF NOT IN
 CURRENT DIRECTORY): 
ERBE_S10N_WFOV_SF_ERBS_Edition3.198411
 PLEASE ENTER 0=SCANNER 1=NONSCANNER: 
1
 PLEASE ENTER RESOLUTION 25(SC), 50(NF), 100(SF): 
100
 PLEASE ENTER SATELLITE CODE (1-7): 
2
 PLEASE ENTER DATA MONTH (1-12): 
11
 PLEASE ENTER DATA YEAR (YYYY): 
1984
 PLEASE ENTER FIRST REGION ON FILE: 
450
 PLEASE ENTER LAST REGION ON FILE: 
455
 ENTER TOTAL NUMBER OF REGIONS TO BE PROCESSED
5
 WILL THIS BE A CONSECUTIVE SERIES OF REGIONS?
      1=YES,  0=NO    
1
 ENTER FIRST REGION IN THE SERIES
450
 REGION NUMBER            2 IS          451
 REGION NUMBER            3 IS          452
 REGION NUMBER            4 IS          453
 REGION NUMBER            5 IS          454
 TAPE PARAMETERS: 
 ERBE_S10N_WFOV_SF_ERBS_Edition3.198411                                          
             1           1
 NUMBER OF FILES ON TAPE:            1
 FIRST REGION ON THE TAPE:            1
 LAST REGION IN EACH FILE:          455
 RETRIEVING REQUESTED REGIONS FROM FILE...
 FOUND REGION          450
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          451
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
 FOUND REGION          452
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
3
 FOUND REGION          453
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          454
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
======================================= 
 ERBE_S10N_WFOV_SF_ERBS_Edition3.198412 
----------------------------------------
 PLEASE ENTER 1= S9 TAPE, 2= S10 OR S10N TAPE:
2
 PLEASE ENTER FILENAME (COMPLETE PATH IF NOT IN
 CURRENT DIRECTORY): 
ERBE_S10N_WFOV_SF_ERBS_Edition3.198412
 PLEASE ENTER 0=SCANNER 1=NONSCANNER: 
1
 PLEASE ENTER RESOLUTION 25(SC), 50(NF), 100(SF): 
100
 PLEASE ENTER SATELLITE CODE (1-7): 
2
 PLEASE ENTER DATA MONTH (1-12): 
12
 PLEASE ENTER DATA YEAR (YYYY): 
1984
 PLEASE ENTER FIRST REGION ON FILE: 
450
 PLEASE ENTER LAST REGION ON FILE: 
455
 ENTER TOTAL NUMBER OF REGIONS TO BE PROCESSED
5
 WILL THIS BE A CONSECUTIVE SERIES OF REGIONS?
      1=YES,  0=NO    
1
 ENTER FIRST REGION IN THE SERIES
450
 REGION NUMBER            2 IS          451
 REGION NUMBER            3 IS          452
 REGION NUMBER            4 IS          453
 REGION NUMBER            5 IS          454
 TAPE PARAMETERS: 
 ERBE_S10N_WFOV_SF_ERBS_Edition3.198412                                          
             1           1
 NUMBER OF FILES ON TAPE:            1
 FIRST REGION ON THE TAPE:            1
 LAST REGION IN EACH FILE:          455
 RETRIEVING REQUESTED REGIONS FROM FILE...
 FOUND REGION          450
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          451
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2
 FOUND REGION          452
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
3
 FOUND REGION          453
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
1
 FOUND REGION          454
 DO YOU WANT TO READ ONLY RECORD ONE, 
 ONLY RECORD TWO, OR BOTH RECORD ONE AND TWO
 1=RECORD ONE; 2 = RECORD TWO; 3 = BOTH 
2