README.GPM_VN_DPR_geo_match_test_data.txt -- Version 1.1, September 2014
------------------------------------------------------------------------

Below is a list of files and directory structures archived in the file
GPM_VN_geo_match_test_data.tar, which contains a complete set of data 
files needed to run the PR-GR geometry-matching procedure POLAR2DPR, 
and a pair of sample output netCDF files:

/control_files/DPR_files_sites4geoMatch.140603.txt
/control_files/multi_event_contol_file_example.txt

/GPM/Ku/2AKu/V03B/CONUS/2014/06/03/2A-CS-CONUS.GPM.Ku.V5-20140829.20140603-
S195546-E200412.001496.V03B.HDF5
/ground_radar/KDOX/1CUF/2014/0603/KDOX_2014_0603_195905.uf.gz
/ground_radar/KTYX/1CUF/2014/0603/KTYX_2014_0603_200004.uf.gz
/test_output/GRtoDPR.KDOX.140603.1496.V03B.KU.NS.1_1.nc.gz
/test_output/GRtoDPR.KTYX.140603.1496.V03B.KU.NS.1_1.nc.gz
Upon restoration (un-tar'ring) of GPM_VN_geo_match_test_data.tar, the following
five subdirectory trees will be created under the working directory where the 
tar file is located:

control_files/
GPM/Ku/2AKu/V03B/CONUS/2014/06/03/
ground_radar/KDOX/1CUF/2014/0603/
ground_radar/KTYX/1CUF/2014/0603/
test_output/

2A-Ka, 2A-Ku, 2A-DPR, and 2B-DPRGMI data file types are stored in a common top-
level directory (/GPM in the case of supplied test data) under subdirectory 
pairs indicating the instrument type and product level within the operational 
GPM Validation Network (VN) database.  Each holds GPM DPR data files of the type
indicated by the file and directory names (e.g., GPM 2A-Ku products in Ku/2AKu 
directories).  These four subdirectory pairs have their default values (IDL 
variables DIR_2AKA, DIR_2AKU, DIR_2ADPR, and DIR_COMB, respectively) defined in 
the IDL source code file vn_include/environs.inc (see code file listings in 
README.GPM_VN_DPR_geo_match_v1_0.txt).  Their values may be overridden at run 
time by specifying values for four optional keyword parameters (DIRKA,  DIRKU, 
DIRDPR, and DIRCOMB, respectively) for the POLAR2DPR IDL procedure, in cases 
where these products are stored in a different subdirectory tree structure on 
the local host.  It is assumed that the subdirectories Ka/2AKa, Ku/2AKu, 
DPR/2ADPR, and DPRGMI/2BDPRGMI are located under a common root directory 
(/data/gpmgv/orbit_subset/GPM in the VN database system).  This default 
directory is defined by the variable GPMDATA_ROOT in the environs.inc, and may 
be overridden by specifying a value for the GPM_ROOT keyword parameter for the 
POLAR2DPR procedure, or by modifying the GPMDATA_ROOT definition in the 
environs.inc file.  

The ground radar data files in Universal Format (UF) are stored in a directory
tree of the structure: station/filetype/year/monthday in the tar file and in
the operation VN database.  Individual directory trees for each ground radar
site are stored under a common root directory (/data/gv_radar/finalQC_in) in
the VN database system).  This default directory is defined by the variable 
GVDATA_ROOT in the environs.inc, and may be overridden by specifying a keyword 
parameter for the POLAR2DPR procedure, or by modifying the GVDATA_ROOT definition
in the environs.inc file.  For example, the full filepath specification for one
of the ground radar test data files provided is:

/data/gpmgv/gv_radar/finalQC_in/KDOX/1CUF/2014/0603/KDOX_2014_0603_195905.uf.gz

in the operational VN database.  Note that the site/type/date varying parts of
the directory tree (e.g., KDOX/1CUF/2014/0603/) must precede the name of the
GV radar data file (KDOX_2014_0603_195905.uf.gz in the example) within the
POLAR2DPR control files (e.g., DPR_files_sites4geoMatch.140603.txt in the test 
data set), whether or not the default lower-level directory structure is used.

The file DPR_files_sites4geoMatch.140603.txt is the input control file 
needed to run POLAR2DPR using the supplied data files of the test data set.
The full pathname to this control file must be specified as a parameter on the 
command line when running POLAR2DPR in IDL.

The compressed netCDF files GRtoDPR.KDOX.140603.1496.V03B.KU.NS.1_1.nc.gz and
GRtoDPR.KTYX.140603.1496.V03B.KU.NS.1_1.nc.gz are the sample output files for 
the test data provided, where the value 100 was used for the POLAR2DPR 
parameter for maximum range in km, and the default value for MARK_EDGES 
(disabled) were used.

The file multi_event_contol_file_example.txt is not used with the test data, but
is provided as an template for how to set up a run of POLAR2DPR for multiple 
events and ground radar locations within a single control file.  See the 
instructions for configuring the control file and running POLAR2DPR in the file 
README_first_POLAR2DPR_v1_1.pdf.
