Skip to content. | Skip to navigation

Laboratoire d’Etudes en Géophysique et Océanographie Spatiales

Personal tools

This is SunRain Plone Theme


You are here: Home / Research teams / Research / ECOLA / Softwares and products / T-UGOm Home Page


by ECOLA last modified May 15, 2015 11:57 AM

Main contributors :

Florent Lyard:

David Greenberg:

Cyril Nguyen :

Clement Mayet:

Damien Allain :

Yves Soufflet:

Laurent Roblou :


T-UGOm is a 2D/3D ocean dynamics numerical model based on unstructured meshes. Its main distinctive features are:

  • multi-discretisation capabilities (mostly LGP0, LGP1, NCP1, LGP2, continuous and discontinuous)
  • Finite volume and finite elements schemes
  • explicit/semi-implicit tunable
  • Time step dynamical local sub-cycling
  • embedded 2D/3D spectral solver for tides


    It is developed in C/C++, and provides(domain partion) MPI and OpenMP parallel optimisation. Sources management is based on Mercurial distributed version control system.

    It is part of the Sirocco service, labeled and supported by INSU (Institut National des Sciencs de l'Univers).



    T-UGOm is available through the Mercurial depot at See foolowing instructions for installation and compiling.

    We occasionally provide tar ball distribution archive. Latest release of T-UGOm (4.1.0, 15/05/2015) is available here download-button.


    Instruction for T-UGOm installation



    First the poc-solver library must be installed and compiled. see

    Needed packages:

    • gsl (Gnu Science Library), NetCDF
    • gtk 2.0


    Instructions for depot installation and update

    At first installation, you need to clone the depot by using in a local directory: 

    tugo-depot> hg clone .

    Autotools suite is necessary to install the local depot. First initialize the "configure" command :

    tugo-depot> aclocal
    tugo-depot> autoreconf -si

    Latter on, you can follow T-UGOm developments and fixing by routinely updating the depot:

    tugo-depot> hg pull
    tugo-depot> hg update

    After depot update, you will need to re-compile (see next section).

    Instructions for compiling

    T-UGOwith can be compiled in various optional modes, it is highly recommended to dedicate a specific compiling directory for each of them need by the user. The following command will generate a Makefile using the -g option for compiling, hence enabling debugging or step-by-step execution in a development interface such as kdevelop:

    tugo-compiling> /.../tugo-depot/configure --with-debug --prefix=/.../tugo-compiling

    The following command will generate a standard Makefile using the -O3 option for compiling, hence enabling an optimized code:

    tugo-compiling> /.../tugo-depot/configure --prefix=/.../tugo-compiling

    Once the Makefile has been generated, you can compile and install T-UGOm:

    tugo-compiling> make -j XXX
    tugo-compiling> make install


    Using T-UGOm

    Documentation and manuals for users and developers are slowly building. We are progressively feeding a WIKI site (TRAC), unfortunately not available at the moment for non-LEGOS users (external WIKI server should be implemented at LEGOS next fall). WIKI site can be found at : http://srv-ecola:8080/TRAC-TUGO/wiki .

    Meanwhile some older documents are available:

    Input parameters handling

    User manual (to do...)

    Developers documentations (PDF, to do...)


    On-going developments:

    • ocean wave interactions with circulation (C. Mayet, Phd)
    • 2D non-hydrostatic
    • 3D baroclinic spectral solver (F. Lyard, Y. Soufflet)
    • Semi-Lagrangian advection mode
    • 3D FV baroclinic  time-stepping solver

    some recent milestones can be found in FES2012 development pages. More details in T-UGom WIKI.


    Sirocco community

    T-UGOm page at sirocco

    Training and tutorials:


    T-UGOm applications


    Companion softwares:


    tidal data assimilation



    Document Actions