u4.11.02 Commande FIN#

Syntaxe#

Détail de la syntaxe
FIN(
    ◇ RETASSAGE = / "NON" (par défaut),
                  / "OUI",
    ◇ INFO_BASE = / "NON",
                  / "OUI",
    ◇ INFO_RESU = / "NON" (par défaut),
                  / "OUI",
)


◆ : obligatoire
◇ : optionnel
⟐ : présent par défaut
& : ensemble
/ : un seul parmi
| : plusieurs choix possibles

Opérandes#

La commande FIN sauvegarde l’ensemble des concepts calculés lors de l’exécution dans le fichier glob.1 (et éventuellement glob.2, … si nécessaire), ainsi que l’ensemble des objets python du contexte d’exécution dans des fichiers pickle. Ces objets seront disponibles pour une POURSUITE du calcul.

Si l’utilisateur n’a pas demandé à recopier la base après le calcul (il n’y a pas de base dans le fichier .export de l’étude), FIN ne fera rien.

Remarque

Les objets python de type classe, fonction et type ne sont pas sauvegardés dans le fichier pick.codeaster.objects.

Quand FIN a terminé son travail, Python continue à analyser les instructions qui suivent et qui vont certainement échouer si elles font appel aux objets code_aster.

Le développeur peut utiliser FIN(exit=True) pour forcer à quitter l’interpréteur Python.

Mot-clé RETASSAGE#

Provoque le retassage de la base “GLOBALE” avant écriture sur le fichier associé. Ceci permet de conserver des bases plus petites (débarrassées des objets associés aux concepts détruits par l’utilisateur).

Ce retassage est effectué comme suit par la commande:

  • fermeture des bases,

  • ouverture de la base “GLOBALE”,

  • ouverture d’une base “VOLATILE”,

  • recopie, enregistrement non vide par enregistrement non vide de la base “GLOBALE” sur la base “VOLATILE”,

  • renommage par le code de cette base “VOLATILE” pour sauvegarde comme si c’était la base “GLOBALE” classique.

La base GLOBALE est constituée d’un ou plusieurs fichiers binaires organisés sous forme d’enregistrements de longueur fixe. Lors des opérations de destruction, les enregistrements associés sont déclarés libres et peuvent éventuellement être réutilisés en cours d’exécution. En fin d’exécution, il peut subsister des enregistrements inoccupés qui contribuent à la taille finale du fichier. L’opération de retassage consiste donc à réutiliser cette place en réorganisant les enregistrements. C’est une opération qui peut entraîner de nombreuses lectures et écritures sur disque.

Lors d’une exécution en parallèle (MPI) classsique, mode « centralisé », c’est chaque instance de la base GLOBALE qui est traitée, ce qui multiplie les entrées/sorties. En mode distribué, chaque instance gère ses propres entrées/sorties selon ses besoins.

Mot-clé INFO_RESU#

Provoque l’impression dans le fichier MESSAGE des informations relatives au contenu de l’ensemble des structures de données résultat stocké dans la base GLOBALE.

Remarque :

L’usage de ce mot clé peut augmenter de façon conséquente la durée d’exécution de la commande FIN et produire de très gros fichiers de sortie. Pour cette raison, il n’est pas activé par défaut.

Mot-clé INFO_BASE#

Ce mot-clé permet d’imprimer la liste des objets présents dans la base globale ainsi que leur taille dans le fichier MESSAGE. Quand la base est sauvegardée, l’impression est faite automatiquement. Dans cas contraire, on peut activer ce mot-clé pour afficher la liste.