Dynamically Dimensioned Search (DDS) Global
Optimization Algorithm - for WATmodels
  - by Bryan Tolson. FORTRAN PC Version 1.1

Reference: Tolson, B.A. & Shoemaker, C.A.  (2007). Dynamically dimensioned search algorithm for computationally
efficient watershed model calibration. Water Resources Res.
43, W01413, doi:10.1029/2005WR004723.

See README_WATmodel_1.1.pdf file for Disclaimer, Copyright, and "detailed user instructions.
-----------------------------------------------------------------------------------


This directory, e.g. DDS_gr10k , contains all algorithm output files for DDS main program.

 ******** Detailed Output file descriptions:

In the output files (and source code): 
- Decision variable called DV, also referred to by s
- DVs printed by column: col i = DV#i, col i+1 = DV#i+1, etc
- Objective function called function, func, also F etc.
- Fbest is best F value found so far, Ftest is F value for the new test solution (stest) in current iteration (iter)
- the iteration# is also the # of F evaluations or Fevals so far
- Ftest and Fbest printed by row.

File: DDS_gr10k\all_Fbests.out                                                                            
   - contains Fbest values for all trials.
   - column 1 is trial 1, column 2 is trial 2 etc.
   - row 1 is for iteration 1, row 2 is for iteration 2 etc.
   - e.g. row 10 has best F value found after 10 objective
     function evaluations, for all optimization trials.

File: DDS_gr10k\all_sbests.out                                                                            
   - contains sbest values for all trials.
   - column 1 is DV#1, column 2 is DV#2 etc.
   - row 1 for optimization trial 1, row 2 for trial 2 etc.
   - e.g. row 10 has best solution found (sbest) by DDS in 
     optimization trial 10.

File: DDS_gr10k\all_output.out                                                                            
   - input flag controls whether this file is printed or not
   - contains ALL sbest, stest, Fbest, Ftest for all trials.
   - column headers and notes in file are self explanatory.

File: DDS_gr10k\DDS_init.txt                                                                              
   - a copy of the DDS input file used for this run
   - enables easy replication of results.

File: DDS_gr10k\initials_out.txt                                                                          
   - contains the initial solution values for all trials.
   - column 1 is DV#1, column 2 is DV#2 etc.
   - row 1 for optimization trial 1, row 2 for trial 2 etc.
   - e.g. row 10 has initial solution for in trial 10
   - Copy & rename this file to *initials.txt* and it can be 
   - used to specify initial DDS solutions for another run.

