********************************************************************************
*                                                                              *
*              Readme file for the CAMEX-4 ER2 MAS Data Set                    *
*                                                                              *
********************************************************************************

1.0 Introduction

    This file contains information about the sample read software and data files
for the NASA ER2 Moderate Resolution Imaging Spectroradiometer (MODIS) Airborne
Simulator (MAS). This software will read the data set:

	Fourth Convection and Moisture Experiment (CAMEX4_ER2_MAS)

    The CAMEX4_ER2_MAS data files range in size from 8 Mbytes to 1.1 Gbytes. The 
data files are written in netCDF (Common Data Format). NCSA's (National Center for 
Supercomputing Applications) HDF (Hierarchical Data Format) libraries with the
netCDF extensions are required to build the read software. These libraries can
be obtained via anonymous ftp from ftp.ncsa.uiuc.edu or via the World Wide Web 
at http://hdf.ncsa.uiuc.edu.

    This readme file includes the following sections:

         Section 2.0 - Data Set Description
         Section 3.0 - Format and Packaging
         Section 4.0 - Science Parameters Information
         Section 5.0 - Description of Sample Read Software
         Section 6.0 - Implementing Sample Read Software
         Section 7.0 - Sample Output
         Section 8.0 - Additional Data Information 

    If you have any questions, please contact the Langley ASDC Science, Users
and Data Services Office at:

     Atmospheric Sciences Data Center
     Science, Users and Data Services Office
     Mail Stop 157D
     2 South Wright Street
     NASA Langley Research Center
     Hampton, Virginia 23681-2199
     U.S.A.

     E-mail:   larc@eos.nasa.gov
     Phone:    (757)864-8656
     FAX:      (757)864-8807
     URL:      http://eosweb.larc.nasa.gov


2.0 Data Set Description 

    The MODIS Airborne Simulator (MAS) is an airborne scanning spectrometer that acquires
high spatial resolution imagery of cloud and surface features from its vantage point 
on-board a NASA ER-2 high-altitude research aircraft. 

    Data acquired by the MAS are helping to define, develop, and test algorithms for the 
Moderate Resolution Imaging Spectroradiometer (MODIS), a key sensor of NASA's Earth 
Observing System (EOS). The MODIS program will emphasize the use of remotely sensed 
data to monitor variation in environmental conditions for assessing both natural and 
human-induced global change.

    The MAS spectrometer acquires high spatial resolution imagery in the range of 0.55 to 
14.3 microns. A total of 50 spectral bands are available in this range. Pre-1995 the 
digitizer was configured for each mission to record a pre-selected group of 12 bands 
during the flight. For most of these missions the digitizer was
configured to record four 10-bit channels and seven 8-bit channels. 

    A 50-channel digitizer which records all 50 spectral bands at 12 bit resolution 
became operational in January 1995.

    The MAS spectrometer is mated to a scanner sub-assembly which collects image data 
with an IFOV of 2.5 mrad, giving a ground resolution of 50 meters from 20000 meters 
altitude, and a cross track scan width of 85.92 degrees. 

    For information about the CAMEX-4 mission see:

        http://camex.msfc.nasa.gov

    and

        http://asapdata.arc.nasa.gov/CAMEX4_home.html

2.1 Instrumentation Description

    For a description of the MODIS Aircraft Simulator see:

        http://ltpwww.gsfc.nasa.gov/MODIS/MAS/Home.html

2.2 Data Quality
	
    Note that spectral response curves used for processing raw MAS instrument 
counts to calibrated radiances were "atmospherically corrected" and 
smoothed. This atmospheric correction was done to the (approximate) 5 meter
path between the source and the MAS instrument during the instrument's 
calibration.  MAS calibrated radiances are not atmospherically corrected 
to account for atmospheric profiles, absorbing and emmitting gases, 
clouds, or aerosols in the sensor to Earth path.

2.3 Science Contact
       
    Questions pertaining to the data values contained within these files should be
directed to:

         Michael Fitzgerald  
         Airborne EOS Data Production Mgr.
         NASA Airborne Sensor Facility (SAIC) 
         Ames Research Center 
         Building 240, Room 219
         Mail Stop 240-6 
         Moffett Field, CA 94035-1000 

         Office phone  (650) 604 2872
         Fax (650) 604 4987 
         E-mail mfitzgerald@mail.arc.nasa.gov 

3.0 Format and Packaging 

    The following files are defined for this distribution:

    Filename                  Format
    ----------------------    -------------------- 
    camex_mas_read.c          C Source Code
    camex_mas_read.f          Fortan Source Code
    camex_mas_read_idl.pro    IDL Source Code
    mas_constant.i            Fortran Include File
    readme_camex_mas          This readme file.

    Note: Both C and Fortran source code use the HDF libraries.

The naming convention used for these files is:

    MASLLL_FFFFF_TT_YYYYMMDD_SSSS_EEEE_VNN.hdf
       
    where 
            LLL    -  Data Product (e.g. L1B for level 1B)
	    FFFFF  -  Flight Number
            TT     -  Track
            YYYY   -  Year
            MM     -  Month
            DD     -  Day
            SSSS   -  Start Time 
            EEEE   -  End Time
            NN     -  Version

    For example:

    MASL1B_01141_18_20010924_0010_0037_V01.hdf
	
    This example is a Level 1B file on flight 01141 track 18 on
September 24,2001 with a starting time of 00:10 and an
ending time of 00:37 version 01. 

4.0 Science Parameters Information

    For information about the MAS science parameters see:

    http://ltpwww.gsfc.nasa.gov/MODIS/MAS/masdug.html

5.0 Description of Sample Read Software

    There are three sample read programs developed for the CLAMS_ER2_MAS data
set. One was written in the C programming language, another one was written
in the Interactive Data Language (IDL) and the final one was written in Fortran.
All programs have been tested on SGI under OS 6.5.11m. The IDL program was developed
and tested using IDL 5.3 on an SGI system. Information about IDL can be obtained at
the Research Systems, Inc. web site at:
 
          http://www.rsinc.com/

5.1 The C Program
 
    The camex_mas_read.c program is meant to be an example program provided for
the user's convenience.  With minor modifications, the program can be compiled
and executed on many different platforms. This read software is heavily based
upon the NCSA distributed version of the netCDF utility "ncdump". In fact, the
program should work for most, if not all, netCDF formatted files.  Please see
the program source code for copyright information.
 
5.2 The IDL Program
 
    The camex_mas_read_idl.pro program will read data from the input file and
write it out in ASCII format to a file with the same name but with .rpt as the
extension.  Under Unix the user must have X-Windows running in order for the
user interface to work properly. The user selects which file to use based on
the selection chosen from a file dialog box. The application then prompts the
user for global attributes and then for the selection of which data item(s)
to dump to file. Special Note: Selecting a 0 will dump everything which
will create a huge ASCII file.

5.3 The Fortran Program
 
    For the Fortran program two files are used to generate the Fortran read
software: camex_mas_read.f and mas_constant.i.  The Fortran read software
is available at the Atmospheric Sciences Data Center or may be downloaded from
the MAS URL at:
 
          http://ltpwww.gsfc.nasa.gov/MODIS/MAS/sw.html
 
    The clams_mas_read.f program is interactive in nature and allows the user
to cycle through portions of the data file. Section 7.3 shows a sample
session using this application.
 
    Also, there is a viewer for MAS Imagery called SHARP that is available at
the following URL:
 
          http://cimss.ssec.wisc.edu/~gumley/sharp/sharp.html

6.0 Implementing Sample Read Software

    The following sections detail how to compile and link the various applications.

6.1 How to Compile the Sample Read Software

    The user can build the sample read program from the C or Fortran source files.  

6.1.1 Compiling applications for SGI

    To build the executable for the SGI using the C source file at the UNIX 
commmand line prompt type:

	cc -64 -DNO_HAVE_PROTOTYPES -DNO_STDARG -o camex_mas_read_c 
		-I/usr/lib/hdf41r2_64/include camex_mas_read.c 
		-L/usr/lib/hdf41r2_64/lib -lmfhdf -ljpeg -ldf -lz -lm

NOTE 1: The C compiler gives fifteen warnings that can be ignored. Also the linker
gives two warnings about unused modules that also can be ignored.

To build the executable for the SGI using the Fortran source files for the 
CAMEX_ER2_MAS data set, type:

	f77 -64 -DNO_HAVE_PROTOTYPES -DNO_STDARG -I/usr/lib/hdf41r2_64/include 
		-o camex_mas_read_f camex_mas_read.f mas_constant.i 
		-L/usr/lib/hdf41r2_64/lib -lmfhdf -ljpeg -ldf -lz -lm

NOTE 2: The -I (include) and -L (library) hdf directory paths may differ 
on your system. Also the HDF libraries on your target machine may be
32 bit instead of 64 bit. 

NOTE 3: The include file mas_constant.i should be in the working directory. A 
warning is issued for line 55 of mas_constant.i for an unused variable. This 
does not effect the use of this program.

NOTE 4: The linker gives three warnings that can be ignored.

6.1.2 Compiling programs for Sun 4 

        cc -DNO_HAVE_PROTOTYPES -DNO_STDARG camex_mas_read.c -g -I/usr/local/hdf/include 
           -o camex_read_mas_c -L/usr/local/hdf/lib -lmfhdf -ldf -ljpeg -lz 
           /usr/lib/libm.a 

        f77 camex_mas_read.f -I/usr/local/hdf/include 
           -o camex_mas_read_f -L/usr/local/HDF4.1r1/lib -lmfhdf -ldf -ljpeg -lz 
           /usr/lib/libm.a

6.1.3 Compiling programs for HP

        cc -o camex_mas_read_c camex_mas_read.c -I/usr/local/hdf/include 
           /usr/local/hdf/lib/libmfhdf.a /usr/local/hdf/lib/libdf.a 
           /usr/local/hdf/lib/libjpeg.a /usr/local/hdf/lib/libz.a /usr/lib/libm.a


        f77 -O -o camex_mas_read_f camex_mas_read.f -I/usr/local/hdf/include 
           /usr/local/hdf/lib/libmfhdf.a /usr/local/hdf/lib/libdf.a 
           /usr/local/hdf/lib/libjpeg.a /usr/local/hdf/lib/libz.a /usr/lib/libm.a


6.2 How to Run the Sample Read Software

    This section illustrates the invocation of the various applications. 

6.2.1 camex_mas_read_c

    Currently, the executable camex_mas_read_c program does not accept command 
line arguments. The output file name is automatically created by appending ".rpt" 
to the input file name. This code assumes that the data and code are located 
in the working directory. The report file generated will also be written to the 
working directory. After entering the filename, the user is presented with a 
parameter selection list. The user can select some of the parameters or all 
of the parameters to be written into the output file. At this point, the program 
generates the report file and exits. To begin program execution for the 'C' 
executable at the UNIX command line prompt, type :

     % camex_mas_read_c

6.2.2 camex_mas_read_idl

    The idl read software can be compiled and run through the IDL development 
environment. The idl read software can also be started by compiling and then 
executing the program. At the UNIX command line prompt, type: 

     % idl
     IDL> camex_mas_read_idl

6.2.3 camex_mas_read_f

Currently, the executable camex_mas_read_f program does not accept command 
line arguments. When the program is executed, it requests an input filename. An 
output filename is not automatically created. After entering the filename, the 
user must input a series of <cr> (carriage returns) or n - (no's) for a series 
of output requests. To begin program execution for the Fortran executable, at 
the UNIX command line prompt, type:
 
     % camex_mas_read_f

A sample of the interactive program execution is provided in Section 7.3.


7.0 Sample Output

7.1  Output demonstration of C sample read software.

-------------------------------------------------------------------------------------
% camex_mas_read_c
This program reads CAMEX_ER2_MAS netCDF data.
  Please enter Q to Quit or C to continue c
 
        Please enter netCDF file name to read: 
MASL1B_01141_18_20010924_0010_0037_V01.hdf
Report file name is: MASL1B_01141_18_20010924_0010_0037_V01.hdf.rpt
 
  Item      Data Type     Label(dimension lengths)
  ====      =========     ========================
 
    1         float       Left50%ResponseWavelength(50)
    2         float       Central100%ResponseWavelength(50)
    3         float       Right50%ResponseWavelength(50)
    4         float       EffectiveCentralWavelength_IR_bands(50)
    5         float       TemperatureCorrectionSlope(50)
    6         float       TemperatureCorrectionIntercept(50)
    7         float       SolarSpectralIrradiance(50)
    8          char       DataSetHeader(129 X 80)
    9          long       ScanLineCounter(9999)
   10          long       GreenwichMeanTime(9999)
   11          long       YearMonthDay(9999)
   12         short       AircraftRollCount(9999)
   13         short       BlackBody1Temperature(9999)
   14         short       BlackBody2Temperature(9999)
   15         float       ScanRate(9999)
 
Please choose the numbers of the data items you wish to dump
Enter -1 to display additional items or zero to end selection process
 
NOTE: if you enter 0 as very first entry, all variables will be displayed
 
-1
 
  Item      Data Type     Label(dimension lengths)
  ====      =========     ========================
 
   16         float       ScanlineTime(9999)
   17         float       AircraftLatitude(9999)
   18         float       AircraftLongitude(9999)
   19         float       AircraftHeading(9999)
   20         float       AircraftAltitude(9999)
   21         float       AircraftPitch(9999)
   22         float       TBack(9999)
   23         short       AnalogGain(9999 X 50)
   24         short       AnalogOffset(9999 X 50)
   25         short       BlackBody1Counts(9999 X 50)
   26         short       BlackBody2Counts(9999 X 50)
   27         short       Head1Counts(9999 X 50)
   28         short       Head2Counts(9999 X 50)
   29         float       CalibrationSlope(9999 X 50)
   30         float       CalibrationIntercept(9999 X 50)
 
Please choose the numbers of the data items you wish to dump
Enter -1 to display additional items or zero to end selection process
 
0
Would you like the global attributes included in the report? (Y/N)y
 

This is the report file for the MASL1B_01141_18_20010924_0010_0037_V01.hdf file
 
 
****************** START GLOBAL ATTRIBUTE SECTION ******************
 
CreationDate = 21-Feb-2002 13:15:44
AircraftPlatform = NASA ER-2 (809)
NavFormatCode = Format (A-1)
LocationCode = Inertial (INU)
AltitudeCode = Inertial (INU)
NavDataSource = ER2 navigation recorder
NavDataPath = /nav/2001/er2/01-141
CalibrationName = CAMEX-4_Aug10-Oct23
Reference = NCSA HDF Reference Manual, Version 4.1r4, 2000
title = MODIS Airborne Simulator (MAS) Level-1B Data
ExperimentName = CAMEX-4
FlightNumber = 01-141
FlightDate = 23 Sep 2001
SiteLineRun = void
GeographicArea = Hurricane Humberto
SRF_FTP = ftp://asapdata/mas/srf/Aug_01_after_al/
SRF_dataset = /rarray/calibrat/mas/srf/Aug_01_after_al/
FlightLineNumber = 18s
TotalFlightLines = 21s
DataUsersGuideSource = http://ltpww.gsfc.nasa.gov/MAS/
SoftwareVersion = Level-1b Version 10.0.1 UR
CalibrationVersion = Version 1.0 Calibration
data_set = MAS CAMEX-4
day_night_flag = D
granule_version = 1s
metadata_version = 1.0.0
data_quality = Good
Other_Aircraft_Sensors = HAMSR, LIP, EDOP, DropSonde, AMPR
Principal_Investigator = J. Myers (ARC)
lat_UL = 31.188219f
lon_UL = -70.566513f
lat_UR = 30.854631f
lon_UR = -70.513702f
lat_LL = 30.880686f
lon_LL = -74.093475f
lat_LR = 30.548241f
lon_LR = -74.052536f
begin_date = 20010923 001053
end_date = 20010923 003737
RunTime = 1,057,200 ms, or 105 ms/scanline
CompletionDate = 21-Feb-2002 13:51:55
producer_granule_id = MASL1B_01141_18_20010923_0010_0037_V01.hdf
granule_size = 898277945
 
****************** END GLOBAL ATTRIBUTE SECTION ******************
 
 
 Left50%ResponseWavelength 
        units = microns
0.452 , 0.534 , 0.635 , 0.687 , 0.729 , 0.81 , 0.853 , 0.893 , 0.933 , 
    1.598 , 1.651 , 1.705 , 1.758 , 1.81 , 1.859 , 1.91 , 1.96 , 2.01 , 
    2.06 , 2.11 , 2.16 , 2.209 , 2.259 , 2.309 , 2.359 , 3.034 , 3.196 , 
    3.343 , 3.508 , 3.668 , 3.815 , 3.985 , 4.146 , 4.286 , 4.459 , 4.609 , 
    4.773 , 4.927 , 5.077 , 5.234 , 5.357 , 8.245 , 9.334 , 10.125 , 10.629 , 
    11.638 , 12.594 , 12.938 , 13.459 , 13.997  ;
 
 Central100%ResponseWavelength 
        units = microns
0.472 , 0.554 , 0.658 , 0.708 , 0.75 , 0.83 , 0.874 , 0.912 , 0.954 , 
    1.624 , 1.676 , 1.728 , 1.782 , 1.832 , 1.882 , 1.932 , 1.984 , 2.034 , 
    2.084 , 2.134 , 2.184 , 2.234 , 2.284 , 2.334 , 2.384 , 3.115 , 3.28 , 
    3.44 , 3.595 , 3.75 , 3.91 , 4.07 , 4.218 , 4.358 , 4.545 , 4.695 , 
    4.86 , 5.005 , 5.175 , 5.325 , 5.395 , 8.454 , 9.555 , 10.353 , 10.853 , 
    11.883 , 12.783 , 13.173 , 13.703 , 14.213  ;
 
 Right50%ResponseWavelength 
        units = microns
0.493 , 0.577 , 0.689 , 0.731 , 0.773 , 0.855 , 0.895 , 0.934 , 0.974 , 
    1.649 , 1.702 , 1.756 , 1.808 , 1.859 , 1.91 , 1.96 , 2.01 , 2.061 , 
    2.11 , 2.161 , 2.21 , 2.259 , 2.309 , 2.359 , 2.408 , 3.188 , 3.343 , 
    3.504 , 3.663 , 3.808 , 3.979 , 4.14 , 4.299 , 4.439 , 4.609 , 4.769 , 
    4.926 , 5.074 , 5.236 , 5.374 , 5.436 , 8.592 , 9.788 , 10.594 , 11.079 , 
    12.125 , 12.977 , 13.405 , 14.005 , 14.408  ;
 
 EffectiveCentralWavelength_IR_bands 
        units = microns
        fill_value = -99.000000f
-99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , 
    -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , -99 , 
    -99 , 3.10797 , 3.268112 , 3.423981 , 3.586009 , 3.73956 , 3.898763 , 
    4.064416 , 4.219978 , 4.360062 , 4.535438 , 4.692466 , 4.85168 , 
    5.00327 , 5.158375 , 5.304647 , 5.406146 , 8.406835 , 9.549147 , 
    10.35304 , 10.85647 , 11.87887 , 12.76208 , 13.17804 , 13.7222 , 14.20525  ;
 
	...
	Data continues on  
	...

 TemperatureCorrectionSlope 
        units = (none)
0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
    0 , 0 , 0 , 0 , 0 , 0 , 0.9987966 , 0.9991202 , 0.9991906 , 0.9991649 , 
    0.9993114 , 0.9993221 , 0.9993538 , 0.9994915 , 0.9995264 , 0.9994896 , 
    0.9995307 , 0.9995632 , 0.9996331 , 0.9996148 , 0.9997188 , 0.9996941 , 
    0.9993998 , 0.9993692 , 0.9994712 , 0.9995429 , 0.9996156 , 0.9997581 , 
    0.9997436 , 0.9997238 , 0.9998167  ;

	...
	Data continues on  
	...
-------------------------------------------------------------------------------------


7.2 Output demonstration of IDL sample read software

-------------------------------------------------------------------------------------
% idl
IDL Version 5.3 (IRIX mipseb). (c) 1999, Research Systems, Inc.
Installation number: 17659.
Licensed for use by: NASA - Langley Research Center
 
IDL> .compile camex_mas_read_idl
% Compiled module: TEST_ISHDF.
% Compiled module: CAMEX_MAS_READ_IDL.
IDL> camex_mas_read_idl
% Compiled module: PICKFILE.
% Loaded DLM: HDF.
Valid HDF file. Opening "/fs2/camex/MASL1B_01141_18_20010924_0010_0037_V01.hdf"
Report file is called
/fs2/camex/MASL1B_01141_18_20010924_0010_0037_V01.hdf.rpt
Do you want the global attributes printed to the output file?y
Dataset No.        1: Left50%ResponseWavelength
Dataset No.        2: Central100%ResponseWavelength
Dataset No.        3: Right50%ResponseWavelength
Dataset No.        4: EffectiveCentralWavelength_IR_bands
Dataset No.        5: TemperatureCorrectionSlope
Dataset No.        6: TemperatureCorrectionIntercept
Dataset No.        7: SolarSpectralIrradiance
Dataset No.        8: DataSetHeader
Dataset No.        9: ScanLineCounter
Dataset No.       10: GreenwichMeanTime
Dataset No.       11: YearMonthDay
Dataset No.       12: AircraftRollCount
Dataset No.       13: BlackBody1Temperature
Dataset No.       14: BlackBody2Temperature
Dataset No.       15: ScanRate
Dataset No.       16: ScanlineTime
Dataset No.       17: AircraftLatitude
Dataset No.       18: AircraftLongitude
Dataset No.       19: AircraftHeading
Dataset No.       20: AircraftAltitude
Dataset No.       21: AircraftPitch
Dataset No.       22: TBack
Dataset No.       23: AnalogGain
Dataset No.       24: AnalogOffset
Dataset No.       25: BlackBody1Counts
Dataset No.       26: BlackBody2Counts
Dataset No.       27: Head1Counts
Dataset No.       28: Head2Counts
Dataset No.       29: CalibrationSlope
Dataset No.       30: CalibrationIntercept
Dataset No.       31: PixelLatitude
Dataset No.       32: PixelLongitude
Dataset No.       33: SensorZenithAngle
Dataset No.       34: SensorAzimuthAngle
Dataset No.       35: SolarZenithAngle
Dataset No.       36: SolarAzimuthAngle
Dataset No.       37: CalibratedData
Enter 0 for all datasets to be displayed or 1 to select datasets1
Enter dataset no. then <cr> or zero to end selection process25
Enter dataset no. then <cr> or zero to end selection process0
Reading data for BlackBody1Counts
Read operation complete.
IDL> 

The output file, which has the same name as the original file
but with .rpt added is listed below: 

RESULTS OF IDL PROCESSING:

This is a report file for 
/fs2/camex/MASL1B_01141_18_20010924_0010_0037_V01.hdf
Reading number of datasets and file attributes in file ...
 
No. of Datasets:             37
No. of File Attributes:           43
No. of Palettes:              0
 
Printing name of each file attribute...
File Attribute No. 0: CreationDate
CreationDate 21-Feb-2002 13:15:44
File Attribute No. 1: AircraftPlatform
AircraftPlatform NASA ER-2 (809)
File Attribute No. 2: NavFormatCode
NavFormatCode Format (A-1)
File Attribute No. 3: LocationCode
LocationCode Inertial (INU)
File Attribute No. 4: AltitudeCode
AltitudeCode Inertial (INU)
File Attribute No. 5: NavDataSource
NavDataSource ER2 navigation recorder
File Attribute No. 6: NavDataPath
NavDataPath /nav/2001/er2/01-141
File Attribute No. 7: CalibrationName
CalibrationName CAMEX-4_Aug10-Oct23
File Attribute No. 8: Reference
Reference NCSA HDF Reference Manual, Version 4.1r4, 2000
File Attribute No. 9: title
title MODIS Airborne Simulator (MAS) Level-1B Data
File Attribute No. 10: ExperimentName
ExperimentName CAMEX-4
File Attribute No. 11: FlightNumber
FlightNumber 01-141
File Attribute No. 12: FlightDate
FlightDate 23 Sep 2001
File Attribute No. 13: SiteLineRun
SiteLineRun void
File Attribute No. 14: GeographicArea
GeographicArea Hurricane Humberto
File Attribute No. 15: SRF_FTP
SRF_FTP ftp://asapdata/mas/srf/Aug_01_after_al/
File Attribute No. 16: SRF_dataset
SRF_dataset /rarray/calibrat/mas/srf/Aug_01_after_al/
File Attribute No. 17: FlightLineNumber
FlightLineNumber       18
File Attribute No. 18: TotalFlightLines
TotalFlightLines       21
File Attribute No. 19: DataUsersGuideSource
DataUsersGuideSource http://ltpww.gsfc.nasa.gov/MAS/
File Attribute No. 20: SoftwareVersion
SoftwareVersion Level-1b Version 10.0.1 UR
File Attribute No. 21: CalibrationVersion
CalibrationVersion Version 1.0 Calibration
File Attribute No. 22: data_set
data_set MAS CAMEX-4
File Attribute No. 23: day_night_flag
day_night_flag D
File Attribute No. 24: granule_version
granule_version        1
File Attribute No. 25: metadata_version
metadata_version 1.0.0
File Attribute No. 26: data_quality
data_quality Good
File Attribute No. 27: Other_Aircraft_Sensors
Other_Aircraft_Sensors HAMSR, LIP, EDOP, DropSonde, AMPR
File Attribute No. 28: Principal_Investigator
Principal_Investigator J. Myers (ARC)
File Attribute No. 29: lat_UL
lat_UL       31.1882
File Attribute No. 30: lon_UL
lon_UL      -70.5665
File Attribute No. 31: lat_UR
lat_UR       30.8546
File Attribute No. 32: lon_UR
lon_UR      -70.5137
File Attribute No. 33: lat_LL
lat_LL       30.8807
File Attribute No. 34: lon_LL
lon_LL      -74.0935
File Attribute No. 35: lat_LR
lat_LR       30.5482
File Attribute No. 36: lon_LR
lon_LR      -74.0525
File Attribute No. 37: begin_date
begin_date 20010923 001053
File Attribute No. 38: end_date
end_date 20010923 003737
File Attribute No. 39: RunTime
RunTime 1,057,200 ms, or 105 ms/scanline
File Attribute No. 40: CompletionDate
CompletionDate 21-Feb-2002 13:51:55
File Attribute No. 41: producer_granule_id
producer_granule_id MASL1B_01141_18_20010923_0010_0037_V01.hdf
File Attribute No. 42: granule_size
granule_size    898277945
 
Dataset No. 24: BlackBody1Counts
 
Number of attributes:            0
 
    4946    4934    4922    4933    4928    4924    4930    4917    4911
    4495    3939    3970    4737    4345    4227    4810    4649    4016
    4255    4070    4253    4621    4587    4182    4186    5012    4445
    5152    4686    5013    5271    4816    5319    4464    5409    4525
    4969    4982    4531    4787    4504    4966    4426    4729    4138
    4938    4033    4109    4640    5819

	...
	Data continues on  
	...

    4947    4935    4923    4933    4928    4925    4931    4919    4915
    4448    3892    3920    4637    4246    4130    4712    4547    3911
    4156    3970    4204    4520    4486    4083    4086    5020    4126
    4842    4379    4720    4987    4546    5055    4210    5154    4278
    4686    4672    4208    4445    4851    4791    4195    4111    4353
    4864    4130    4137    4324    5944
-------------------------------------------------------------------------------------


7.3 Output demonstration of Fortran sample read software.

Sample read software for camex_mas_read_f:

-------------------------------------------------------------------------------------
% camex_mas_read_f
  WARNING: This version fixes a bug in HDF3.3r3
 Enter HDF file name : MASL1B_01141_18_20010924_0010_0037_V01.hdf
 name=MASL1B_01141_18_20010924_0010_0037_V01.hdf                              
  HDF file id =       393216
  
  # of Global Attributes            =           43
  # of Scientific Data Sets (SDS"s) =           37
  
  Read Global Attributes ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = CreationDate                                      
 Attribute Index =   0
 Number_Type =         4          Count =         20
 
 - - - Attribute Value - - - 
 21-Feb-2002 13:15:44
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = AircraftPlatform                                  
 Attribute Index =   1
 Number_Type =         4          Count =         15
 
 - - - Attribute Value - - - 
 NASA ER-2 (809)
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = NavFormatCode                                     
 Attribute Index =   2
 Number_Type =         4          Count =         12
 
 - - - Attribute Value - - - 
 Format (A-1)
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = LocationCode                                      
 Attribute Index =   3
 Number_Type =         4          Count =         14
 
 - - - Attribute Value - - - 
 Inertial (INU)
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = AltitudeCode                                      
 Attribute Index =   4
 Number_Type =         4          Count =         14
 
 - - - Attribute Value - - - 
 Inertial (INU)
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = NavDataSource                                     
 Attribute Index =   5
 Number_Type =         4          Count =         23
 
 - - - Attribute Value - - - 
 ER2 navigation recorder
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = NavDataPath                                       
 Attribute Index =   6
 Number_Type =         4          Count =         20
 
 - - - Attribute Value - - - 
 /nav/2001/er2/01-141
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
 
 ******** GLOBAL ATTRIBUTE ********* 
 Attribute_Name = CalibrationName                                   
 Attribute Index =   7
 Number_Type =         4          Count =         19
 
 - - - Attribute Value - - - 
 CAMEX-4_Aug10-Oct23
  ********************************** 
 
 Continue ? ( <cr> or n ) : 
n
  
  Read Scientific Data Set"s (SDS"s) ? (<cr> or n) : 
 
 ************* Scientific Data Set **************
 SDS_Name = Left50%ResponseWavelength                         
 Index =   0        SDS_ID =     262144
 # of Dims =  1        DimSizes =     50     0     0     0     0
 Number_Type =    5         Number of Attributes =  1
 
 - - - Sample Data Value - - - 
          0.533999979
  - - - - - - - - - - - - - - - 
  
  Read SDS attribute string ? ( <cr> or n ) : 
 
 -------- Local Attribute ----------- 
 Attribute_Name = units                                             
 Attribute Index =   0
 Number_Type =         4          Count =          7
 - - - Attribute Value - - - 
 microns
--------------------------------------
  ************************************************ 
 
 Continue ? ( <cr> or n ) : 
 
 ************* Scientific Data Set **************
 SDS_Name = Central100%ResponseWavelength                     
 Index =   1        SDS_ID =     262145
 # of Dims =  1        DimSizes =     50     0     0     0     0
 Number_Type =    5         Number of Attributes =  1
 
 - - - Sample Data Value - - - 
          0.554000020
  - - - - - - - - - - - - - - - 
  
  Read SDS attribute string ? ( <cr> or n ) : 
 
 -------- Local Attribute ----------- 
 Attribute_Name = units                                             
 Attribute Index =   0
 Number_Type =         4          Count =          7
 - - - Attribute Value - - - 
 microns
--------------------------------------
  ************************************************ 
 
 Continue ? ( <cr> or n ) : 
n
  
  Dump Descaled Calibrated Radiances ? (<cr> or n) : 
 
 ************* Scientific Data Set **************
 SDS_Name = CalibratedData                                    
 Index =  36        SDS_ID =     262180
 # of Dims =  3        DimSizes =    716    50  9999     0     0
 Number_Type =   22         Number of Attributes =  2
 
 -------- Local Attribute ----------- 
 Attribute_Name = units                                             
 Attribute Index =   0
 Number_Type =         4          Count =         29
 - - - Attribute Value - - - 
 watts/meter2/steradian/micron
 -------- Local Attribute ----------- 
 Attribute_Name = scale_factor                                      
 Attribute Index =   1
 Number_Type =         5          Count =         50
 - - - Attribute Value - - - 
         0.10000        0.10000        0.10000        0.10000        0.10000
         0.10000        0.10000        0.10000        0.10000        0.10000
         0.01000        0.01000        0.01000        0.01000        0.01000
         0.10000        0.01000        0.01000        0.01000        0.01000
         0.01000        0.01000        0.01000        0.01000        0.01000
         0.00100        0.00100        0.00100        0.00100        0.00100
         0.00100        0.00100        0.00100        0.00100        0.00100
         0.00100        0.00100        0.00100        0.00100        0.00100
         0.00100        0.01000        0.01000        0.01000        0.01000
         0.01000        0.01000        0.01000        0.01000        0.01000
 
  
  Enter Pixel(1-716), Record(1-        9999), Channel(1-12) ? 
1,5,7
  At Pixel =     1 Record =     5
  For Channel =  7
  Stored Value =     2 Scale Factor =   0.100
  Calibrated Radiance =         0.2000000030
 
 Another ? ( <cr> or n ) : 
n
-------------------------------------------------------------------------------------


8.0 Additional Data Information

King, M. D., W. P. Menzel, P. S. Grant, J. S. Myers, 
G. T. Arnold, S. E. Platnick, L. E. Gumley, S. C.  Tsay, 
C. C. Moeller, M. Fitzgerald, K. S. Brown and F. G. Osterwisch, 
1996: Airborne scanning spectrometer for remote sensing of cloud, aerosol, 
water vapor and surface properties. J. Atmos. Oceanic Technol., 13, 777-794. 


Last Updated: <June 7, 2002>