CERES EBAF-Surface Readme File 1.0 Introduction This readme file document provides information on the following Clouds and Earth's Radiant Energy System (CERES) EBAF-Surface data set: CERES_EBAF-Surface_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-Surface 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-Surface_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-Surface netCDF file. There is example output code provided in the main (read_ceres_ebaf_sfc.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-Surface parameters. Information on the structure of the EBAF-Surface 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_sfc.f90 2) sample_output_ebaf_sfc.txt Descriptions for each file is as follows: 1)'read_ceres_ebaf_sfc.f90' is the main program which provides information about all of the parameters in the CERES EBAF-Surface 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_sfc.txt' is an ASCII output file obtained from running the read_ceres_ebaf_sfc read program with the 'CERES_EBAF-Surface_Edition4.0_200003-201706.nc' file as input. This is provided so that the user can compile, run, and verify output of the read_ceres_ebaf_sfc 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-Surface 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 bottom of the code where the output is written. A note to the user: It is recommended that before modifying the EBAF-Surface read program, the user should first compile and run the EBAF-Surface 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_sfc.txt'. If this test is successful, then the user should modify the the EBAF-Surface 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_sfc.f90' read code and the EBAF-Surface 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_sfc.f90 `nc-config --flibs` -o read_ebaf_sfc OR if you would like to specify your netCDF include and library directories yourself, use: gfortran -I/your_include_dir read_ceres_ebaf_sfc.f90 -L/your_lib_dir -lyour_lib1 -lyour_lib2 -o read_ebaf_sfc Example: gfortran -g -O2 -I/usr/local/include read_ceres_ebaf_sfc.f90 -L/usr/local/lib -lnetcdf -lnetcdff -o read_ebaf_sfc 6.2 How to Run the Sample Read Software 1. Execute read_ebaf_sfc by typing at the command line: > read_ebaf_sfc 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 surface net SW, net LW, and net total fluxes as a sample. Compare this output to the values in sample_output_ebaf_sfc.txt, which is also included below. Surface SW Net Surface LW Net Surface Total Net All-sky 167.007614 -53.0415955 113.966026 163.533005 -53.5087128 110.024292 158.420074 -53.7788544 104.641220 156.762146 -53.7328568 103.029289 158.372833 -53.0088882 105.363945 161.478287 -53.8451385 107.633141 164.262939 -53.5205803 110.742363 163.655334 -52.6749916 110.980339 165.065262 -52.6033401 112.461922 166.203751 -53.2387733 112.964973 169.358109 -53.5479202 115.810188 167.725693 -52.3536530 115.372040 167.109039 -53.0475426 114.061501 162.461349 -53.4139328 109.047424 158.661194 -54.5811653 104.080025 156.967926 -53.0805817 103.887344 158.570694 -52.5796165 105.991074 160.819550 -52.3517532 108.467796 164.492996 -52.9899406 111.503059 163.504456 -52.1855545 111.318893 165.127060 -52.9284782 112.198578 164.732574 -52.2952042 112.437363 166.715591 -52.9174042 113.798195 167.895950 -52.9184494 114.977501 Last Updated: February 8, 2018 -----------------------------------------------------------------------------