ISCCP_TOVS_NAT Data Set Readme File 1.0 Introduction This file contains information about the International Satellite Cloud Climatology Project (ISCCP) TOVS native (NAT) data set. (ISCCP_TOVS_NAT) The data files are in native format. The home page for ISCCP is located at http://isccp.giss.nasa.gov/ This readme file includes the following sections: Section 2.0 - provides general information about the data set. Section 3.0 - describes the format of the data. Section 4.0 - provides the user with science parameter information Section 5.0 - describes the sample read software. Section 6.0 - discusses how to invoke the run-time executable. Section 7.0 - provides examples of actual runs of the sample read software. If users have question while using the ISCCP_TOVS_NAT sample read software, please contact the Langley Data Center User and Data Services office at: Langley Atmospheric Science Data Center Users and Data Services NASA Langley Research Center Mail Stop 157D 2 South Wright Street Hampton, VA 23681-2199 U.S.A. Email: support-asdc@earthdata.nasa.gov Phone: (757) 864-8656 FAX: (757) 864-8807 URL: http://eosweb.larc.nasa.gov 2.0 Data Set Description Documentation on the ISCCP_TOVS_NAT data set is contained within the DX/D1/D2 New Cloud Data Documentation which can be obtained from the following URL: http://isccp.giss.nasa.gov/documents.html Contact for scientific inquiries: Dr. William B. Rossow NASA Goddard Institute for Space Studies 2880 Broadway New York, NY 10025 email: clwbr@giss.nasa.gov Phone: 212-678-5567 FAX: 212-678-5662 Contact for technical assistance: Violeta Golea NASA Goddard Institute for Space Studies 2880 Broadway New York, NY 10025 email: vgolea@giss.nasa.gov 3.0 Format and Packaging Each file of ISCCP_TOVS_NAT data is a zipped file containing a years worth of ISCCP_TOVS_NAT data. To read the files, first unzip them with Info_Zip software. Information about downloading and using this freeware is available at the following URL: http://www.cdrom.com/pub/infozip/ (NOTE 1: 1983 covers July through December only, so there are fewer files!) The data files are named in the following manner: ISCCP.TOVS.V.GLOBAL.YYYY.zip where V is version and YYYY is year. ISCCP.TOVS.0.GLOBAL.2004.zip - TOVS DATA YEARLY zip file ISCCP.TVC.0.GLOBAL.9999.99.99.9999.GPC.zip - CLIMATOLOGY zip file ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC - ANCILLARY file isccp_tovs_read.f - FORTRAN Sample Read Software isccp_tovs_read.c - C Sample Read Software ISCCP.TOVS.0.GLOBAL.2004.zip contents: ISCCP.TVD.0.GLOBAL.2004.01.01.9999.GPC ISCCP.TVD.0.GLOBAL.2004.01.02.9999.GPC ISCCP.TVD.0.GLOBAL.2004.01.03.9999.GPC - TOVS DAILY data . . . ISCCP.TVD.0.GLOBAL.2004.12.30.9999.GPC ISCCP.TVD.0.GLOBAL.2004.12.31.9999.GPC ISCCP.TVM.0.GLOBAL.2004.01.99.9999.GPC ISCCP.TVM.0.GLOBAL.2004.02.99.9999.GPC - TOVS MONTHLY data ISCCP.TVM.0.GLOBAL.2004.03.99.9999.GPC . . . ISCCP.TVM.0.GLOBAL.2004.11.99.9999.GPC ISCCP.TVM.0.GLOBAL.2004.12.99.9999.GPC ************* ISCCP.TVC.0.GLOBAL.9999.99.99.9999.GPC.zip contents: ISCCP.TVC.0.GLOBAL.9999.01.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.02.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.03.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.04.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.05.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.06.99.9999.GPC - CLIMATOLOGY MONTHLY data ISCCP.TVC.0.GLOBAL.9999.07.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.08.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.09.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.10.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.11.99.9999.GPC ISCCP.TVC.0.GLOBAL.9999.12.99.9999.GPC 4.0 Science Parameters Information The ISCCP_TOVS_NAT data set contains information concerning the atmospheric temperature and humidity profiles and the ozone column abundance. This data set is composed of 3 types of data files, CLIM MONTHLY which contains the monthly climatological data obtained from balloon observations, TOVS MONTHLY which contains the monthly climatological data computed from the daily TOVS values, and TOVS DAILY which contains the daily composite of the TOVS Sounding Product. The data were collected on a global equal-area grid with the cell area equivalent to 2.5 deg. latitude/longitude at the equator. The grid begins at the South Pole with the intersection of the Greenwich meridian (0 deg. longitude) and the South Pole as a cell corner. For a description of this product and its specific parameters, the reader is referred to the document "International Satellite Cloud Climatology Project (ISCCP) Documentation of New Cloud Datasets" available from the URL http://isccp.giss.nasa.gov/documents.html. 5.0 Description of Sample Read Software The read program was developed in the "C" language from the Fortran sample read software provided the the data provider - NASA Goddard Institute for Space Studies (GISS). 6.0 Implementing Sample Read Software The sample read software has been tested on the "Sun4", UNIX, and a "SGI" based system. There are no library routines that need to be loaded or linked. 6.1 How to Compile and Run the C Sample Read Software To compile the sample read sofware at the command line type: cc -w -o read_tovs_c isccp_tovs_read.c To invoke the executable file, at the command line type: read_tovs_c 6.2 How to Compile and Run the FORTRAN Sample Read Software To compile the sample read sofware at the command line type: For the SGI unix machine do this: ln -s ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC fort.9 ln -s ISCCP.TVM.1.GLOBAL.1995.01.99.9999.GPC fort.10 f77 -o read_tovs_f -bytereclen isccp_tovs_read.f To invoke the executable file, at the command line type: read_tovs_f For the SUN unix machine do this: ln -s ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC fort.9 ln -s ISCCP.TVM.1.GLOBAL.1995.01.99.9999.GPC fort.10 f77 -o read_tovs_f isccp_tovs_read.f To invoke the executable file, at the command line type: read_tovs_f 7.0 Sample Runs ********************************************************************* * * * Langley DAAC * * PROJECT_LEVEL/DATA_SET_LEVEL READ SOFTWARE * * VERSION NUMBER: * * Language: C * * Platforms supported: SUN * * SGI * * Solaris 2.3 * * Contact: Atmospheric Science Data Centera * * Users and Data Services * * NASA Langley Research Center * * Mail Stop 157D * * 2 South Wright Street * * Hampton, VA 23681-2199 * * PHONE: (757)864-8656 FAX: (757)864-8807 * * * ********************************************************************* Enter 'c' to view the TOVS values for a specified latitude band. Enter 's' to view the ancillary data for a specified latitude band. Enter 'b' to view both sets of data for a specified latitude band. Enter 'h' to receive help with commands. Enter 'x' to exit or terminate processing. b This read software will process data files until you wish to stop. Press 'Y' or 'y' to continue or 'x' to stop. y Enter desired latitude band: (Value should be between 1 and 72. Latitude bands are in 2.5 degree increments beginning at the South Pole.) 36 Enter a name for the output file: tovs_out1 Enter filename for ancillary file: ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC Enter data file to be used: ISCCP.TVC.0.GLOBAL.9999.05.99.9999.GPC The number of full (not=255) boxes in data file ISCCP.TVC.0.GLOBAL.9999.05.99.9999.GPC: 6586 Do you wish to process another data file? n PROGRAM HAS ENDED ! 7.1 Output file - tovs_out1 ("C" Output for a Climatological file) Ancillary data file is ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC GRD LAT LON SQ1 SQ2 LAT LON BOX % TOPOG VEG b BOX IND IND IND IND CENTER CENTER AREA LAND HEIGHT TYPE b 3155 36 1 1 1 88.75 1.25 77257 0 0 0 3156 36 2 2 2 88.75 3.75 77257 0 0 0 3157 36 3 3 3 88.75 6.25 77257 0 0 0 3158 36 4 4 4 88.75 8.75 77257 37 0 0 3159 36 5 5 5 88.75 11.25 77257 100 243 1 3160 36 6 6 6 88.75 13.75 77257 100 487 1 . . . 3295 36 141 141 141 88.75 351.25 77257 0 0 0 3296 36 142 142 142 88.75 353.75 77257 0 0 0 3297 36 143 143 143 88.75 356.25 77257 0 0 0 3298 36 144 144 144 88.75 358.75 77257 0 0 0 The data file used is ISCCP.TVC.0.GLOBAL.9999.05.99.9999.GPC TV PREFIX INFORMATION: data type : 4 month: 5 *************************************************************************************************************************** *********** Processing equal-area lon/lat 1 36 CENTER: CENTER LON/LAT 1.25 -1.25 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36 1 4 255 255 255 255 255 255 255 variable 11- 20 | 0 146 201 12 21 97 33 21 12 5 variable 21- 30 | 133 116 101 86 65 38 14 20 27 123 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36.000 1.000 4.000 255.000 255.000 255.000 255.000 255.000 -1000.000 -1000 .000 variable 11- 20 | 0.000 299.200 1000.000 194.000 100.000 2.880 0.960 0.600 0.330 0.120 variable 21- 30 | 293.200 284.700 276.700 267.800 253.900 230.600 197.500 208.000 217.900 244.0 00 ********************************************************************** . . . 7.2 "FORTRAN" Output for a Climatological file. Input: ln -s ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC fort.9 ls -s ISCCP.TVC.0.GLOBAL.9999.05.99.9999.GPC fort.10 FILE SUCCESSFULLY OPENED TV PREFIX INFORMATION:DATA TYPE 4 YEAR 0 MONTH 5 DAY 0 TVPHYS: LAT BAND 1 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 2 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 3 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 4 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 5 CONVERTED TO PHYSICAL VALUES . . . TVPHYS: LAT BAND 35 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 36 CONVERTED TO PHYSICAL VALUES **************************************************************************************************** PROCESSING EQUAL-AREA LON/LAT 1 36 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36 1 4 255 255 255 255 255 255 255 VARIABLE (011-020) 0 146 201 12 21 97 33 21 12 5 VARIABLE (021-030) 133 116 101 86 65 38 14 20 27 123 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36.00 1.00 4.00 255.00 255.00 255.00 255.00 255.00-1000.00-1000.00 VARIABLE (011-020) 0.00 299.20 1000.00 194.00 100.00 2.88 0.96 0.60 0.33 0.12 VARIABLE (021-030) 293.20 284.70 276.70 267.80 253.90 230.60 197.50 208.00 217.90 244.00 **************************************************************************************************** . . . 7.3 "C" Output for a Monthly file. Inputs: ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC ISCCP.TVM.1.GLOBAL.1995.01.99.9999.GPC Ancillary data file is ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC The data file used is ISCCP.TVM.1.GLOBAL.1995.01.99.9999.GPC TV PREFIX INFORMATION: data type : 3 month: 1 *************************************************************************************************************************** *********** Processing equal-area lon/lat 1 36 CENTER: CENTER LON/LAT 1.25 -1.25 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36 1 3 255 255 255 255 255 48 99 variable 11- 20 | 255 149 201 11 20 85 34 21 11 5 variable 21- 30 | 136 116 101 84 63 36 17 18 31 132 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36.000 1.000 3.000 255.000 255.000 255.000 255.000 255.000 235.000 0.990 variable 11- 20 | 255.000 300.500 1000.000 192.000 95.000 2.520 0.990 0.600 0.300 0.120 variable 21- 30 | 294.600 284.700 276.700 266.600 252.400 228.600 202.700 204.500 223.100 262.0 00 ***************************************************************************** ********************************************** *********** . . . 7.4 "FORTRAN" Output for a Monthly file. Inputs: ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC fort.9 ISCCP.TVM.1.GLOBAL.1995.01.99.9999.GPC fort.10 FILE SUCCESSFULLY OPENED TV PREFIX INFORMATION:DATA TYPE 3 YEAR 95 MONTH 1 DAY 0 TVPHYS: LAT BAND 1 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 2 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 3 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 4 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 5 CONVERTED TO PHYSICAL VALUES . . . TVPHYS: LAT BAND 35 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 36 CONVERTED TO PHYSICAL VALUES **************************************************************************************************** PROCESSING EQUAL-AREA LON/LAT 1 36 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36 1 3 255 255 255 255 255 48 99 VARIABLE (011-020) 255 149 201 11 20 85 34 21 11 5 VARIABLE (021-030) 136 116 101 84 63 36 17 18 31 132 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36.00 1.00 3.00 255.00 255.00 255.00 255.00 255.00 235.00 0.99 VARIABLE (011-020) 255.00 300.50 1000.00 192.00 95.00 2.52 0.99 0.60 0.30 0.12 VARIABLE (021-030) 294.60 284.70 276.70 266.60 252.40 228.60 202.70 204.50 223.10 262.00 **************************************************************************************************** . . . 7.5 "C" Output for a Daily data file Inputs: ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC ISCCP.TVD.1.GLOBAL.1995.01.01.9999.GPC Ancillary data file is ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC GRD LAT LON SQ1 SQ2 LAT LON BOX % TOPOG VEG b BOX IND IND IND IND CENTER CENTER AREA LAND HEIGHT TYPE b 3155 36 1 1 1 88.75 1.25 77257 0 0 0 3156 36 2 2 2 88.75 3.75 77257 0 0 0 3157 36 3 3 3 88.75 6.25 77257 0 0 0 3158 36 4 4 4 88.75 8.75 77257 37 0 0 3159 36 5 5 5 88.75 11.25 77257 100 243 1 . . . 3295 36 141 141 141 88.75 351.25 77257 0 0 0 3296 36 142 142 142 88.75 353.75 77257 0 0 0 3297 36 143 143 143 88.75 356.25 77257 0 0 0 3298 36 144 144 144 88.75 358.75 77257 0 0 0 The data file used is ISCCP.TVD.1.GLOBAL.1995.01.01.9999.GPC TV PREFIX INFORMATION: data type: 1 year: 95 month: 1 day: 1 *************************************************************************************************************************** *********** Processing equal-area lon/lat 1 36 CENTER: CENTER LON/LAT 1.25 -1.25 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36 1 1 36 1 7 25 34 41 100 variable 11- 20 | 0 149 201 11 20 77 30 19 12 6 variable 21- 30 | 135 114 100 84 63 37 17 19 32 134 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 variable 1- 10 | 36.000 1.000 1.000 36.000 1.000 7.000 25.000 34.000 200.000 1.000 variable 11- 20 | 0.000 300.500 1000.000 192.000 95.000 2.280 0.870 0.540 0.330 0.150 variable 21- 30 | 294.100 283.700 276.100 266.600 252.400 229.600 202.700 206.200 224.400 266.0 00 *************************************************************************************************************************** *********** . . . 7.6 "FORTRAN" Output for a Daily data file Inputs: ISCCP.TVGRID.0.GLOBAL.9999.99.99.9999.GPC fort.9 ISCCP.TVD.1.GLOBAL.1995.01.01.9999.GPC fort.10 FILE SUCCESSFULLY OPENED TV PREFIX INFORMATION:DATA TYPE 1 YEAR 95 MONTH 1 DAY 1 TVPHYS: LAT BAND 1 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 2 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 3 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 4 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 5 CONVERTED TO PHYSICAL VALUES . . . TVPHYS: LAT BAND 35 CONVERTED TO PHYSICAL VALUES TVPHYS: LAT BAND 36 CONVERTED TO PHYSICAL VALUES **************************************************************************************************** PROCESSING EQUAL-AREA LON/LAT 1 36 PRINTI: COUNT VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36 1 1 36 1 7 25 34 41 100 VARIABLE (011-020) 0 149 201 11 20 77 30 19 12 6 VARIABLE (021-030) 135 114 100 84 63 37 17 19 32 134 PRINTR: PHYSICAL VALUES FOR ALL VARIABLES 1 2 3 4 5 6 7 8 9 10 VARIABLE (001-010) 36.00 1.00 1.00 36.00 1.00 7.00 25.00 34.00 200.00 1.00 VARIABLE (011-020) 0.00 300.50 1000.00 192.00 95.00 2.28 0.87 0.54 0.33 0.15 VARIABLE (021-030) 294.10 283.70 276.10 266.60 252.40 229.60 202.70 206.20 224.40 266.00 **************************************************************************************************** . . . Last Updated: August 17, 2005 April 30, 2009