Un programme MUSTIG est un graphe composé de plusieurs boîtes élémentaires appelées macros ou modules, liées ensemble par des fils. Un graphe est composé :

• d'opérateurs de calcul qui comprennent au moins une entrée et une sortie,
• d'opérateurs Source avec des sorties seulement (générateurs, modules de lecture de fichier, etc),
• d'opérateurs terminaux avec des entrées seulement (modules graphiques, affichages scalaires ou vectoriels, modules d'écriture de fichier, etc):

Quand le graphe est construit aucun calcul n'est exécuté : Mustig vérifie seulement la consistance du graphe pour empêcher, par exemple, deux sorties d'être reliées directement ensemble.

À tout pas de la création du graphe, il est possible de demander qu'un calcul assure qu'un pas particulier de l'algorithme est correct, ou exploiter les résultats.

MUSTIG permet de faire des simulations partielles. C'est à dire, vous ne devez pas lancer une simulation globale comme dans beaucoup d'autres langages de simulation graphiques : vous pouvez sélectionner une portion du graphe et calculer cette portion seulement.

Les éléments sur lesquels vous pouvez lancer une simulation sont les éléments terminaux : vous devez donc choisir une macro ou une fenêtre qui contient des élémentsterminaux. Les modules terminaux les plus courants, dont une liste partielle est montrée ci-dessous, se trouvent dans la section Sorties de la Bibliothèque :

Beaucoup d'autres modules terminaux sont disponibles dans la Bibliothèque : regardez leur aide en ligne (Alt+H) pour savoir leurs caractéristiques et comment ils doivent être utilisés.

Si vous voulez sélectionner une seule macro terminale, telle que Visu/t par exemple, clic gauche sur elle pour la sélectionner. L'élément sélectionné est encadré avec une ligne rouge plus épaisse.

Si vous voulez calculer plusieurs macros terminales simultanément, vous devez d'abord les entourer d'une clôture simple (voir Créer une boîte), et sélectionner cette boîte entière par clic gauche sur sa frontière ou sur un espace libre à l'intérieur de la clôture :

Pour créer une clôture, cliquez sur un coin de la clôture tirer et déplacez le curseur de la souris à l'autre coin, en encadrant toutes les boîtes que vous voulez inclure. Quand la dimension est OK, relâchez le bouton de la souris pour valider et créer la clôture. Pour effacer la clôture sans effacer les boîtes au-dedans, tirez-la par un coin et redimentionnez la afin qu'elle devienne minuscule : la clôture disparaît.

Vous pouvez sélectionner le contenu entier de la fenêtre par clic gauche sur un espace libre de la fenêtre. La frontière de la fenêtre est encadrée avec une ligne rouge plus épaisse.

Pour compiler le graphe en un code machine, MUSTIG commence à partir des éléments treminaux sélectionnés et va vers les opérateurs source en amont pour tâcher de déterminer quels modules sont impliqués dans le calcul des articles sélectionnés. Les parties du graphe qui ne sont pas impliquées dans le calcul demandé par l'utilisateur ne sont pas prises en considération.

Il est donc très important de noter que seulement la portion de graphe nécessaire pour calculer les modules sélectionnés sera compilée réellement et sera exécutée. Un exemple est montré ci-dessous :

Une fois que les éléments à calculer sont sélectionnés, sélectionnez la commande Calculer dans le menu Calculs : la boîte sélectionnée est calculée.

Vous pouvez aussi directement cliquer avec le bouton droite sur l'élément à calculer (un module, une macro, une fenêtre, une fenêtre image, une boîte tirée autour de plusieurs boîtes) : la simulation sera lancée. Ce raccourci est communément utilisé pour lancer une simulation et n'exige pas que la(les) boîte(s) à calculer soient sélectionnées en premier. Cliquez à droite sur la boîte à calculer, peu importe si c'est une macro seule, une clôture, ou une fenêtre.

En fait, un processus à deux étapes est invoqué quand vous demandez un calcul :

La portion du graphe qui est nécessaire pour calculer les résultats que vous avez demandés est déterminée et compilée en un code machine par le compilateur MUSTIG. La stratégie est basée sur le " coût " du calcul. Le processus de la compilation est très rapide (la plupart du temps vous ne le verrez même pas !), afin qu'utiliser MUSTIG soit vraiment confortable, même si vous devez lancer beaucoup de simulations.

Dans le cas de multiples boucles, l'ordre de ces boucles est choisi de manière à obtenir un volume de stockage minimum, indépendamment des boucles du graphe. Quelques résultats intermédiaires sont gardés pendant le calcul de manière à pouvoir les utiliser ensuite quand des modifications interactives du graphe seront exécutées.

Une fois que le processus de compilation s'est déroulé avec succès, le code produit est exécuté automatiquement et les résultats sont affichés.

Si la boîte sélectionnée est un module d'impression numérique d'un scalaire ou un vecteur, elle se remplit des valeurs adéquates.

Si des affichages graphiques sont impliqués, les fenêtres spécifiques s'ouvrent. Cependant, si les fenêtres graphiques calculées avaient été glissées précédemment sur des faces avant ou des fenêtres image , seulement ces images sont mises à jour : la fenêtre graphique originale ne s'ouvre plus.

Pour les longues simulations, l'avancement des calculs est montré en pourcentage à la place du menu Calculs sur la barre du haut de la fenêtre Mustig (PC & Mac). Sur les systèmes UNIX, l'avancement est indiqué par une barre graphique. Cela vous permet d'évaluer combien de temps les simulations prendront. Soyez conscient que cette estimation ne prend pas en considération les routines externes (DLLs) que vous avez pu inclure dans votre algorithme.

Si MUSTIG détecte une inconsistance en essayant de compiler le graphe en code machine, par exemple si vous essayez d'ajouter un signal de 256 points à un signal de 257 points, un message d'erreur est affiché, qui indique le type de l'erreur.

La partie erronée du graphe (boîte ou borne) est montrée. Si l'élément erroné est dans une macro non ouverte, vous devez ouvrir la macro sélectionnée (en tapant Ctrl+I par exemple, ou cliquant deux fois) pour obtenir une localisation plus précise de l'erreur, et ainsi de suite jusqu'à ce que le dernier élément soit sélectionné.

Plusieurs options peuvent être définies dans le menu Edition / Options / Calculs pour modifier le comportement de MUSTIG pendant les simulations.

Cette option contrôle la quantité de mémoire réservée pour manipuler les données pendant les simulations. La valeur par défaut est 0, signifiant que MUSTIG essaie d'estimer la mémoire par lui-même. Si une grande quantité de mémoire est exigée (par exemple si le message d'erreur Mémoire des données saturée est affiché pendant une simulation), mettez une valeur appropriée en Kilo-octets. Entrez-en 25000 pour réserver 25 Méga-octets de mémoire pour les données par exemple. Il est recommandé que la quantité spécifiée soit plus petite que la quantité de mémoire disponible, pour empêcher l'ordinateur de swapper.

C'est une des principales caractéristiques de MUSTIG : chaque fois que vous effectuez une modification sur une boîte, tout les modules en aval sont soit réinitialisés soit recalculés selon la valeur indiquée dans cette option.

Une petite valeur indique que seulement les modules qui ont besoin de brefs calculs seront mis à jour. Les modules nécessitant un plus long temps de calcul seront réinitialisés simplement.

D'autre part, une grande valeur indique que même les modules qui ont besoin de longs calculs seront mis à jour quand le graphe est modifié. Ce peut être maladroit si les simulations que vous faites sont longues et si vous devez encore modifier votre algorithme : le plus léger changement du graphe mènera à une longue simulation.

Une valeur particulière est 0 : aucun recalcul ne sera exécuté quand le graphe est changé. Tous les modules de l'aval seront réinitialisés simplement.

Cependant, si l'option Recalcul Automatique est cochée dans le menu Calculs, tous les calculs seront encore exécutés quand le programme sera modifié, quelel que soit la valeur de cette option.

Ce paramètre contrôle le type de code machine produit par le compilateur MUSTIG. Le temps d'exécution est souvent meilleur avec un paramètre de vectorisation maximal (2) mais la taille de mémoire requise est plus grande. Si la quantité de mémoire disponible n'est pas très grande comparée à la taille mémoire requise pour traiter les données, essayez de mettre ce paramètre à 1. Quelques programmes peuvent travailler seulement avec un paramètre de vectorisation égal à 1 .

Définit le montant de mémoire réservé pour le code compilé produit par MUSTIG. Essayez d'augmenter cette valeur si le message d'erreur Code trop grand se produit.

Définit la taille du tas (ou stack). Essayez d'augmenter cette valeur si le message d'erreur Compilateur Saturé se produit.

Si la simulation est faite sur un nombre fini d'échantillons, elle arrêtera d'elle-même finalement. Vous pouvez cependant arrêter la simulation avant achèvement en cliquant dans la fenêtre MUSTIG n'importe où.

Si la simulation est faite sur un nombre infini d'échantillons (longueur d'au moins un signal égale à -1 signifie simulation infinie), vous devez l'arrêter explicitement en cliquant dans la fenêtre Mustig n'importe où.

Quand le graphe est modifié à un endroit donné, le principe de MUSTIG est de garder en mémoire tout résultat en amont de façon à économiser le temps pendant le prochain calcul. La première borne en amont de la modification est considérée comme la nouvelle source. Cela veut dire que quand vous demandez encore un calcul, les modules en amont de la dernière modification du graphe ne seront pas recalculés :

Si vous avez réinitialisé seulement la macro Visu/t (voir Réinitialiser une boîte calculée) dans l'exemple précédent, ou si vous changez ses paramètres sans changer le graphe en amont, et puis demandez un recalcul, MUSTIG va seulement retracer le graphique sans recalculer les résultats.

C'est à dire, la sortie de la macro Traitement est gardée en mémoire quand la boîte Visu/t est réinitialisée, elle n'est pas recalculée.

Donc, si des modules dans votre application nécessitent d'être mis à jour avant chaque simulation (par exemple modules de gestion du temps, ou graines aléatoires si vous voulez obtenir un autre signal du bruit, etc), vous devez explicitement les réinitialiser (voir Réinitialiser une boîte calculée).

C'est une des principales caractéristiques de MUSTIG : chaque fois que vous effectuez une modification sur une boîte, tout les modules en aval sont soit réinitialisés soit recalculés selon la valeur indiquée dans l'option Edition / Options / Calculs / Seuil Temps pour recalcul automatique. Cette stratégie autorise un fonctionnement interactif, rapide et fiable car tous les calculs ne sont pas réexécutés à chaque demande et car les résultats visualisés dépendent toujours de l'état présent du graphe . Voir Seuil Temps pour recalcul automatique dans le chapitre des Menus pour une information plus détaillée.

Si nous n'insérons pas de nouveau module, mais simplement supprimons et reconstruisons le lien entre le module Gauss et le module d'impression, le comportement est le même : nous n'avons pas produit un autre nombre aléatoire et la " graine " n'a pas été modifiée. Donc, le nombre aléatoire produit est toujours le même !

Pour produire un autre nombre aléatoire individuel, nous devons réinitialiser la boîte Aléatoire explicitement. Cela est fait en la sélectionner et choisissant l'ordre Réinitialiser la clôture dans le menu Calculs.

Une conséquence de ce comportement dont vous devez être informé est que, si vous utilisez une macro Bruit/t dans vos applications, le signal du bruit reste inchangé jusqu'à ce que vous l'ayez réinitialisé en utilisantexplicitement l'ordre Réinitialiser la clôture