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.
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.
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:
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.
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.
FIELD filename
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.