#-----------------------------------------------------------------------------
# file:  TEST_DRIVER.README
#
# description:
#      README file for MET test drivers and TD test drivers for the 
#      stand-alone time tools for the TOOLKIT_MTD on win98 and NT.
#
#      These test programs are provided to aid the user in the development of
#      software using the TOOLKIT_MTD. The user may run the same test cases as
#      included in this directory to verify that the TOOLKIT_MTD is functioning
#      correctly. These programs were written to support the internal test
#      of the TOOLKIT_MTD and are delivered without guarantee of any kind.
#      No support will be provided to the user of these programs. This 
#      directory contains source code for a driver in C and FORTRAN for each 
#      tool, makefiles for the tool group, readme files explaining how to use 
#      the drivers, sample input files and sample output files.
#
# author:
#       Corey Boettcher / Applied Research Corporation
#       Abe Taaheri / Emergent Information Technologies, Inc.
#       S. Zeng   Raytheon STX
#       Phuong Nguyen / L3 Communication Corp.
# history:
#       27-Jul-1995 CMB Initial version
#       1-Jun-1998 AT revised for TOOLKIT_MTD
#       01-May-1996 LVM Updated for TK5.1
#       1-Jun-1998 AT revised for TOOLKIT_MTD
#       Sep-1998   S. Zeng for Win95 
#       Oct-1999   S. Zeng for win98
#       Apr-2000   AT/PN for pgstk5.2.6/HDF41r3
#       Jan-2001   AT revised for HDF5
#	Oct-2002   PN for pgstk5.2.8/HDF41r5/HDF5
#       Mar-2005   PN for pgstk5.2.13/HDF4.2r0/HDF5-1.6.3
#-----------------------------------------------------------------------------

Set up the environment:
=========================

1. Set up environment variable "PGSHOME"
   Open autoexe.bat file and add 1 line at the end of line

       Set PGSHOME=<top-level PGSTK directory>\TOOLKIT_MTD

       where <top-level PGSTK directory> may be C:\PGSTKHOME 

2. Under Tools->Options, select "Directories":
   Under "Show directories for", select "Include files".
   
   No Fortran support:
      Add the following directories:

                C:\Program Files\ArrayVisualizer\INCLUDE		
                C:\Program Files\Microsoft Visual Studio\VC98\INCLUDE
                C:\Program Files\Microsoft Visual Studio\VC98\MFC\INCLUDE
                <top-level HDF4 directory>\INCLUDE
                <top-level HDF5 directory>\hdf5lib\release\include
		<top-level jpeg>\include
		<top-level zlib>\include
		<top-level szip>\include
                <top-level PGSTK directory>\TOOLKIT_MTD\include 
                <top-level PGSTK directory>\TOOLKIT_MTD\include\CUC 
                <top-level PGSTK directory>\dev
   
   With Fortran support:
       Add the following directories:

                C:\Program Files\ArrayVisualizer\INCLUDE
                C:\Program Files\Microsoft Visual Studio\DF98\IMSL\INCLUDE
                C:\Program Files\Microsoft Visual Studio\VC98\INCLUDE
                C:\Program Files\Microsoft Visual Studio\DF98\INCLUDE
                C:\Program Files\Microsoft Visual Studio\VC98\MFC\INCLUDE
                <top-level HDF4 directory>\INCLUDE
                <top-level HDF5 directory>\hdf5lib\release\include
		<top-level jpeg>\include
		<top-level zlib>\include
		<top-level szip>\include
                <top-level PGSTK directory>\TOOLKIT_MTD\include 
                <top-level PGSTK directory>\TOOLKIT_MTD\include\CUC 
                <top-level PGSTK directory>\dev

3. Under "Show directories for", select "Library files":
   Add the following directories:

   No Fortran support: 
       Add the following directories:

                C:\Program Files\ArrayVisualizer\LIB
                C:\Program Files\Microsoft Visual Studio\VC98\LIB
                C:\Program Files\Microsoft Visual Studio\VC98\MFC\LIB
                <top-level HDF4 directory>\lib
                <top-level HDF4 directory>\dlllib
                <top-level HDF5 directory>\hdf5lib\release\lib
		<top-level jpeg>\lib
	        <top-level zlib>\lib
	        <top-level szip>\lib
                <top-level PGSTK directory>\dev\PGSTK\Release
	        <top-level PGSTK directory>\TOOLKIT_MTD\lib\nt_98
   
   With Fortran support:
       Add the following directories:

              C:\Program Files\ArrayVisualizer\LIB
              C:\Program Files\Microsoft Visual Studio\VC98\LIB
              C:\Program Files\Microsoft Visual Studio\VC98\MFC\LIB
              C:\Program Files\Microsoft Visual Studio\DF98\LIB
              C:\Program Files\Microsoft Visual Studio\DF98\IMSL\LIB
              <top-level HDF4 directory>\lib
              <top-level HDF4 directory>\dlllib
	      <top-level HDF5 directory>\hdf5lib\release\lib
	      <top-level jpeg>\lib
	      <top-level zlib>\lib
	      <top-level szip>\lib
              <top-level PGSTK directory>\dev\PGSTK\Release
	      <top-level PGSTK directory>\TOOLKIT_MTD\lib\nt_98

    where <top-level PGSTK directory> may be C:\PGSTKHOME 
	  <top-level HDF4 directory> may be C:\HDF4.2r0
	  <top-level HDF5 directory> may be C:\hdf5
	  <top-level zlib> may be C:\Zlib-1.1.3

4. Under Project->Settings, select "Link":
   Add the following libraries to the beginning of the list of
   Object/Library Modules:
  
       For files under test_MET: ws2_32.lib pgstk.lib hd420.lib hm420.lib hdf5.lib
				 libjpeg.lib zlib.lib szlib.lib
       For files under test_TIME: ws2_32.lib pgstk.lib

5. Under Project->Settings, select "C/C++":
   For the "Preprocessor Definitions" add:  INTEL86, VISUAL_CPLUSPLUS
   
6. To compile and make executable for fortran testdrivers one needs the 
   following also:

   Under Project-> Add to project-> File:
   select the file
   <top-level PGSTK directory>\TOOLKIT_MTD\test\Common\Create_filename_f77.f
   or
   <top-level PGSTK directory>\TOOLKIT_MTD\test\Common\Create_filename_f90.f

    where <top-level PGSTK directory> may be C:\PGSTKHOME

7. To compile select Build->Compile, and to make executable select BUILD ~.exe


NOTE:
=========

Please refer to C:<top level PGSTK directory>\TOOLKIT_MTD\test\test_TIME
and C:<top level PGSTK directory>\TOOLKIT_MTD\test\test_MET readme files for
more information on test drivers.

Please also note that when editing the filetable.temp in <top level PGSTK 
directory>\TOOLKIT_MTD\test\test_TIME or 
<top level PGSTK directory>\TOOLKIT_MTD\test\test_MET directories for 
setting the path of the files one should use "\", instead of "/", in the 
directory structurefor NT/98 applications such as:

10100|LogStatus|C:\PGSTKHOME\TOOLKIT_MTD\runtime\LogStatus
