US JGOFS Regional Ecosystem Testbed Project Software and Documentation

Detailed Instructions to get and run the regional models:

1. Download software and forcing in two tar files. These files are uncompressed, compressed (.Z) or gzipped (.gz). Also get the instruction and readme files. The subdirectories TestBedmodels and TestBedforcing have the individual model code and input files for your inspection.
2. Read testbed README document.
3. Edit driver.f to replace the home and data directories with the correct paths, and make necessary adjustments to homedir and datdir character lengths in common_blocks.h.
4. Experiment with compiling (make driver) and running the Fortran 77 code for the 4-component ecosystem model examples: (./driver < input_4ep) for the EqPac run, or (./driver < input_4as) for the ArabSea run.
5. To run the 8-component ecosystem example, you need to
   • cp readinit_8.f readinit.f
   • cp derivs_8.f derivs.f
   • make driver
   • ./driver < input_4as
6. Formulate the derivs.f subroutine for your specific ecosystem model(s), following the examples given in derivs_4.f and derivs_8.f. Note that the derivs_4.f subroutine has parameter values (growth rates, etc) that are typically characteristic of the Arabian Sea, where as the derivs_8.f subroutine has parameter values that may be more typical of the Equatorial Pacific.
7. Edit readinit.f based on suggestions in readinitExample.f.
8. Compile and run your modified code.
9. Add column headings (state variable names and units) to output files.
10. Send me all output files (7 for EqPac and 7 for ArabSea) and cost function values.
11. Suggest an alternate definition of a cost function, if desired.
12. Please let me know if you had to modify any subroutines other than derivs.f and readinit.f

Written by J. Klinck, April, 2003. Last updated by M. Friedrichs, September, 2004.

Send questions or comments by e-mail to marjy@ccpo.odu.edu