SRB HDF Read Program The programs rdsrbhdf.c and rdsrbhdf.f (C and FORTRAN Versions) allow the user to dump data and associated metadata to an ASCII file for a given data month and year for either the SRB Daily or SRB Monthly data files. These selections will restrict the data to one of the SRB HDF granules (files). You can further subset the data selection by choosing a geographic region to dump. This can be done by selecting a range of cells based on the equal-area grid (1-6596). Cell Number 1 starts at the South Pole. Future versions will allow for subsetting by latitude and longitude ranges. A menu of available parameters allows for the selection of particular data measurements (e.g., ERBE TOA Shortwave Net, ISCCP Surface Pressure, etc.) Further information on the SRB products can be found in the readme files associated with each month of data. The program builds the name of the HDF data file as you make the above selections for date and file type (daily or monthly). The names of the files are as follows: srb_monavgs_yymm* SRB Monthly Averages Data srb_dayavgs_yymm* SRB Daily Averages Data * yymm - The year and month that the data was acquired. (e.g., 8504) The program also builds an output file: HDF_filename.rpt In order to run the read software, you will need to obtain the HDF libraries which are available in the public domain from the National Center for Supercomputing Applications (NCSA) via ftp (ftp.ncsa.uiuc.edu or 128.174.20.50). Further information on obtaining the HDF libraries can be found in the Langley DAAC Handbook, February 1993. Once the HDF libraries have been installed on your machine, the programs can be compiled as follows: ************************************************************************** UNIX Example for Compiling the Read Programs C : cc -Dmachineid -I/"path to HDF include files" rdsrbhdf.c /"path to HDF library" -o "executable name" Example : cc -DSUN -I/home/HDF/include rdsrbhdf.c /home/HDF/lib/libdf.a -o rdsrbhdf FORTRAN : f77 rdsrbhdf.f /"path to HDF library" -o "executable name" Example : f77 rdsrbhdf.f /home/HDF/lib/libdf.a -o rdsrbhdf ** Please note the cc and f77 are the SUN C and FORTRAN compilation commands. These may be different on your machine. **************************************************************************** Included below is a sample run and output of the SRB HDF read program. The sample run only shows output from a monthly averages file. Parameters for the daily averages file are different. Comments or questions should be directed to: Langley DAAC User and Data Services Mail Stop 157B NASA Langley Research Center Hampton, Virginia 23681-0001 TEL: (804) 864-8656 FAX: (804) 864-8807 INTERNET: userserv@eosdis.larc.nasa.gov or userserv@192.107.191.17 ********************************************************************** SAMPLE RUN ********************************************************************** stxsun00!: rdsrbhdf This program reads SRB Daily and Monthly HDF files. The input file name is built according to naming conventions formed at the Langley DAAC. If you have changed the file name or need to specify a path, you need to modify this program. Please enter Q to Quit or C to continue c Enter data date of SRB data to read (yymm) 8510 Enter type of SRB data to read(D-Daily, M-Monthly) m Input file is srb_monavgs_8510 Output file is srb_monavgs_8510.rpt Enter whether you would like to further subset based on cell number (C) or no subsetting (N) c Enter beginning and end cell number (1-6596) separated by a space 500 600 Item Number Label 1 CELL NUMBER 2 ISCCP LAT INDEX 3 ISCCP LON INDEX 4 LAT OF CELL CENTER 5 LON OF CELL CENTER 6 ISCCP SURFACE TYPE 7 ISCCP SATELLITE 8 # GROUND TRUTH SITES 9 # FILL DAYS, STAYLOR 10 SNOW/ICE, STAYLOR 11 # ISCCP ALL-SKY PIXS 12 # ISCCP CLD-SKY PIXS 13 DAYLIGHT CLOUD FRAC 14 ISCCP CLD-PIX TAU 15 ISCCP SRF PRESSURE 16 ISCCP SRF TMP (TOVS) 17 ISCCP SRFTMP CLD IMG 18 ISCCP PRECIP. WATER 19 ISCCP OZONE 20 ISCCP CLRSKY TOA RFL 21 ERBE TOA SW NET 22 ERBE CLR TOA SW NET 23 PINK DWN SW SRF 24 STAY DWN SW SRF 25 GEBA DWN SW SRF 26 PINK SRF PRESSURE Please choose the numbers of the data items to dump separated by a space. Enter -1 to continue to the next list or 0 to quit entering parameters 15 21 -1 Item Number Label 27 STAY SRF PRESSURE 28 PINK TOA DWN SW 29 STAY TOA DWN SW 30 PINK DIRECT/DIFFUSE 31 PINK CLR DWN SW SRF 32 STAY CLR DWN SW SRF 33 PINK SRF CLD FORCING 34 STAY SRF CLD FORCING 35 PINK SW SRF ALBEDO 36 STAY SW SRF ALBEDO 37 PINK SRF SW NET 38 STAY SRF SW NET 39 PINK TOA SW NET 40 PINK CLR TOA SW NET 41 PINK ATM SW ABSORBED 42 P-S DWN SW SRF 43 G-P DWN SW SRF 44 G-S DWN SW SRF 45 P-S CLR DWN SW SRF 46 P-S SRF CLD FORCING 47 P-S SW SRF ALBEDO 48 P-S SRF SW NET 49 P-E TOA SW NET 50 P-E CLR TOA SW NET 51 DATA DATE, MMYY 52 PROCESS DATE, DDMMYY Please choose the numbers of the data items to dump separated by a space. Enter -1 to continue to the next list or 0 to quit entering parameters 42 0 Getting data, Please wait ... stxsun00!: ********************************************************************** SAMPLE OUTPUT ********************************************************************** stxsun00!: cat srb_monavgs_8510.rpt File ID: WCRP/SRB MONTHLY SHORTWAVE DATA PACKAGE FOR OCTOBER 1985 Dimensions are 6596 by 1 Data attributes are as follows: Label : ISCCP SURFACE PRESSURE (LINEAR AVERAGE OF DAYLIGHT VALUES FOR ISCCP PARAMETER 11 4 OVER THE MONTH) Units : mb Format : F10.4 Missing value: MISSING DATA = -1000.000 Data max: 1050.000000 Data min: 500.000000 Data values for cells 500 to 600 are as follows: 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 998.2258 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 1000.0000 Dimensions are 6596 by 1 Data attributes are as follows: Label : ERBE ALL-SKY, TOP-OF-ATMOSPHERE SHORTWAVE NET IRRADIANCE Units : W/m^2 Format : F10.4 Missing value: MISSING DATA = -1000.000 Data max: 500.000000 Data min: 0.000000 Data values for cells 500 to 600 are as follows: 180.7471 176.0233 182.1471 190.0081 190.8500 190.6254 184.4683 184.8727 177.6379 165.3674 153.9237 147.3981 148.2838 142.7937 132.0677 119.0250 111.0277 138.5278 137.2067 131.7900 130.3556 133.2867 148.8078 158.9922 164.7522 169.7067 175.2133 183.3622 186.0111 186.0278 191.8689 187.8967 187.2856 192.5233 194.0578 192.6245 195.8533 198.5767 207.7623 204.7111 199.5045 204.1678 199.0500 195.6922 198.6589 190.0267 188.1944 188.8200 184.4700 189.1245 180.9900 186.3844 192.0311 187.1211 178.9722 185.2289 189.3856 191.1356 193.3011 194.1522 198.8633 201.7922 198.5967 198.2167 195.9589 191.4644 189.3189 187.4056 191.5567 192.2133 188.3900 186.8622 193.1067 194.5644 192.0300 199.0322 201.7111 201.9000 201.8311 196.8589 194.0522 196.9855 206.8400 197.1234 196.6111 203.0600 201.9322 197.0944 188.1200 184.0656 179.7000 174.9200 171.5067 170.8544 166.9567 160.6645 145.1400 176.7922 182.9567 181.5941 176.1992 Dimensions are 6596 by 1 Data attributes are as follows: Label : PINKER MINUS STAYLOR ALL-SKY DOWNWARD SHORTWAVE SURFACE IRRADIANCE (SRB ITEM 23 - SRB ITEM 24) Units : W/m^2 Format : F10.4 Missing value: MISSING DATA = -1000.000 Data max: 75.000000 Data min: -75.000000 Data values for cells 500 to 600 are as follows: 5.1334 5.9216 1.2475 1.5306 7.7090 4.6371 6.6963 4.1168 9.9608 6.7733 5.8105 25.7679 26.9237 -0.8217 -7.7288 1.2508 10.2924 -0.5222 -0.9872 9.7719 1.9778 7.3613 6.6751 26.1592 8.7510 13.1775 11.4714 -1.8865 2.4383 1.8628 5.0612 13.8866 6.9319 11.3411 6.8392 7.2067 -5.6376 -0.4619 -8.1075 -5.0324 -0.8794 8.9097 5.2032 6.2320 6.6865 4.1150 2.2199 0.3215 0.7067 2.9276 1.1692 -1.4360 -4.2454 -3.0042 -4.4763 -3.5494 1.0578 -3.4948 -4.7636 -4.8369 -6.7545 9.6416 5.7418 11.3540 2.7362 2.7381 4.3167 -0.3990 7.1647 3.6296 5.2477 8.0839 8.1762 9.0265 7.5899 7.6171 1.8913 3.2813 3.6900 3.7961 3.5279 5.8808 2.3414 3.2011 -3.1331 2.8683 0.4254 -4.6299 1.4694 13.6941 11.2875 28.4025 22.3891 9.4706 5.2504 10.2538 10.4603 24.3679 17.2336 15.6423 7.8918 stxsun00!: