How to run GOTM ?

UNIX/LINUX WINDOWS
(1) Download GOTM version #.#.# & Uncompress
  • Download GOTM code
  • gunzip gotm#.#.#.tar.gz
  • tar -xvf gotm#.#.#.tar
  • Download GOTM code
  • Winzip gotm#.#.#.tar.gz
  • (2) Download GOTM test case including forcing, observations & parameters.
  • Download GOTM test case (Ex: Flex)
  • gunzip flex.tar.gz
  • tar -xvf flex.tar
  • Download GOTM test case (Ex: Flex)
  • Winzip flex.tar.gz
  • (3) Download NETCDF library
  • Download UNIX netCDF library
  • Update Makefile path for library file "libnetcdf.a" and declaration file "netcdf.h"
    "NETCDFLIB=/usr/lib/libnetcdf.a"
    "NETCDFINCDIR=/usr/include"
  • Download PC netCDF library.
  • Unpack it and update the paths for include and lib files in your compiler.
  • (4) Compile & Create an executable
  • cd /gotm#.#/src (go in the source directory)
  • Update "Makefile" with the path of netcdf library & compiler.
  • Compile model by typing "make". Note that, in order to avoid problems, we strongly advise to use the GNU makefile. On old workstations, you might need the following modified Makefile)
  • With Fortran Developer:
  • Create a workspace called GOTM
    (Win32 Console Application).
  • Include into the project: the code files "*.f90" (from gotm#.#.#/src).
  • Add the library netcdf.lib to your project libraries. Remember to update the paths for include and library files. When using Compaq Visual Fortran you have to modify Fortran/preprocessor (for include directory) and Link/input (add library netcdf.lib and path to it).
  • (5) Run the model
  • cd /flex (go in the test case directory).
  • ln -s ../gotm#.#/src/gotm gotm (make a symbolic link to the executable gotm*) .
  • Type "gotm".
  • cd flex (go in the test case directory).
  • Create a .bat file with one text line $PATH$\gotm.exe (Example: c:\gotm2.4.0\Release\gotm.exe) If this does not work, copy the executable "gotm.exe" into the test case dir).
  • Click on gotm.bat or gotm.exe to execute the program.
  • (6) Visualise results
    Various graphical software packages can be used to visualise GOTM outputs in ASCII format (e.g. EXELL, XMGR...) or NETCDF format (GrADS, Ferret, MATLAB, Data eXplorer...).
    Among the GOTM developers the following 3 packages are used Ferret, NCL/ NCAR Graphics and Generic Mapping Tools (GMT) as they satisfy all needs to view GOTM outputs (read/write netcdf files, deals with free surface, make time plots, contours & 3D surfaces, compute time & spatial averages, density, mixed layer depth, and they all come with extensive documentation and lots of examples). To get an idea about the basic functions and potential of Ferret to visualise GOTM outputs, visit the result page.