; Copyright © 2008, United States Government as represented by the
; Administrator for The National Aeronautics and Space Administration.
; All Rights Reserved.
;
; EMAIL QUESTIONS OR COMMENTS TO:
;       <Bob Morris> kenneth.r.morris@nasa.gov
;       <Matt Schwaller> mathew.r.schwaller@nasa.gov

README file to accompany software used in the Validation Network (VN) prototype 
of the Global Precipitation Measurement (GPM) Ground Validation (GV) system.
All included software is written in the commercial Interactive Data Language 
(IDL).  The software is organized into nine directories, by function.  These 
directories include:

common_utils/
comparerain/
comparez/
display/
getmetadata/
gridbyreorder/
gridgen/
stats_for_db/
vn_include/

Each directory contains a "README" file describing the purpose and use of the
code files contained in the directory, and a list of files in the directory.
The software is provided in a single unix 'tar' file, GPMGV_VN_IDL_CODE.tar, 
which contains the following code and documentation files:

common_utils/coordinate_b_to_a.pro
common_utils/distance_a_and_b.pro
common_utils/find_alt_filename.pro
common_utils/fmtdatetime.pro
common_utils/get_julday.pro
common_utils/get_time_from_sotd.pro
common_utils/gv_orbit_match.pro
common_utils/load_2b31.pro
common_utils/read_1c21_ppi.pro
common_utils/read_1c21.pro
common_utils/read_2a23_ppi.pro
common_utils/read_2a25_ppi.pro
common_utils/read_2a25.pro
common_utils/read_2a53.pro
common_utils/read_2a54.pro
common_utils/read_2a55.pro
common_utils/read_gv_netcdf.pro
common_utils/read_gv_reo_netcdf.pro
common_utils/read_pr_netcdf.pro
common_utils/remove_path.pro
common_utils/ridge_conus_ll2ij.pro
common_utils/testreadgvnetcdf.pro
common_utils/testreadgvreonetcdf.pro
common_utils/testreadprnetcdf.pro
common_utils/uncomp_file.pro
common_utils/unix2datetime.pro
common_utils/unixtime.pro
common_utils/README.common_utils.txt
comparerain/bias_rain_table.pro
comparerain/commonArea_rain.pro
comparerain/comparison_pr_gv_rain.pro
comparerain/doSiteSpecificRainComparisons.pro
comparerain/plot_histogram_rain.pro
comparerain/plot_scaPoint_rain.pro
comparerain/standardError_rain_table.pro
comparerain/statistics_rain_table.pro
comparerain/doSiteSpecificRainComparisons.bat
comparerain/README.comparerain.txt
comparez/bias.pro
comparez/bias_table.pro
comparez/commonArea.pro
comparez/comparison_PR_GV_dBZ.pro
comparez/doSiteSpecificComparisons.pro
comparez/mean_std.pro
comparez/plot_histogram.pro
comparez/plot_scaPoint.pro
comparez/standard_error.pro
comparez/standardError_table.pro
comparez/statistics_table.pro
comparez/doSiteSpecificComparisons.bat
comparez/README.comparez.txt
display/cwanimate_Match_w_stats.pro
display/dbz_stats_scatter_with_image_loop.pro
display/dbz_stats_scatter_with_image_loop_ps.pro
display/dbz_stats_with_image_loop.pro
display/get_pr_vs_gv_meandiffs.pro
display/GSN_REOfields2pswmap.pro
display/GVfields2pswmap3x1.pro
display/GVfields2pswmap.pro
display/GV_REOfields2pswmap.pro
display/pdf_cdf_by_site_dist_above_bb.pro
display/plot_event_series.pro
display/plot_event_series_ps.pro
display/README.display.txt
getmetadata/extract2a23meta.pro
getmetadata/extract2a25meta.pro
getmetadata/getMetadata2A23.pro
getmetadata/getMetadata2A25.pro
getmetadata/get2A23MetaIDL.bat
getmetadata/get2A25MetaIDL.bat
getmetadata/README.getmetadata.txt
gridbyreorder/mk_qreo_multi.pro
gridbyreorder/reorder_1cuf_multi.pro
gridbyreorder/reorderUF_multi.bat
gridbyreorder/README.gridbyreorder.txt
gridgen/generate_2a53_ncgrids.pro
gridgen/generate_2a54_ncgrids.pro
gridgen/generate_2a55_ncgrids.pro
gridgen/generate_pr_ncgrids.pro
gridgen/gen_gv_netcdf_template.pro
gridgen/gen_pr_netcdf_template.pro
gridgen/get_pr_and_gv_ncgrids.pro
gridgen/get_pr_and_gv_ncgrids.bat
gridgen/README.gridgen.txt
stats_for_db/printf_stat_struct21angle.pro
stats_for_db/printf_stat_struct21dist.pro
stats_for_db/printf_stat_struct21.pro
stats_for_db/printf_stat_struct7.pro
stats_for_db/stratified_by_angle_stats_to_dbfile.pro
stats_for_db/stratified_by_dist_stats_to_dbfile_55_or_reo.pro
stats_for_db/stratified_by_dist_stats_to_dbfile.pro
stats_for_db/stratified_by_sfc_stats_to_dbfile.pro
stats_for_db/stratified_stats_to_dbfile.pro
stats_for_db/stratify_diffs21angle.pro
stats_for_db/stratify_diffs21dist.pro
stats_for_db/stratify_diffs21.pro
stats_for_db/stratify_diffs.pro
stats_for_db/README.stats_for_db.txt
vn_include/bogus.pro
vn_include/environs.inc
vn_include/grid_def.inc
vn_include/grid_nc_structs.inc
vn_include/pr_params.inc
vn_include/README.vn_include.txt

NOTE:  This code makes use of the gzip utility, and so will only run on UNIX,
LINUX, MAC OS-X, and other operating systems which support both gzip and IDL.