Premiers pas

FrontISTR / Getting Started

Premiers pas

Analysez une charnière avec FrontISTR, puis examinez la distribution des contraintes dans ParaView. Avec le solveur et l’exemple prêts à l’emploi, vous n’avez pas besoin de commencer par créer un maillage.

Voir les étapes

Distribution de la contrainte de von Mises dans une charnière, avec des concentrations de contraintes autour des trous.
Exécutez une analyse statique linéaire d’une charnière. L’objectif est d’afficher NodalMISES, la contrainte de von Mises nodale, sous forme de contours colorés.

01

Préparer le solveur

Préparez le binaire Windows ou l’image Docker utilisable sous Windows, macOS et Linux.

Windows (64 bits)

Télécharger la version Windows

Extrayez le ZIP. Après avoir préparé l’exemple à l’étape suivante, copiez fistr1.exe et toutes les DLL fournies dans le dossier de l’exemple (01_elastic_hinge).

Docker (Windows / macOS / Linux)

Démarrez Docker, puis exécutez la commande suivante dans un terminal. Sous Windows, utilisez Docker en mode conteneurs Linux et exécutez la commande dans PowerShell.

docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:master

L’image officielle actuelle est conçue pour amd64. Sur les Mac Apple Silicon, elle s’exécute par émulation et peut donc prendre plus de temps.

Compiler à partir du code source

Vous pouvez aussi compiler FrontISTR vous-même à partir du code source sur n’importe lequel de ces systèmes. Une fois les compilateurs et les bibliothèques nécessaires installés, CMake détecte l’environnement et configure la compilation.

Installez les outils de base avec les commandes correspondant à votre distribution ci-dessous. Vous pouvez partir de votre environnement de développement existant sans ajouter MPI ni d’autres bibliothèques optionnelles.

Ubuntu / Debian

sudo apt-get update
sudo apt-get install build-essential cmake git gfortran

RHEL / Rocky Linux / AlmaLinux

sudo dnf install gcc gcc-c++ gcc-gfortran make cmake git

Les commandes suivantes montrent un exemple de compilation et d’installation sous macOS et Linux. Les exécutables sont placés dans le dossier bin de votre répertoire personnel : ni sudo ni modification de PATH ne sont nécessaires. Consultez le guide de compilation pour la préparation de macOS/Windows et les bibliothèques optionnelles.

git clone https://gitlab.com/FrontISTR-Commons/FrontISTR.git
cd FrontISTR
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="$HOME"
cmake --build build --parallel
cmake --install build

Vous pouvez exécuter directement l’exemple fourni sans le télécharger à nouveau. Lancez l’analyse avec les commandes ci-dessous, puis passez à l’étape 04 pour afficher le résultat dans ParaView.

cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"

Compiler à partir du code source

Les binaires et le conteneur utilisent les versions master / LATEST mises à jour en continu. Consultez la page de téléchargement pour les versions publiées et les autres environnements. Autres versions et environnements

02

Télécharger l’exemple

Téléchargez et extrayez le ZIP de l’exemple. Utilisez les trois fichiers d’entrée présents dans le dossier 01_elastic_hinge.

Télécharger l’exemple (ZIP)

Exécutez l’analyse dans le dossier 01_elastic_hinge extrait. Pour l’extraction en ligne de commande, macOS et Linux utilisent unzip.

01_elastic_hinge/

hecmw_ctrl.dat
Emplacements des fichiers d’entrée et de sortie
hinge.cnt
Matériaux, charges, conditions de blocage et paramètres d’analyse
hinge.msh
Maillage de la charnière

Pour préparer l’exemple en ligne de commande, exécutez tout le bloc ci-dessous à l’emplacement où vous souhaitez le conserver. Il télécharge et extrait l’archive, puis entre dans le dossier de l’exemple. Vous pouvez ensuite lancer la commande d’analyse dans le même terminal.

Windows / PowerShell

curl.exe -fL -o 01_elastic_hinge.zip https://www.frontistr.com/sys/files/01_elastic_hinge.zip
if ($LASTEXITCODE -eq 0) {
  Expand-Archive -Path 01_elastic_hinge.zip -DestinationPath . -ErrorAction Stop
  cd 01_elastic_hinge
}

macOS / Linux

curl -fL -o 01_elastic_hinge.zip https://www.frontistr.com/sys/files/01_elastic_hinge.zip &&
unzip 01_elastic_hinge.zip &&
cd 01_elastic_hinge

03

Exécuter depuis le dossier de l’exemple

Exécutez l’analyse dans le dossier de l’exemple (01_elastic_hinge). Vérifiez que hecmw_ctrl.dat s’y trouve.

Binaire Windows

Double-cliquez sur fistr1.exe placé dans le dossier de l’exemple. Les DLL fournies doivent se trouver dans le même dossier. Si la fenêtre se ferme à la fin de l’exécution, ouvrez dans ParaView les résultats écrits dans le dossier de l’exemple.

Pour consulter le journal

Si la fenêtre se ferme immédiatement sans produire de résultat, ou si vous souhaitez consulter le journal, ouvrez PowerShell dans le dossier de l’exemple et exécutez :

.\fistr1.exe

Docker (Windows / macOS / Linux)

docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1

Ouvrez un terminal dans le dossier de l’exemple (PowerShell sous Windows) et exécutez la commande. Le dossier de l’exemple est monté sur /work dans le conteneur. Les résultats sont enregistrés dans votre dossier local de l’exemple.

Lors d’une exécution dans un terminal, l’affichage du message suivant à la fin du journal confirme que l’analyse est terminée. La durée dépend de votre PC.

FrontISTR Completed !!
En cas de problème

Si les fichiers d’entrée sont introuvables, vérifiez que vous exécutez l’analyse depuis le dossier 01_elastic_hinge. Sous Windows, vérifiez que fistr1.exe et toutes les DLL fournies ont été copiés dans ce même dossier.

04

Ouvrir le résultat dans ParaView

Installez ParaView, puis choisissez File → Open et ouvrez le fichier suivant dans le dossier de l’exemple.

hinge_vis_psf.0001.pvtu

Les résultats sont enregistrés dans le même dossier 01_elastic_hinge. Le dossier voisin hinge_vis_psf.0001 est également nécessaire : ne déplacez pas le fichier .pvtu seul. 0000 correspond à l’état initial et 0001 au résultat après application de la charge.

Télécharger ParaView

Captures d’écran : ParaView 6.1.0 sous macOS. Les opérations de base sont les mêmes sous Windows et Linux.

  1. 04 / 1

    Juste après l’ouverture du fichier. Cliquez sur Apply à gauche.

    Juste après l’ouverture du fichier. Cliquez sur Apply à gauche.

  2. 04 / 2

    La géométrie de la charnière apparaît après avoir cliqué sur Apply.

    La géométrie de la charnière apparaît après avoir cliqué sur Apply.

  3. 04 / 3

    Dans la barre d’outils supérieure, remplacez Solid Color par NodalMISES pour afficher la distribution de la contrainte de von Mises.

    Dans la barre d’outils supérieure, remplacez Solid Color par NodalMISES pour afficher la distribution de la contrainte de von Mises.

Les couleurs et l’arrière-plan dépendent des réglages de ParaView ; ils n’ont pas besoin de correspondre à l’illustration. Si le modèle n’est pas visible, essayez Reset Camera.

Votre première analyse est terminée

Examinez ensuite les charges et les paramètres de matériau de l’exemple. Le manuel décrit ce modèle et présente d’autres types d’analyse.