The Acoustics Toolbox is a collection of acoustic models and related software for studying sound propagation in an ocean waveguide. Actually, the models have been structured to be suitable for general wave propagation problems; however, the ocean application is our main focus.

The acoustic models in the package are:

KRAKEN is a normal mode program for range-varying environments in

either cartesian (line sources) or cylindrical coordinates (point

sources).  The basic method is described in

   Porter, Michael B. and Reiss, Edward L., "A numerical method for ocean-acoustic normal modes", JASA 76, 244--252 (1984).

   Porter, Michael B. and Reiss, Edward L., "A numerical method for bottom interacting ocean acoustic normal modes", JASA 77, 1760--1767 (1985).

Range-dependent solutions are obtained by using optionally adiabatic or coupled mode theory.

There are generally no limits on the dimensions that can be handled (up to virtual memory. The code uses dynamic allocation for virtually all arrays. There are a few exceptions. You will generally get a flag if for some reason any dynamic memory allocation fails or if you have exceeded an intrinsic limit in the code. As a consequence of the dynamic memory allocation you can go to ridiculously large numbers of sources, receivers, modes, etc. as suits your fancy (and/or possibly, patience).

The following modules are part of the package.

GROUP I: MODE COMPUTATIONS:

GROUP II: BASIC PLOTTING ROUTINES:

GROUP III: FIELD COMPUTATIONS:

GROUP IV: PLOTTING ROUTINES THAT USE GROUP III PROGRAM OUTPUT:

The various programs for computing fields (GROUP III) are only needed for PLOTSHD, or for special user programs (e.g. ambiguity surfaces).

The following extensions are used with these programs:

All user input in all modules is read using list-directed I/O. Thus data can be typed in free-format using space, tabs, commas or slashes as delimeters. Character input should be enclosed in single quotes like this: 'CHARACTER INPUT'. You will see the '/' character in a number of the input files. This terminates an input line causing the program to use default values.

INSTALLATION NOTES

There is a command file for each of the programs in this package which assigns necessary input files to the appropriate Fortran unit number used by that program.  To simplify the installation, these command files make use of logical names for certain directories.

The following symbols and logical names for directories are used with the KRAKEN command files:

 HOW TO RUN KRAKEN

  Starting out for the first time? If the distribution does not have precompiled executables for your hardware, run the 'makefiles' to compile and link of the whole package.

  1.   Create the environmental file for your problem, following the directions in KRAKEN.HLP.
  2.   Run KRAKEN (or KRAKENC) by typing

KRAKEN filename

     where "filename" is the environmental file. (The process is the same under DOS or Linux.) The KRAKEN.HLP file details the differences between the KRAKEN and KRAKENC.

  1.   Run FIELD to sum the modes and compute the complex pressure field:

     FIELD filename

  1.   You now have several choices (all the GROUP II programs). These are run from inside MATLAB:

     a. PLOTMODE to plot the modes.

     b. PLOTSSP  to plot the sound speed profile.

     c. PLOTSHD  to plot the pressure field as a function of range and depth.

     Once the modes are created by KRAKEN or KRAKENC you can run the above plot programs in any sequence or as often as you like.