FIRE_CI2_SABRLNR_2D README File for C-based Read Software 1.0 Introduction This file contains information about the FIRE_CI2_SABRLNR_2D data set read software. This README file includes the following sections: * Section 2.0 - describes the 'C' program (source file) * Section 3.0 - describes how to create the executable from the 'C' program. * Section 4.0 - demonstrates how to invoke the run-time executable. * Section 5.0 - provides general information on the data sets. If users have question while using the fire_ci2_sabrlnr_2d_read.c sample read software, please contact the Langley Science User and Data Support (SUDS) office. The SUDS may be reached by E-mail: userserv@eosdis.larc.nasa.gov, by telephone at (757) 864-8656, or by FAX at (757) 864-8807. The SUDS mailing address is: Langley DAAC Science User and Data Support Office NASA Langley Research Center Mail Stop 157D Hampton, VA 23681-0001 2.0 Read Software Files The read program was developed in the 'C' language. This program has been tested on the 'Sun4', the 'HP' UNIX-based workstation and a 'SGI'-based system. There are no library routines that need to be loaded or linked. A 'makefile' is included for the convenience of creating the executable file from the source file. These files and their purposes are listed as follows: * makefile_sabrlnr - contains a set of commands to build the run-time executable. * fire_ci2_sabrlnr_2d_read.c - reads the FIRE/SABRELINER data. 3.0 Creating C Executable Files There are two ways to build the sample read program from the source file. One is applying the 'make' command to the file makefile_sabrlnr, which defines the 'C' source file listed in Section 2.0. The other is using the 'C' compiler 'cc' (or 'acc' for ANSI 'C' compiler). Section 3.1 illustrates the first method, and Section 3.2 illustrates the second method. The first method is simpler to use than the second one. The symbol '%' in the section stands for the UNIX command line prompt. 3.1 Creating with 'make' command To build the executable files for the FIRE/SABRELINER data set, at the command line prompt type: % make -f makefile_sabrlnr read_sabrlnr_2d 3.2 Create with C compiler 'cc' To use the command line to compile the FIRE/SABRELINER read software type: % cc -o read_sabrlnr_2d fire_ci2_sabrlnr_2d_read.c 4.0 Invoking Read Software This section illustrates the invocation of the executable file. Section 4.1 describes how to run the read program for the SABRELINER data set. 4.1 Running the Read Program for the FIRE_CI2_SABRLNR_2D Data Set At the command line prompt (%) type 'read_sabrlnr_2d' to run the file interactively. The program will prompt the user for an input filename. The file names are in the form "ci2_sb2dnn_yymmdd", where nn is the flight number and yymmdd is the year, month and day. For example, ci2_sb2d01_911117. Next, you will be prompted for an output file name. The data file will be read and output sent to the output file name entered. When this program is executed, it displays the following banner page with information pertaining to the Langley DAAC. ********************************************************************* * * * Langley DAAC * * PROJECT_LEVEL/DATA_SET_LEVEL READ SOFTWARE * * VERSION NUMBER: * * Language: C * * Platforms supported: SUN * * HP * * SGI * * Solaris 2.3 * * Contact: Langley DAAC user and Data Services Office * * NASA Langley Research Center * * Mail Stop 157D * * Hampton, VA 23681-0001 * * PHONE: (757)864-8656 FAX: (757)864-8807 * * * ********************************************************************* 5.0 Data Set Information Data Set Name: FIRE II 2D PROBE CONCENTRATIONS FOR THE NCAR SABRELINER PROBE NUMBER, unitless, 0, 1, 2 1 = INDICATES 2D-C PROBE CONCENTRATION MEASUREMENT 2 = INDICATES 2D-P PROBE CONCENTRATION MEASUREMENT Data Set Point of Contact: NAME: DR. ANDREW J. HEYMSFIELD ADDRESS: NATIONAL CENTER FOR ATMOSPHERIC RESEARCH P.O. BOX 3000 BOULDER, CO 80307-3000 TELEPHONE: (303) 497-8943 FAX: (303) 497-8181 INTERNET ADDRESS: HEYMS1@NCAR.UCAR.EDU Spatial Coverage (Range): Averages over 5 sec of aircraft time or approximately 1 km. Temporal Coverage: Start Date (mm/dd/yy): 11/09/91 Stop Date (mm/dd/yy): 12/07/91 Smallest unit of data collected: 5 seconds Data collected during the day and at night. Data processing date: 05/11/95, 1.20/97 ****************************************** * * * Sample Output * * * ****************************************** SABRELINER17 NOV 91 1 191027 210315 PROBE RESOLUTION (MICRONS): C: 50. P: 200. AREA RATIO BIN ENDPOINTS: 0.00 0.20 0.30 0.40 0.50 0.60 0.70 0.80 0.90 1.00 2.00 FOR PROBE 1 12 BINS -- END POINTS (IN MICRONS) ARE: 50. 100. 150. 200. 250. 300. 350. 400. 500. 750. 1000. 1500. 5000. FOR PROBE 2 12 BINS -- END POINTS (IN MICRONS) ARE: 200. 400. 600. 800. 1000. 1200. 1600. 2000. 2400. 2800. 3200. 4000. 10000. REJECTION CRITERIA: OUTSIDE RANGE OF SIZE BINS; AREA RATIO < 20.; INTERARRIVAL TIME < 10 MICROSECS; NUMBER OF GAPS IN IMAGE > 1 CONCENTRATIONS AVERAGED OVER 5 SECONDS ######## 1 191250 191254 5.00000 120.58824 5.28414E+00 ######## 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 5.2841E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 ######## 1 192050 192054 5.00000 167.64706 3.85846E+00 ######## 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 3.0106E-02 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 3.8153E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 0.0000E+00 ................................................................................................................................... ................................................................................................................................... The data are organized on a single flight basis. Each datafile contains processed concentration data based on habit type and area ratio. There are altogether 15 data files.