CERES EBAF-TOA Readme File 1.0 Introduction This readme file document provides information on the following Clouds and Earth's Radiant Energy System (CERES) EBAF-TOA data set: CERES_EBAF-TOA_Edition4.0 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 Output 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 NASA Langley Research Center Hampton, Virginia 23681-2199 U.S.A. E-mail: support-asdc@earthdata.nasa.gov Phone: (757)864-8656 URL: https://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://ceres.larc.nasa.gov. 2.2 Data Quality For a discussion regarding the quality of the EBAF-TOA data set, please refer to the corresponding Quality Summary Document available from the URL https://eosweb.larc.nasa.gov/project/ceres/quality_summaries/CERES_EBAF_Ed4.0_DQS.pdf 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 3.0 Format and Packaging This package includes a program, written in Fortran, which will read the EBAF-TOA netCDF file. There is example output code provided in the main (read_ceres_ebaf_toa.f90) 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-TOA parameters. Information on the structure of the EBAF-TOA file can be found by executing a dump of the netCDF file (see Section 3.3 below). 3.1 Sample Read Package Contents This package consists of the following files: 1) read_ceres_ebaf_toa.f90 2) sample_output_ebaf_toa.txt Descriptions for each file are as follows: 1)'read_ceres_ebaf_toa.f90' is the main program which provides information about all of the parameters in the CERES EBAF-TOA netCDF file. At the end of the program, the user must make modifications in order to either print out or process the parameters they would like to use. 2)'sample_output_ebaf_toa.txt' is an ASCII output file obtained from running the read_ceres_ebaf_toa read program with the 'CERES_EBAF-TOA_Edition4.0_200003-201709.nc' file as input. This is provided so that the user can compile, run, and verify output of the read_ceres_ebaf_toa program before making any modifications. 3.2 Zip Information To read the files, first unzip them with Info-Zip software. Information about downloading and using this freeware is available at the URL: http://www.info-zip.org/pub/infozip/Info-ZIP.html 3.3 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.4 netCDF library netCDF information, documentation, tutorials, libraries, etc. can be found on-line at the URL http://www.unidata.ucar.edu/software/netcdf/ 3.5 Data Format The EBAF-TOA data file is written in netCDF. 4.0 Science Parameters Information Execute the first ncdump command listed in Section 3.3 (Unix commands for netCDF) to get header information that includes 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 modified. The sample software does read in all parameters in the file. A user may make modifications near the end of the code where the output is written. A note to the user: It is recommended that before modifying the EBAF-TOA read program, the user should first compile and run the EBAF-TOA 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_toa.txt'. If this test is successful, then the user should modify the the EBAF-TOA read program or create 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_toa.f90' read code and the EBAF-TOA data set in the same directory. 2. Compile the code with the following command: If you have the nc-config command available as part of your netcdf installation, use: gfortran `nc-config --fflags` read_ceres_ebaf_toa.f90 `nc-config --flibs` -o read_ebaf_toa OR if you would like to specify your netCDF include and library directories yourself, use: gfortran -I/your_include_dir read_ceres_ebaf_toa.f90 -L/your_lib_dir -lyour_lib1 -lyour_lib2 -o read_ebaf_toa Example: gfortran -g -O2 -I/usr/local/include read_ceres_ebaf_toa.f90 -L/usr/local/lib -lnetcdf -lnetcdff -o read_ebaf_toa 6.2 How to Run the Sample Read Software 1. Execute read_ebaf_toa by typing at the command line: > read_ebaf_toa 7.0 Sample Output The program runs and currently is coded to print out 24 lines (one for each of the first 24 months) in the file with the global means for TOA SW up, LW up, and Net fluxes as a sample. Compare this output to the values in sample_output_ebaf_toa.txt, which is also included below. TOA SW TOA LW TOA Net All-sky 99.2524033 238.082901 6.02050018 97.6362000 237.924805 2.06730008 97.8411026 240.794693 -6.01749992 96.6481018 243.254501 -10.2293997 94.0386963 243.945999 -8.63609982 93.3688965 243.618607 -5.11479998 95.1985016 242.209900 -1.01310003 101.898399 238.768005 1.72360003 106.468002 236.984497 4.33979988 108.203102 236.789795 6.23929977 104.726601 236.805496 9.89249992 102.897903 236.659897 9.01210022 99.0622025 236.888306 7.48549986 98.3844986 238.254303 0.966899991 97.8271027 241.102600 -6.22510004 96.4029007 242.453293 -9.18019962 93.6941986 244.257401 -8.55130005 93.2236023 244.664902 -6.15969992 94.4707031 241.958099 -0.135100007 101.630997 239.510406 1.11170006 105.840897 238.118607 3.69869995 108.877197 236.990906 5.29829979 106.751900 236.973404 7.79090023 102.903397 237.815796 7.93599987 Last Updated: February 7, 2018 -----------------------------------------------------------------------------