In the step below we will use “apt-get install” to install package.
This command is mainly for Debian distribution.
The command might be different on your distribution for example.
It is “urpmi” for Mandriva/Mageia.
It is “yum install” for Fedora.

Prerequisites

Here is a list of the software you will need to compile and run the TELEMAC-MASCARET system.

MED Format

Other partitioners

This is only available if you have the prerequisites for parallelism.
During a parallel run the mesh is split in multiple parts via the software partel.
Partel is using by default metis for the partitioning step.
Here is another software that can be used instead of metis:

A parallel version of partel was developped but is not fully working. It is using a parallel partitioning instead of a sequential one. Here is a list of two partitioners that are compatible:
Parallel partitioner for parallel version of partel (Feature not available in v7p2r0)

ParMetis (You can have information on how to compile on their website)

PtScoctch (You can have information on how to compile on their website)

Installation of TELEMAC-MASCARET

In this part we will describe how install the TELEMAC-MASCARET software.
We will use the following terms (which will be explained in more details further on):

<root> will mean the path to your TELEMAC-MASCARET sources.

<systel.cfg> This will mean you configuration file.

<config> This will point to your configuration.

<pysource> This is your environment file.

In the example below, we will install TELEMAC-MASCARET in ~/telemac-mascaret/v7p2r0 (<root>) with two configurations (gfortran and gfortranHPC). All the files for that examples can be found at the end of each section.

Setting your environment

This part will describe how to create <pysource>.

To ease the loading of the TELEMAC-MASCARET environment we suggest using a file to set environment variables.
You can find an example of such a file in <root>/configs/pysource.template.sh.
So copy this file.
It sets the following environment variables:

HOMETEL: Path to your installation (<root>)

SYSTELCFG: Path to yout configuration file (<systel.cfg>)

USETELCFG: The name of your configuration (<config>)

SOURCEFILE: Path to this file (<pysource>)

Set those four variables in your <pysource> to comply with your installation.
Here is an example of the modified lines values:

# This file is a template for a Linux environment file# running "source pysource.template.sh" will position all# the necessary environment variables for telemac# To adapt to your installation replace word <word> by their local value###### TELEMAC settings -----------------------------------------------------------#### Path to telemac root direxportHOMETEL=/home/yugi/telemac-mascaret/v7p2r0
# Adding python scripts to PATHexportPATH=$HOMETEL/scripts/python27:.:$PATH# Configuration fileexportSYSTELCFG=$HOMETEL/configs/systel.edf.cfg
# Name of the configuration to useexportUSETELCFG=gfortranHPC
# Path to this fileexportSOURCEFILE=$HOMETEL/configs/pysource.gfortranHPC.sh
### Python# To force python to flush its outputexportPYTHONUNBUFFERED='true'### APIexportPYTHONPATH=$HOMETEL/scripts/python27:$PYTHONPATHexportLD_LIBRARY_PATH=$HOMETEL/builds/$USETELCFG/wrap_api/lib:$LD_LIBRARY_PATHexportPYTHONPATH=$HOMETEL/builds/$USETELCFG/wrap_api/lib:$PYTHONPATH###### EXTERNAL LIBRARIES -----------------------------------------------------------###### METIS -------------------------------------------------------------exportMETISHOME=/home/yugi/opt/metis-5.1.0/arch/debian

If you will be using only one version of TELEMAC-MASCARET you can add the content of this file in your ~/.bashrc.

(optional) Adding MED

You need to add the following information for both MED and hdf5 if there are not installed in /usr.

Loading the environment

Once that is done, to load your environment type in a terminal:

source pysource.gfortranHPC.sh

Configuring TELEMAC-MASCARET

This part will describe how to create <systel.cfg>.
In the folder <root>/configs you can find a few configuration files, some may fit your configuration.
Here is a quick description of what some of the existing configurations handles:

systel.cis-debian.cfg Configuration for sequential and parallel configuration on debian.

systel.cis-fedora.cfg Configuration for sequential and parallel configuration on fedora.

systel.cis-opensuse.cfg Configuration for sequential and parallel configuration on opensuse.

systel.cis-ubuntu.cfg Configuration for sequential and parallel configuration on ubuntu.

systel.cis-windows.cfg Configuration for sequential and parallel configuration on Windows.

systel.hrw.cfg Configurations used by H.R.Wallingford.

systel.edf.cfg Configurations used by EDF, contains parallel and debug configuration for nag, intel, gfortran on Debian and a couple of configurations for clusters.

systel.salome.cfg Configurations for salome_hydro.

systel.cis-hydra.cfg Configuration for an hydra cluster.

Now we are going to describe how to create one from scratch that contains two configurations: