CERES EBAF Readme File 1.0 Introduction This readme file document provides information on the following Clouds and Earth's Radiant Energy System (CERES) EBAF data set: TERRA: CERES_EBAF_TOA_Terra_Edition1A This document 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 Outputs Section 8.0 - Additional Data Information (This section is optional) 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 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 2.1 Instrumentation Description For a complete description of the CERES experiment and instruments, please refer to the documentation provided at the URL http://science.larc.nasa.gov/ceres/index.html. 2.2 Data Quality For a discussion regarding the quality of the EBAF data sets, please refer to the corresponding Quality Summary Document available from the URL http://eosweb.larc.nasa.gov/PRODOCS/ceres/table_ceres.html. 2.3 Science Representatives *NOTE TO USER: If you have any questions concerning the sample code or the data, please contact the Atmospheric Sciences Data Center User Services Office. The contact information is provided above in Section 1.0. 1. Dr. Norman G. Loeb, CERES Interdisciplinary Principal Investigator NASA Langley Research Center Mail Stop 420 Hampton, VA 23681-2199 E-mail: Norman.G.Loeb@nasa.gov FAX: (757)864-7996 Phone: (757)864-5688 2. Mr. David R. Doelling, SD-CLIMATE SCIENCE Branch NASA Langley Research Center Mail Stop 420 Hampton, VA 23681-2199 E-mail: David.R.Doelling@nasa.gov FAX: (757)864-7996 Phone: (757)864-2155 3.0 Format and Packaging This package includes a program, written in Fortran, which will read the EBAF netCDF file. There is example output code provided in the main (read_ceres_ebaf.f) program. This read program is provided as a template to the user who will need to modify it to output or otherwise handle various EBAF parameters. Information on the structure of the EBAF file can be found in the Data Products Catalog (DPC) pages included in this package or by executing a dump of the netCDF file. 3.1 Sample Read Package Contents This package consists of the following files: 1) read_ceres_ebaf.f Descriptions for each file is as follows: 1)'read_ceres_ebaf.f' is the main program which reads in all of the parameters in the CERES EBAF netCDF file. At the end of the program, user must make modifications in order to either print out or process the parameters they would like to work with. 3.2 Unix commands for netCDF Some Unix commands for handling netCDF at the command line are: ncdump -h - lists the header information for the file ncdump -v '' - lists the values for the variable name. 3.3 netCDF library netcdf information, documentation, tutorials, libraries, etc. can be found on-line at the URL http://www.unidata.ucar.edu/software/netcdf/ 4.0 Science Parameters Information Execute the first ncdump command listed in section 3.2 (Unix commands for netCDF) to get the header file which will include the following for each parameter: Type (int, float, etc...) Name Dimensions long_name Units Ranges (minimum and maximum values) 5.0 Description of Sample Read Software The sample read software in this package is intended as a base that is to be added to. The sample software does read in all parameters on the file. A user may make modifications beginning at the bottom of the code starting with the line that begins "C001". A note to the user: It is recommended that before modifiying the EBAF read program, the user should first compile and run the EBAF read program and compare the results that are created by the read program with the list of values in the sample output file,'sample_output_ebaf.asc'. If this test is successful, then the user should modify the the EBAF read program or their own software to handle the parameters in which they are interested. 6.0 Implementing Sample Read Software 6.1 Compiling the Sample Read Software 1. Place the 'read_ceres_ebaf.f' read code and the EBAF data set in the same directory. 2. Compile the code with the following command: > f77 -static -col120 -o read_ceres_ebaf.x read_ceres_ebaf.f /usr/local/netcdf-3.5.0/lib/libnetcdf.a 6.2 How to Run the Sample Read Software 1. Execute read_ceres_ebaf.x by typing at the command line: > read_ceres_ebaf.x 2. Program will prompt you to enter the name of the input file. Type in the name: CERES_EBAF_TOA_Terra_Edition1A_200003-200510.nc 7.0 Sample Output The program runs and currently is coded to print out 68 lines (one for each month) with the global means for SW up, LW up, and Net fluxes just as a sample. Compare this output to the values in sample_output_ebaf.asc, which is also included below. 98.81950 238.0632 6.424988 97.13626 238.4213 1.951187 97.42097 240.5965 -5.450592 96.37362 242.9055 -9.676056 93.80952 243.6231 -8.167114 92.94686 243.4534 -4.719849 95.38643 242.1075 -1.178131 101.9628 238.5439 1.634537 106.5904 236.7359 4.264069 108.4042 236.3643 6.225327 104.8962 236.6720 9.628632 102.6868 236.9179 8.715210 98.42426 237.3179 7.594604 97.73980 238.2535 1.552414 97.46429 240.8726 -5.728348 96.01868 242.0452 -8.426102 93.52168 243.8521 -8.089401 92.96923 244.1786 -5.470520 94.54698 241.6709 6.5628052E-02 101.5818 238.9186 1.583694 105.8123 236.9886 4.736771 108.9945 235.9590 6.008575 106.7789 235.9158 8.507843 102.6633 236.7717 8.919891 98.55138 237.3639 7.474564 97.45469 238.8503 1.291412 96.35876 241.3895 -5.102905 96.48463 242.8116 -9.641403 94.17622 244.5416 -9.444046 93.74733 244.0837 -6.183380 94.71545 242.7427 -1.221817 99.73875 239.5982 2.691193 106.2705 236.8438 4.381470 108.3564 236.2623 6.333267 106.0248 237.2279 7.975250 101.6261 237.6724 9.119720 97.98297 238.4849 6.988541 97.09047 238.5832 1.973953 97.61780 240.7435 -5.697083 95.73985 242.8330 -8.929428 93.50553 244.0774 -8.340454 92.31154 243.5999 -4.312729 94.76827 242.1413 -0.7249756 100.0218 239.9133 2.049484 105.8680 237.1539 4.440353 108.1953 236.6968 6.046585 105.9061 236.2223 9.116623 101.3817 237.2720 9.721390 99.85965 237.4847 5.973083 96.26888 238.3978 2.840042 98.40150 240.1075 -5.951965 96.74056 242.7774 -9.928238 93.24705 243.3796 -7.360413 92.59037 243.6123 -4.506912 94.62151 241.9219 -0.2072449 100.4592 239.6598 2.035690 105.8643 236.8304 4.901367 107.6081 235.6487 7.728455 105.8274 236.6335 8.736008 102.5107 237.2007 8.614716 98.66393 237.4740 7.209854 96.97601 238.5820 1.988403 96.62543 239.5997 -3.630875 96.14868 242.5495 -9.082672 94.14096 244.0983 -8.981827 93.22260 243.6329 -5.188309 94.68195 242.0309 -0.4314423 100.3869 239.6786 2.039200 Last Updated: June 27, 2008 -----------------------------------------------------------------------------