Actran

Versions et licence

Les versions suivantes du logicielActran TM sont installées sur le calculateur Newton :

Version

Chemin d’installation

Module pré-requis

Actran_19.1

/softs/manual/lmfa/Actran/Actran_19.1

Actran_2020

/softs/manual/lmfa/Actran/Actran_2020

Actran_2021

/softs/manual/lmfa/Actran/Actran_2021

Actran_2021.1

/softs/manual/lmfa/Actran/Actran_2021.1

L’accès à ce logiciel est restreint au groupe actran des utilisateurs autorisés.

Définition de l’environnement de travail

Renseigner les variables relatives à l’installation et au serveur de licence :

ACTRAN_PATH=/softs/manual/lmfa/Actran
export MSC_LICENSE_FILE=27500@licserver.mecaflu.ec-lyon.fr

Une alternative à cette dernière ligne serait de renseigner cette information dans ~/.flexlmrc (ce fichier est à créér dans le $HOME de votre compte, s’il n’existe pas encore) :

cat ~/.flexlmrc
MSC_LICENSE_FILE=27500@licserver.mecaflu.ec-lyon.fr

Pour les versions Actran_19.1 et Actran_2020 uniquement

On peut exécuter un fichier de définition de l’environnement :

source $ACTRAN_PATH/actran_2020

ou

source $ACTRAN_PATH/actran_19.1

Il y a aussi la possibilité d’installer des wrappers dans le compte utilisateur, en exécutant le script

$ACTRAN_PATH/install_actran_2020_for_current_user

ou

$ACTRAN_PATH/install_actran_19.1_for_current_user

Cela aura comme résultat (entre autres) la création dans $HOME/bin de ces wrappers :

actranpy  actranvi  actranw  pltviewer  uninstall_actran_for_current_user  waterfallviewer

Afin de spécifier l’ensemble des variables d’environnement nécessaires à l’usage du logiciel, vous pouvez ajouter les lignes suivantes dans votre ~/.bashrc (ou dans un autre fichier à sourcer) :

### Actran TM 2021]
ACTRAN_PATH="/softs/manual/lmfa/Actran"
export PATH=$ACTRAN_PATH/bin:$PATH
export ACTRAN_PRODUCTLINE=$ACTRAN_PATH/Actran_2021
export MSC_LICENSE_FILE=27500@licserver.mecaflu.ec-lyon.fr

Une fois l’environnement de travail défini, vous pouvez utiliser le logiciel.

Utilisation interactive

Lancer Actran en mode graphique sur les machines de prepost-, en étant connecté via X2Go :

vglrun actranvi

Utilisation interactive en ligne de commande

Cette utilisation n’est adaptée que pour des cas spécifiques (tests de fonctionnement, petit cas, …). Pour une utilisation intensive, il faut soumettre votre job en mode batch.

Lancer le solveur ACTRAN en mode séquentiel

actranpy -i inputfile.dat [options]

Lancer le solveur ACTRAN en mode parallèle sur un seul noeud

actranpy.sh [--np=number_of_processes]... [--inputfile=inputfile.dat]...
--parallel={loadcase|frequency|...}...
[--threads=number_of_threads]...
[actran options]

Lancer le solveur ACTRAN en mode parallèle sur plusieurs noeuds

$ACTRAN_PATH/Actran_2020/mpi/intelmpi/bin/mpiexec.hydra  -n N [mpiexec  options]...
$ACTRAN_PATH/Actran_2020/bin/actranpy_mp...
[actran options]

Soumission en mode batch

Le lancement habituel devrait être fait à l’intérieur d’un script de soumission SLURM.

Exemple de script de soumission

#!/bin/bash
#
#SBATCH --job-name=test_actran
#SBATCH --output=job_%j.out
#
#SBATCH --partition=haswell
#SBATCH --exclusive
#SBATCH --nodes=2
#SBATCH --ntasks-per-node=8
#SBATCH --cpus-per-task=2
#SBATCH -t 1:00:00

module purge 
ACTRAN_PATH=/softs/manual/lmfa/Actran
export MSC_LICENSE_FILE=27500@licserver.mecaflu.ec-lyon.fr  
source $ACTRAN_PATH/actran_2020

MPIDIR="$ACTRAN_PATH/Actran_2020/mpi/intelmpi/bin/"
EXECDIR=" $ACTRAN_PATH/Actran_2020/bin/

$MPIDIR/mpiexec.hydra -n 16...
          -machinefile machinefile...
         -genv MSC_LICENSE_FILE 27500@licserver.mecaflu.ec-lyon.fr
         $EXECDIR/actranpy_mp...
          --inputfile=...
          --mem=200 --parallel=frequency
          --threads=2

Remarque : les options --mem et --thtreads spécifient respectivement la mémoire et le nombre de threads par processus MPI.