Windows
Quick start
- Get GOTM It is easiest to
download the pre-built GOTM software for Windows (gotm.exe)
, provided with each stable release.
- Get examples
Download the example scenarios
for your version of
GOTM. You may run these scenarios to familiarize yourself with GOTM or to learn
about ocean turbulence;
the example scenarios are discussed in detail on this web site.
- Run To run a scenario, open a command prompt (“cmd”), cd to the
scenario directory, and run GOTM by typing the full path to gotm.exe.
- View results GOTM produces output in NetCDF format (files with .nc
extension). These can be read by many applications (e.g., MATLAB, R). If you
need a stand-alone NetCDF viewer, we recommend
PyNcView.
Building from scratch
Prerequisites
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: CURRENT_DIRECTORY\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
VERSION YEAR” - 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.