summer 2011 version

(1) separated boundary condition handling to a new module; (2) added
global water balance computation; (3) added support for 1D model; (4)
general re-factoring and code clean-up; (5) added two test examples.

Author: bradleyjeck

README.md

@@ -23,35 +23,41 @@ Further details on the development, validation, and application of Perfcode are
 available in the following references. Please cite these references when using
 Perfcode.  
 
+BJ Eck, ME Barrett, RJ Charbeneau (2012)
 [Coupled Surface-Subsurface Model for Simulating Drainage
  from Permeable Friction Course Highways]
 (http://ascelibrary.org/doi/abs/10.1061/%28ASCE%29HY.1943-7900.0000474)
-
-BJ Eck, ME Barrett, RJ Charbeneau
-
 Journal of Hydraulic Engineering 138 (1), 13-22
 
+BJ Eck, RJ Charbeneau, ME Barrett (2010)
 [Drainage hydraulics of porous pavement: Coupling surface and subsurface flow]
 (http://www.crwr.utexas.edu/reports/2010/rpt10-2.shtml)
-
-BJ Eck, RJ Charbeneau, ME Barrett
-
 Center for Research in Water Resources, University of Texas at Austin
 
 A video showing results of a Perfcode simulation is also available at http://bradeck.net/pfc-video/index.htm 
 
+## Quick Start for Windows
+The easiest way to become familiar with the inputs Perfcode needs and the
+outputs it generates is to run one of the test examples included in the
+repository. 
+1. Download the zip file of the repository and Unzip to your preferred location
+1. Open a command prompt in one of the \test- directories 
+2. Invoke the run-test.bat batch file   
+3. Refer to Appendix A of the report linked above for details on the input and output files.
+
 ## Compilation 
 ### Windows
-1. Download the zip file of the repository
-2. Unzip to your preferred location
+A windows binary is included in the \bin directory. 
+
+The application may also be compiled as follows:
 3. Open a command prompt in the \build directory 
 4. Confirm that gfortran is installed and can be invoked from the \build
    directory with command gfortran
 5. Run the batch file compile.bat
 6. Find the executable in the \bin directory   
+
 ### Linux 
 ToDo
 
 
 
-

bin/Perfcode.exe

@@ -16,6 +16,8 @@ gfortran -c ..\src\pfc1Dfuns.f95
 gfortran -c ..\src\pfc1Dsubs.f95 
 gfortran -c ..\src\pfc2Dsubs.f95 
 gfortran -c ..\src\BoundCond.f95 
+gfortran -c ..\src\applyBCs.f95 
+gfortran -c ..\src\budget.f95 
 
 :: Step 2 compile and link the main program 
-gfortran -o ..\bin\Perfcode ..\src\PERFCODE.f95 shared.o pfc2Dfuns.o utilities.o inputs.o outputs.o geom_funcs.o ConvCoef.o GridGen.o solvers.o pfc1dfuns2.o pfc1dfuns.o pfc1dsubs.o pfc2dsubs.o boundcond.o 
+gfortran -o ..\bin\Perfcode ..\src\PERFCODE.f95 shared.o pfc2Dfuns.o utilities.o inputs.o outputs.o geom_funcs.o ConvCoef.o GridGen.o solvers.o pfc1dfuns2.o pfc1dfuns.o pfc1dsubs.o pfc2dsubs.o boundcond.o applyBCs.o budget.o