Main contributors :
Florent Lyard: email@example.com
David Greenberg: David.Greenberg@dfo-mpo.gc.ca
Cyril Nguyen : firstname.lastname@example.org
Clement Mayet: email@example.com
Damien Allain : firstname.lastname@example.org
Yves Soufflet: email@example.com
Laurent Roblou : firstname.lastname@example.org
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 https://hg.legos.obs-mip.fr/tugo. See foolowing instructions for installation and compiling.
Instruction for T-UGOm installation
First the poc-solver library must be installed and compiled. see http://www.legos.obs-mip.fr/recherches/equipes/ecola/outils-produits/poc-solvers.
- 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 https://hg.legos.obs-mip.fr/tugo .
Autotools suite is necessary to install the local depot. First initialize the "configure" command :
tugo-depot> autoreconf -si
Latter on, you can follow T-UGOm developments and fixing by routinely updating the depot:
tugo-depot> hg pull https://hg.legos.obs-mip.fr/tugo
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
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:
User manual (to do...)
Developers documentations (PDF, to do...)
- ocean wave interactions with circulation (C. Mayet, Phd)
- 2D non-hydrostatic
- (F. Lyard, Y. Soufflet)
- Semi-Lagrangian advection mode
- 3D FV baroclinic time-stepping solver
Training and tutorials:
- FES2012 project (CNES/Noveltis/CLS)
- COMAPI project (CNES/Noveltis)
- global ocean storm surges operational modeling (altimetry time series de-aliasing, CNES/NASA)