Data Sets: CER_CRS_TRMM-PFM-VIRS_Edition2C CER_CRS_TRMM-PFM-VIRS_Edition2B 1.0 Introduction This readme file document provides information on the Clouds and Earth's Radiant Energy System (CERES) CER_CRS_TRMM-PFM-VIRS_Edition2B data set. 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 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://asd-www.larc.nasa.gov/ceres/ASDceres.html. 2.2 Data Quality For a discussion regarding the quality of the CER_CRS_TRMM-PFM-VIRS_Edition2B data set, please refer to the corresponding Quality Summary Document available from the URL http://eosweb.larc.nasa.gov/PRODOCS/ceres/table_ceres.html. 2.3 Other pertinent information The CERES CRS product is produced from software maintained by the CERES Surface and Atmospheric Radiation Budget (SARB) Working Group. For a detailed discussion of the algorithms employed by this software, see the CERES Algorithm Theoretical Basis Document for Compute Surface and Atmospheric Fluxes (System 5.0) provided at the URL http://asd-www.larc.nasa.gov/ATBD/ATBD.html. 2.4 Science Contact 1. Dr. Bruce A. Wielicki, CERES Interdisciplinary Principal Investigator Mail Stop 420 Atmospheric Sciences Research Building 1250 21 Langley Boulevard NASA Langley Research Center Hampton, Virginia 23681-2199 U.S.A E-mail: b.a.wielicki@larc.nasa.gov FAX: (757)864-7996 Phone: (757)864-5683 2. Dr. Thomas P. Charlock, SARB Working Group Chair Mail Stop 420 Atmospheric Sciences Research Building 1250 21 Langley Boulevard NASA Langley Research Center Hampton, Virginia 23681-2199 U.S.A E-mail: t.p.charlock@larc.nasa.gov FAX: (757)864-7996 Phone: (757)864-5687 3. Lisa H. Coleman, SARB Data Management Team member SAIC One Enterprise Parkway Hampton, VA 23699 U.S.A. E-mail: ceresdmt+sarb@larc.nasa.gov FAX: (757)825-9129 Phone: (757)827-4654 3.0 Format and Packaging 3.1 Sample Read Package Contents This package consists of the following files: 1. CRS_readhdf_daacv3.c This is the main program which accesses the HDF reading functions. It consists of several examples of accessing SDS and Vdata structures from the included sample CRS file. Comments are provided throughout the program. 2. CRS_readHDFfuncs_daacv3.c This is a file containing C functions that are linked with Program CRS_readhdf_daacv3.c and calls to the HDF library routines. 3. CRS_HDFread_daacv3.h This is a header file for Program CRS_readhdf_daacv3.c and the CRS HDF read functions. 4. compile_CRS_readhdf_daacv3 This is a sample script to compile the C programs in a UNIX environment. The script must be modified for different platforms to properly compile the programs and correctly link the HDF libraries. 5. CER_DPC_CRS_008007.pdf This is a PDF file containing the CERES Data Products Catalog pages corresponding to this CRS data set. This file is a subset of the CERES Data Products Catalog found under the "Documentation" option at the following URL: http://asd-www.larc.nasa.gov/ceres/ASDceres.html The version of the CERES Data Products Catalog at this URL contains the latest information about the CERES products. It is possible for the CRS product structure to change over time, and thus future CRS pages may not correspond to this data set. A copy of the CRS pages corresponding to this data set have therefore been included with this package. 6. CER_DPC_SSF_013010.pdf This is a PDF file containing the CERES Data Products Catalog pages corresponding to the CERES SSF data set that was the primary input for the generation of this CRS data set. The first 131 parameters in the CRS structure are copied from the SSF product and their definitions are not repeated in the CRS pages of the CERES Data Products Catalog. This file is a subset of the CERES Data Products Catalog found under the "Documentation" option at the following URL: http://asd-www.larc.nasa.gov/ceres/ASDceres.html The version of the CERES Data Products Catalog at this URL contains the latest information about the CERES products. It is possible for the SSF product structure to change over time, and thus future SSF pages may not correspond to this data set. A copy of the SSF pages corresponding to this data set have therefore been included with this package. 7. CRS_HDF_5rec_list_daacv3 This is an ASCII file containing a description of the data in the sample CRS file, CER_CRS_TRMM-PFM-VIRS_SampleReadFile_999999.1998050100 8. CER_CRS_TRMM-PFM-VIRS_SampleReadFile_999999.1998050100 This is a sample CRS file containing one header record and five FOV data records. This sample file is used by the examples in Program CRS_readhdf_daacv3.c 9. CER_CRS_TRMM-PFM-VIRS_SampleReadFile_999999.1998050100.met This is the metadata file corresponding to the sample data file listed in Item 8. An ASCII metadata file is delivered with every data granule. The file is written in Object Descriptive Language (ODL) and contains information that is associated with the origin, content, quality, and condition of the data granule. The metadata information contained in the granule metadata file is also included as metadata on the CRS HDF data file. An example of a metadata parameter found in both the metadata file and the CRS HDF file is LOCALGRANULEID, which has a value set to the original granule file name. 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/ 3.3 HDF library / NetCDF HDF information, documentation, tutorials, libraries, etc. can be found on-line at the URL http://hdf.ncsa.uiuc.edu The utility hdp, provided in the HDF libraries, extracts information regarding the HDF file contents, such as the size, type, order, names, and the data itself. Some examples are: hdp -H - provides "help" on how to use the "hdp" utility hdp dumpvd - lists the options and format for viewing Vdatas hdp dumpsds - lists the options and format for viewing SDSs hdp dumpsds [-options] hdp dumpvd [-options] 3.4 Data Format The CRS data are written as a collection of HDF SDSs. As a convenience to users implementing tools such as HDF viewers, the CRS SDSs are organized into HDF Vgroups. 3.5 Breakdown of the File Naming Convention The CRS data granules adhere to the following CERES file naming convention: CER_PID_SS_PS_CC.DataDate where: CER = the CERES experiment PID = the CERES product, e.g., CRS SS = the CERES sampling strategy, e.g., TRMM-PFM-VIRS, as defined by the CERES experiment. For the CRS, this indicates the satellite and instruments that were the source of the input data into the software system that produced the CRS data. PS = the CERES production strategy, e.g., 'Beta1', as defined by the CERES experiment. 'BetaN' production strategies usually indicate versions of the product produced with algorithms that are still being validated, and therefore have a restricted distribution. 'EditionN' production strategies usually indicate products that are available to the entire scientific community. CC = the product configuration code, e.g., '010013', assigned by the CERES experiment. This code is internal to the CERES project, and is updated whenever the software system producing the product is modified for any reason. For a complete history of the changes to the software, see the product Description/Abstract document available from the URL http://eosweb.larc.nasa.gov/PRODOCS/ceres/table_ceres.html DataDate = the date of the data included in the file. For the CRS, this date is in the format YYYYMMDDHH where: YYYY = the four-digit data year, MM = the two-digit month, DD = the two-digit day, HH = the two-digit hour (value = 00 to 23) 4.0 Science Parameters Information See the SSF and CRS CERES Data Products Catalog pages included with this package (listed under Section 3.1) for the following information for each science parameter: Name Units Type (integer, real, character, etc...) Ranges (minimum and maximum values) Fill values / bad data flags 5.0 Description of Sample Read Software The sample read software in this package is intended only as an example. As the number of SDSs that make up the CRS product is large and the number of data records contained on an actual CRS file is large, the sample software only demonstrates reading a limited number of SDSs for the number of data records included in the sample data file. The number of data records is obtainable from the CRS header record. The contents of the CRS header record, along with a list of all the SDSs contained on the CRS product, are described in the Data Products Catalog pages discussed in Section 3.1. 6.0 Implementing Sample Read Software 6.1 Compiling the Sample Read Software 1. Download and install the HDF libraries from the NCSA web site http://hdf.ncsa.uiuc.edu This code uses version HDF4.1r3. Other versions of the HDF libraries may not work with this code. NCSA uses the gnu gzip compression utility for some packages. If necessary, the software needed to uncompress the file can be obtained from one of the Gnu mirror sites listed at the URL http://www.gnu.org/order/ftp.html 2. Edit the sample script 'compile_CRS_readhdf_daacv3' to link the HDF libraries and compile the C programs. Check the permissions on this file to make sure execute permission is set for the owner by typing at the command line (denoted by ">"): > ls -l compile_CRS_readhdf_daacv3 A line similar to the following will be displayed: -rwxr--r-- 1 OWNER GROUP 1450 Mar 6 14:49 compile_CRS_readhdf_daacv3 where OWNER and GROUP are the file owner and group information. The owner executable permission is the x in -rwxr--r--. To set the proper permissions, at the command line type: > chmod 744 compile_CRS_readhdf_daacv3 3. Execute the script 'compile_CRS_readhdf_daacv3' to create the executable crs_rd by typing at the command line: > source compile_CRS_readhdf_daacv3 or, on some systems, type: > compile_CRS_readhdf_daacv3 6.2 How to Run the Sample Read Software Execute crs_rd by typing at the command line: > crs_rd 7.0 Sample Output The following is the screen output generated from executing the crs_rd program with the provided sample file. > crs_rd ********************************************************* * CRS Read Software * * * * Version: 1.0 * * * * Date: August 23, 2001 * * * * Contact: 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 * * FAX: (757)864-8807 * * * ********************************************************* Name of HDF file to be read: < CER_CRS_TRMM-PFM-VIRS_SampleReadFile_999999.1998050100 ********************************************************* * Example 1: * ********************************************************* Footprint 1 Longwave flux - downward - clear(1) = 0.000000 Longwave flux - downward - clear(2) = 9.697132 Longwave flux - downward - clear(3) = 29.181387 Longwave flux - downward - clear(4) = 156.423355 Longwave flux - downward - clear(5) = 386.572510 Footprint 2 Longwave flux - downward - clear(1) = 0.000000 Longwave flux - downward - clear(2) = 9.697132 Longwave flux - downward - clear(3) = 29.181396 Longwave flux - downward - clear(4) = 156.289474 Longwave flux - downward - clear(5) = 386.568390 Footprint 3 Longwave flux - downward - clear(1) = 0.000000 Longwave flux - downward - clear(2) = 9.697132 Longwave flux - downward - clear(3) = 29.181393 Longwave flux - downward - clear(4) = 156.318619 Longwave flux - downward - clear(5) = 386.568207 Footprint 4 Longwave flux - downward - clear(1) = 0.000000 Longwave flux - downward - clear(2) = 9.697132 Longwave flux - downward - clear(3) = 29.181400 Longwave flux - downward - clear(4) = 156.275696 Longwave flux - downward - clear(5) = 386.567230 Footprint 5 Longwave flux - downward - clear(1) = 0.000000 Longwave flux - downward - clear(2) = 9.697132 Longwave flux - downward - clear(3) = 29.181396 Longwave flux - downward - clear(4) = 156.340256 Longwave flux - downward - clear(5) = 386.568451 ********************************************************* * Example 2: * ********************************************************* Footprint 1 Skin temperature - initial = 299.431183 Footprint 2 Skin temperature - initial = 299.431183 Footprint 3 Skin temperature - initial = 299.431183 Footprint 4 Skin temperature - initial = 299.431183 Footprint 5 Skin temperature - initial = 299.431183 ********************************************************* * Example 3: * ********************************************************* DATA_DATE = 1998-05-01T00:00:00.000000Z ********************************************************* * Example 4: * ********************************************************* Numberoffootprints = 5 8.0 Additional Information Regarding the CERES CRS Data Sets. None. Updated: March 04, 2003 (ASDC) April 13, 2012 (change User Services email) -----------------------------------------------------------------------