SOURCE CODE (ahm_source.tar.Z ends up in (/source))

This directory contains the source code for the Alpine Hydrochemical
Model (all .for (or .f) and .inc (included) files, depending on how you
received it.

All ".inc" suffixed files should be kept in the directory with the ".f"
or ".for" suffixed files when compiling, and in general should be left
there permanently.  Each subdirectory has a distinct "readme" file.
Generally, DOS compilers will expect a .FOR suffix on the source code
files, and UNIX compilers the .f suffix.  Change as needed with the DOS
command:
REN *.F *.FOR
or the UNIX mv command.

One compiler encountered (SVS for an DEFINICON processor board, circa
1986 or 1987) would not accept the format used for the "include"
statement in the various subroutines; 

Attempting to compile the whole program from a single file including the
source codes of the main program and subroutines is not recommended, as
doing so will likely cause you to encounter numerous limits related
to various forms of memory space, etc.  It also will require the entire
program to be recompiled whenever a minor change is made to a single
subroutine.  However, as a general rule, if a modification is made to
any of the ".inc" files, recompiling the whole program (using the
preferred separate subroutine files) is required.


SUBDIRECTORIES RMFORT, SVS (ahm_rmfort.tar.Z and ahm_svs.tar.Z)

Sub directories named "rmfort" and "svs" contain batch files and link
files to compile the AHM with Ryan McFarland and SVS fortran on IBM
compatible PC's or 386/486 machines; they are described in more detail
in those subdirectories.  If neither of these compilation runstreams
exactly match that needed for your compiler, they should provide
information useful for creating your own compile commands.

The SVS subdirectory also has a DOS batch file named MAKEALL.BAT that
will combine all the .FOR files into a single file named ALL.F, useful
for transfering the source code to unix machines, where it can be
re-separated with the unix "fsplit" command.

MAKEFILES  (ahm_make.tar.Z)

The subdirectory "make" contains makefiles for SUN and CONVEX unix
machines; these are for compiling the model on those machines by issuing
the command "make" after changing the appropriate makefile's file name
to "makefile".  Depending on how you received these files, some spaces
in these makefiles may need to be replaced with tabs before they will
work at all; generally these are needed where the makefiles have about 7
spaces at the beginning of a line containing other data.


SUBDIRECTORY WY86  (ahm_example_wy86.tar.Z)

The sub directory "wy86" contains input data files needed to reproduce
the final WY86 runs from the Emerald Lake watershed reported in the
dissertation of Ross A. Wolford, Univ. of Arizona, Dept. Hydrology and
Water Resources, Tucson, AZ (1992).  It also has a file named "runstrm"
that shows the interactive inputs used with the WY-1986 Emerald Lake
data to reproduce the outputs of the final WY86 run.

SUBDIRECTORY SUPPL (ahm_suppl.tar.Z)

This subdirectory includes several FORTRAN programs useful for
converting the mass of output created by the AHM into data that may be
plotted, etc.  CHEMPLOT produces an output file consisting of either the
chemical species concentrations in a single compartment of a single
subunit (e.g. a soil horizon, lake layer, or streamflow), or a single
species for several different subunits/compartments.  The input data
file for this supplemental program is the AHM output file "phalk.out",
though the name of this file must be entered to CHEMPLOT in case that
file was renamed.  The output file name is interactively specified.

SUBDIRECTORY WY87  (ahm_example_wy86.tar.Z)
This subdirectory may or may not be present, depending on your source
for the source code and data; it includes Emerald Lake data needed to
make runs similar to the final runs for water-year 1987 used in the
dissertation of Ross A. Wolford, U of AZ, 1992.  It is described more
fully in that subdirectory.