Syntaxe Terminal
L’extension QGIS et le terminal utilisent le même programme. Une simulation qui est lancée à partir d’un terminal produit donc les mêmes fichiers que l’un qui est lancé à partir de l’extension, et les deux apparaissent dans la liste tâche de l’autre.
Important
A terminal ne montre ni les couches d’entrée ni les résultats. Ouvrez les géodonnées de QGIS avant la première course pour vérifier que les couches s’alignent ensemble (Géodonnées), et vérifiez les résultats de chaque étape sur une carte avant de commencer la prochaine étape. Un modèle peut fonctionner sans message d’erreur et se tromper encore, par exemple parce qu’une ligne d’entrée se trouve au mauvais endroit.
Ouvrir un terminal
Sur Linux, ouvrez un terminal et activez l’environnement Python dans lequel aXqua est installé :
mamba activate axqua-env
axqua --version
Sur Windows, ouvrez le Miniforge Prompt à partir du menu de départ et entrez les mêmes deux commandes. Si le logiciel de simulation est installé dans le sous-système Windows pour Linux, ouvrez plutôt le terminal de la distribution Linux et continuez comme sur Linux.
Commandes
Une commande se compose du nom du programme, d’une action et, pour la plupart, du fichier de cas :
axqua <action> <case-file> [options]
Configuration de l’ordinateur (Configuration de l’extension) :
Commande |
Fonction |
|---|---|
|
Créez le profil de l’ordinateur à partir du logiciel qui y est trouvé. |
|
Vérifier le profil, y compris si TELEMAC et OpenFOAM peuvent être démarrés. |
|
Imprimer le profil utilisé. |
|
Imprimer le script d’environnement qu’aXqua trouve dans l’installation dossier de TELEMAC. Les autres programmes sont |
Installer le logiciel de simulation (Logiciel de simulation) :
Commande |
Fonction |
|---|---|
|
Afficher le système d’exploitation détecté et, pour TELEMAC, OpenFOAM et les postprocesseurs, où chacun est installé. |
|
Afficher ce que l’installation ferait, quels paquets système manquent, et la commande qui les installe. Rien n’est changé. Les autres programmes sont |
|
Commencez l’installation comme un processus propre et entrez le résultat dans le profil. Ajouter |
|
Affiche l’état de l’installation et les dernières lignes de son journal. |
|
Arrêtez l’installation. Ce qui est déjà téléchargé et construit est conservé. |
|
Télécharger les fichiers d’entrée de l’exemple cas d’un TELEMAC installé qui sont toujours manquants. |
Préparation et vérification d’un cas :
Commande |
Fonction |
|---|---|
|
Signalez tout dans le fichier de cas qui n’est pas dans l’ordre : les fichiers manquants, les paramètres inconnus ou impossibles, et les paramètres qui sont toujours vides. La commande énumère tous les problèmes à la fois. |
|
Vérifiez le fichier de cas, les fichiers d’entrée et le logiciel de simulation, et arrêtez au premier problème. |
|
Créez un fichier de cas avec les entrées que chaque cas a. |
|
Énumérez l’exemple cas avec sa taille (Exemple cas). |
|
Téléchargez l’exemple cas dans |
|
Exécutez le prétraitement et écrivez le modèle TELEMAC. |
|
Lancez le prétraitement et lancez TELEMAC une fois, pour vérifier qu’il accepte le modèle. |
|
Convertissez les fichiers CAO dans le terrain et couches d’un cas. |
|
Afficher quelles simulations sont configurées, construites et exécutées. |
|
Afficher le nombre de cellules de l’OpenFOAM maillage sans le construire. |
|
Créez le cahier pour mesures de terrain. |
|
Comparez les élévations des points de mesure avec le modèle de terrain. |
|
Renvoyez les chiffres prédéfinis avec VisIt. |
Résultats pour ParaView et VisIt (Post-traitement) :
Commande |
Fonction |
|---|---|
|
Énumérez les résultats TELEMAC du cas avec leur pas de temps, et indiquez lequel d’entre eux est exporté. |
|
Convertissez les résultats TELEMAC du cas en fichiers que ParaView ( |
|
Convertir un fichier de résultat sans cas. Le fichier géométrique du modèle fournit les coordonnées exactes de nœud. |
Outils pour les données d’entrée :
Commande |
Fonction |
|---|---|
|
Couper un raster, par exemple un MNT, en polygone. |
|
Estimez une courbe de tarage de la largeur chenal, la pente du lit et la rugosité. |
|
Écrire un fichier de cas du type actuel ( |
Espace disque et documentation :
Commande |
Fonction |
|---|---|
|
Énumérez les fichiers d’un cas qui n’ont plus besoin de rien, par catégorie et avec leur taille. Rien n’est supprimé (Libérer l’espace disque). |
|
Supprimer les éléments énumérés avec ces identifiants. |
|
Nommez la copie de cette documentation construite sur cet ordinateur, qui Help dans l’extension s’ouvre, et l’adresse publiée. |
Simulations en mode tâches (Batch-processing (sans tête)) :
Commande |
Fonction |
|---|---|
|
Commencez une simulation en tâche et imprimez son ID. |
|
Lancer le modèle étalonné pour la situation de validation du cas et le comparer avec les données de validation (exécution de validation). |
|
Liste toutes les tâches. |
|
Montrez l’état et le progrès d’une tâche. |
|
Afficher le journal d’une tâche pendant son fonctionnement. |
|
Arrêtez une tâche et tous les processus qu’elle a commencés. |
Chaque commande explique ses options avec --help, par exemple axqua submit --help.
Options pour les scripts
Avec l’option --json, chaque commande imprime son résultat comme un document JSON, que d’autres programmes peuvent lire de façon fiable. Si une commande échoue, son code de sortie indique la cause, de sorte qu’un script puisse réagir sans lire le message :
Code de sortie |
Cause |
|---|---|
0 |
Succès |
2 |
Erreur dans le fichier de cas |
3 |
Erreur dans les données géographiques |
4 |
Logiciel de simulation inaccessible |
5 |
La simulation a échoué |
6 |
Le maillage n’a pas pu être créé |
1 |
Toute autre erreur |
130 |
Annulé par l’utilisateur |
Scripts dans le dossier cas
Le modèle dossier cases/case-template/ du dépôt contient un script Python par étape de travail, par exemple preprocessing.py, initial_run.py et mesh_convergence_study.py. Ils effectuent les mêmes étapes que les commandes ci-dessus et courent au premier plan, de sorte que la sortie du code de simulation apparaît directement dans le terminal. Les paramètres qui s’appliquent à une seule étape sont listés en haut de chaque script. Les scripts font partie d’une copie du dépôt (Installer à partir du code source (développement)), pas du programme installé.
cd cases/my-reach
python preprocessing.py
python initial_run.py