GOTM is the result of the effort by a number of people to make 'state-of-the-art' turbulence model for natural waters. Since its inception more than 20 years ago GOTM has grown into a full-fledged 1D water column model with a very extended configuration possibilities including coupling to a collection of bio-geochemical models.

Download the code

First, get the GOTM source code from GitHub. You can either download
the latest stable release of the code
as a single zip file, or check out the very latest version (“developer’s
version”) of the code from
GOTM’s git repository
. If you need the developer’s
version, a graphical git client such as
TortoiseGit
can be used to obtain the source code from the Git repository. Note that
TortoiseGit also requires
Git for Windows
to be installed. After Git for Windows and TortoiseGit are installed, you
obtain the developer’s version of GOTM by right-clicking in Windows Explorer
within the directory where you want to place the source code directory, and
choosing “Git Clone…”. In the window that appears, set “URL” to
https://github.com/gotm-model/code.git, set “Directory” to the path where you
want the source code (recommended: _CURRENTDIRECTORY\gotm-git) and click OK.
This should download the latest code.

Building

Start “CMake (cmake-gui)” from the start menu.

Click the “Browse Source…” button and select the directory with the GOTM
source code. This is the src directory at the root of the GOTM repository.

Click the “Browse Build…” button and select a directory of your choice
to build GOTM in - e.g. C:\Users_USERNAME_\build\gotm. It is recommended to
choose an empty (or new) directory for this purpose. MinGW users: some
versions of CMake (e.g., 3.0.2) generate invalid makefiles if the build
directory is on a remote server (i.e., a path starting with \\); to avoid
problems, place it on a local or mounted network drive instead.

Click the “Configure” button. This first time you do this, CMake asks you
to select a build system generator. If you intend to use Intel Visual Fortran,
select your version of Visual Studio and press OK (choose “Visual Studio
VERSIONYEAR” - avoid the entries with IA64 and Win64 postfixes!). If you
intend to use MinGW, choose “MinGW Makefiles”.

Now all configuration variables for the build system are listed and you
can change them according to your preferences. After changing any variable,
press the “Configure” button again - additional settings may appear.

If all configuration variables are set correctly, and you have clicked the
“Configure” button until no new (red-colored) configuration variables appear,
press the ‘Generate’ button. If you previously selected Visual Studio as build
system, this now creates the Visual Studio solution and projects in your chosen
build directory. If you selected MinGW as build system, it will generate the
make files.

If you use Intel Fortran, open Visual Studio, and open the solution
gotm.sln that CMake has created in the build directory chosen in CMake. To
build and install GOTM, right-click the “INSTALL” project in the solution
explorer, and choose “Build”. If you use MinGW, open a command prompt (run
“cmd”) and cd to the build directory (not the src directory!) defined above.
Then type and run “mingw32-make install”.

After the build completes, the GOTM executable will be installed at
%LOCALAPPDATA%\gotm\bin\gotm.exe (%APPDATA%\gotm\bin\gotm.exe on Windows XP).
At this point you can continue with step 2 in the quick start instructions at
the top of this page.