Install VORTEX

External users do not need to install the vortex package (and they are not allowed to do it). Météo-France users who need to either extract operational S2M files either to run their own experiments on the HPC system need to install the vortex package.

In the general case, you have to use a pre-installed version of Vortex.

Use a pre-installed version of vortex

For standard users who do not need to implement modifications in vortex code, it is recommended to directly use the pre-installed stable version of vortex cen_dev branch. For that purpose, you need to add the following items to your .bash_profile (and run it):

On a CEN machine (including your laptop):

export VORTEX=/rd/cenfic3/cenmod/home/lafaysse/common/vortex/vortex-cen
export PYTHONPATH=$PYTHONPATH:$VORTEX/site:$VORTEX/src:$VORTEX/project
export MTOOLDIR=$HOME

On belenos:

export VORTEX=~verolive/vortex/vortex-cen
export PYTHONPATH=$PYTHONPATH:$VORTEX/site:$VORTEX/src:$VORTEX/project
export MTOOLDIR=$WORKDIR

On sxcen:

  export VORTEX=~verolive/vortex/vortex-cen
  export PYTHONPATH=$PYTHONPATH:$VORTEX/site:$VORTEX/src:$VORTEX/project
  export MTOOLDIR=/cnrm/cen/users/NO_SAVE/<login>

On other CNRM machines:

.. code-block:: bash

   export VORTEX=/d0/sync/vortex/vortex-cen
   export PYTHONPATH=$PYTHONPATH:$VORTEX/site:$VORTEX/src:$VORTEX/project
   export MTOOLDIR=/cnrm/cen/users/NO_SAVE/<login>

Note: Make sure that the folder /cnrm/cen/users/NO_SAVE/<login> exist for sxcen.

Then, go the last section of this documentation (File transfers with hendrix archive and sxcen).

Install your own vortex code

For users who need to implement new algorithms or resources in the vortex code, it is necessary to install vortex from the git repository.

We recommend to download it locally on your machine with git pull and synchronize it remotely using put command provided by snowtools.

For a first install, you must belong to the vortex opensource project. For that, ask vortex dot support at meteo dot fr to give you access to the project, specifying that you need to implement new developments (and copy to crocus at meteo dot fr).

You do not need to provide again your ssh key if you have already done it for the other projects.

Then, you’ll find more information (install, doc) on : https://opensource.umr-cnrm.fr/projects/vortex?jump=wiki.

You must choose the cen_dev branch.

Basically, installing requires to download the git repo. and add a few vortex paths to your PYTHONPATH.

First, add the following items to your .bash_profile (and run it):

export VORTEX=<your_path_to_vortex>
export PYTHONPATH=$PYTHONPATH:$VORTEX/site:$VORTEX/src:$VORTEX/project
export MTOOLDIR=$WORKDIR

Attention: for a local installation WORKDIR and therefore MTOOLDIR might be undefined. In this case MTOOLDIR has to be set before executing a task that fetches data.

File transfers with hendrix archive and sxcen

When a simulation is launched on belenos or taranis, Vortex automatically downloads input files from hendrix or the belenos/taranis cache (/scratch/mtool/<yourname>/cache/vortex/), and uploads the output of the simulations on hendrix and the cache. To allow Vortex to use ftserv from belenos/taranis to hendrix, it is necessary to register your password by running the following command on belenos/taranis:

ftmotpasse -h hendrix.meteo.fr -u <yourname>

The same procedure applies if you’d like to upload light output data to your laptop or any server other than hendrix, e.g. sxcen.cnrm.meteo.fr :

ftmotpasse -h sxcen.cnrm.meteo.fr -u <yourname>

Do not forget to re-run these commands every time you change your password (as Météo-France asks you on a 6-month basis). Otherwise, the authentication for the transfer of outputs will fail.

File transfers to a local machine

Make sure that your user creditals for hendrix are stored in your .netrc file (in the home directory). There should be a line like:

machine hendrix.meteo.fr login <yourusername> password <yourpassword>

and that only the user has read and write permissions for the .netrc file:

chmod og-rw .netrc

(removes read and write permissions for group and other).

That’s it !