Les différents types d'erreurs

Localiser une erreur dans le graphe MUSTIG

Déboguer une erreur en utilisant le mode Sonde

Liste des messages d'erreur

LES TRUCS DE DEBOGUAGE

Trois types d'erreur sont possibles :

• Les erreurs de l'éditeur : se produisent immédiatement après une action (quelquefois seulement un signal sonore simple se produit)
• Les erreurs du compilateur : se produisent après qu'un calcul ait été demandé, quand MUSTIG essaie de compiler le graphe en code machine,
• Les erreurs à l'exécution : se produisent quand le code compilé s'exécute.

Si une opération invalide est exécutée par l'utilisateur (par exemple relier deux sorties ensemble), l'erreur est immédiatement récupérée par MUSTIG et un message d'erreur est affiché.

Si l'opération est valide mais ne peut pas être exécutée (par exemple glisser une image d'un module dans un panneau trop petit pour la contenir), un signal sonore se produit et l'opération est simplement annulée.

La plupart des erreurs du compilateur se produisent quand vous avez programmé une opération invalide, par exemple si vous ajoutez deux signaux qui n'ont pas les mêmes attributs, ou si vous reliez deux sorties ensemble.

Les erreurs du compilateur sont détectées généralement quand vous lancez une simulation. Cependant, les erreurs du compilateur qui mènent à un graphe contradictoire (par exemple deux sorties reliées ensemble, erreur dans un module Formule) sont détectées immédiatement.

Elles sont susceptibles de se produire à l'exécution. Voir la liste des messages d'erreur pour une liste complète.

Soyez conscient que MUSTIG ne vérifie que son propre code ! Si une erreur se produit dans une routine externe interfacée, elle produira des résultats imprévisibles et pourrait même planter l'ordinateur. Vous devez donc vous assurer de vérifier votre code source avec soin.

Le cas le plus fréquent d' " erreurs fatales mystérieuses " dans les routines externes est une faute de segmentation ou d'allocation mémoire qui se cache quelque part dans le code source.

Notre conseil : Protégez votre code (au moins les versions prototypes) en ajoutant des routines de vérification supplémentaires et retournez un message d'erreur à MUSTIG à travers le pointeur de chaîne r quand une erreur est détectée. En particulier, la valeur de retour de toute fonction d'allocation mémoire ou routine système devrait toujours être testée.

Quand MUSTIG détecte une erreur, la compilation ou l'exécution du programme s'arrête et le module dans lequel les erreurs se sont produites est montré avec un cadre rouge. Cliquez sur le bouton OK dans la fenêtre de sortie du message d'erreur pour commencer à déboguer votre application.

Si l'erreur est localisée à l'intérieur d'une macro, la macro est montrée avec un cadre rouge. Vous pouvez alors cliquer deux fois sur cette macro, et puis sur l'autre macro encadrée de rouge - jusqu'à ce que vous atteigniez finalement le module erroné.

Vous pouvez utiliser aussi le raccourci Alt+I pour ouvrir les macros sélectionnées successivement. Utilisant Ctrl+I au lieu d'Alt+I ferme la fenêtre mère à chaque fois qu'une macro est ouverte (Windows seulement).

Une fois que la portion défectueuse du graphe a été localisée, si l'erreur n'est pas évidente, vous pouvez vouloir en apprendre plus sur les données à ce point pour détecter l'erreur. Une bonne solution est d'utiliser le mode Sonde.

Le mode Sonde marche avec tout module, macro ou boîte qui a seulement une borne d'entrée et aucune borne de sortie. Tout groupe de modules peut être assemblé en une boîte qui a seulement une borne d'entrée et aucune borne de sortie, et puis utilisé en mode Sonde. La boîte ne doit pas être reliée au graphe.

Les boîtes d'exemple suivantes conviennent pour sonder le graphe :

Assurez-vous que la boîte n'est pas reliée au graphe, sélectionnez-la en cliquant dessus, et alors lancer la commande Calculs / Sonder (raccourci Alt+R). Le curseur de la souris se change en sonde. Cliquez sur un fil : la boîte Sonde sélectionnée est reliée au graphe implicitement et calculée. Cliquez sur un autre fil pour voir d'autres résultats.

Signification : Vous essayez de lancer Mustig avec un fichier clé Mustig5.cle invalide. Ce fichier doit être inclus dans le répertoire Mustig et ne doit pas être renommé. Les causes possibles sont :

• Mauvais numéro du dongle de protection
• Mauvais numéro de machine
• Date dépassée pour Mustig5.cle (pour les versions temporaires)

Solution : Verifiez que le numéro host_id de votre machine est égal au numéro de la machine dans le fichier Mustig5.cle. Verifiez que le dongle de la protection est présent. Verifiez que le fichier Mustig5.cle est présent dans le répertoire Mustig et n'a pas été renommé ou changé. Si vous utilisez une version temporaire, vérifiez la date dans le fichier Mustig5.cle.

Si cas tout paraît correct, contactez l'assistance LIS-INPG.

Signification : Erreur interne de Bibliothèque. Vous pouvez obtenir cette erreur si vous utilisez des macros de très vieilles versions de MUSTIG.

Solution : Si possible, remplacez la macro par une macro plus récente, équivalent. Si non, rapportez cette erreur à l'assistance LIS-INPG.

Signification : Vous essayez probablement de créer une macro, mais les noms de variables que vous avez entrés sur la face avant (afin qu'ils puissent être modifiés facilement) sont inconnus à l'intérieur de la macro. Donc, l'opération est annulée et les variables sont enlevées de la face avant de la macro.

Solution : Entrez en mode d'édition de texte dans la face avant (Majuscule+Ctrl+Clic) et entrez des noms de variables qui existent à l'intérieur de la macro.

Note : Une fois que la macro est définie correctement, vous pouvez changer un nom de variable pour s'adapter aux variables définies dans votre application :

Signification : Deux variables sont déclarées avec une longueur infinie. Cela n'est pas permis.

Solution : Changez votre programme afin que seulement une variable infinie soit utilisée.

Signification : Mustig ne peut pas ouvrir ou sauvegardr le fichier. La cause la plus commune est quand vous essayez de sauvegardr un graphe dans un répertoire dans lequel vous n'avez pas le droit d'écrire des fichiers.

Solution : Soit sauvegardez le graphe dans un autre répertoire en utilisant la commande Enregistrer sous... du menu Fichier, ou contactez votre administrateur système pour obtenir des droits de l'accès adéquats.

Signification : Vous essayez dde faire une opération sur un signal dont la longueur change dynamiquement une autre variable, et cette opération n'accepte pas de variables dynamiques. Le module Sous-echantillonne dans l'exemple ci-dessous est un de ces modules qui n'acceptent pas de variables dynamiques.

Solution : Utilisez des modules qui acceptent des variables dynamiques, ou changez votre programme pour (au moins temporairement) fixer la longueur des signaux. Cela est fait en sauvant les longueurs originales des signaux, ajoutant des zéros à tous les signaux jusqu'à la longueur maximale, traitant ces signaux de durée fixe, et enfin ramenant dynamiquement les signaux aux longueurs appropriées sauvegardées, comme dans l'exemple ci-dessous.

C'est une façon commune de surmonter les restrictions sur l'usage des variables dynamiques.

Signification : C'est une restriction sur l'usage de variables dynamiques. Vous essayez de faire une opération selon une variable qui contrôle la longueur des signaux, et cette opération n'est pas possible.

Dans l'exemple ci-dessous, on essaie de symétriser un groupe de signaux (t est le temps et n le nombre de signaux) dont la longueur change dynamiquement, pour renverser l'ordre des signaux dans le groupe (le premier signal devient le dernier, et ainsi de suite). Cette opération ne peut pas être faite parce que les signaux n'ont pas la même longueur.

Solution : Utilisez des modules qui acceptent des variables dynamiques, ou changez votre programme pour (au moins temporairement) fixer la longueur des signaux. Cela est fait en sauvant les longueurs originales des signaux, ajoutant des zéros à tous les signaux jusqu'à la longueur maximale, traitant ces signaux de durée fixe, et enfin ramenant dynamiquement les signaux aux longueurs appropriées sauvegardées, comme dans l'exemple ci-dessous.

C'est une façon commune de surmonter les restrictions sur l'usage de variables dynamiques.

Signification : La borne d'entrée montrée en rouge est nécessaire pour calculer le résultat, mais elle n'est pas reliée. Si la borne paraît connectée, alors la borne non reliée doit être recherchée en amont (ici dans la macro x16) :

Solution : Ouvrez la macro en amont jusqu'à ce que vous trouviez la borne non reliée, et la relier correctement.

Cette erreur peut se produire dans d'autres cas :

• Plusieurs bornes d'entrée sont reliées ensemble mais ne sont pas reliées à une borne de sortie
• Une borne d'entrée est reliée à un report esclave qui n'est pas associé avec un report maître. Vérifiez pour les faux espaces ou retour chariot suivant les noms des reports. Cela peut se produire en particulier dans le module de l'interface souris Choix . Soyez informé que le processus est sensible à la casse.

• Le nombre de bornes ou les étiquettes sur un faisceau sont inexacts. Soyez informé que les étiquettes sont sensibles à la casse :

Signification : Une erreur s'est produite quand on essaye de lire les données du disque.

Solution : Essayer encore de lire les données.

Signification : Vous essayez de glisser un opérateur sur la face avant d'une macro ou sur une fenêtre Image pour créer une image interactive de cet opérateur (voir Créer des images), mais l'opérateur n'appartient pas à cette macro, ou n'est pas dans le même graphe que la fenêtre image.

Dans l'exemple ci-dessous, cette erreur se produit si vous essayez de glisser un module de la macro Macro1 sur la face avant de la macro Macro2, ou inversement.

Solution : Créez des images de modules de la macro seulement, ou de sous - macros incluses dans la macro. Si vous voulez mélanger des images de modules de plusieurs macros, assemblez d'abord ces macros en une seule macro.

Dans l'exemple précité, vous pourriez créer une boîte pour encadrer Macro1 et Macro2 et taper Alt+M pour créer une " macro mère ". Vous pouvez alors glisser des modules de Macro1 et Macro2 dans la face avant de cette nouvelle macro.

Signification : Une Transformée de Fourier Rapide a été programmée (module TF/t/f), et donc la longueur de la variable devrait être une puissance de 2 à ce point du graphe.

Solution : Utilisez un module Partie ou similaire pour couper ou étendre la longueur du signal à une puissance de 2 - La macro Arrondi à 2**n dans la section Opérations Élémentaires de la Bibliothèque permet de calculer la plus grande puissance de deux la plus proche de la durée du signal.

Vous pouvez utiliser aussi les macros de Transformée de Fourier Discrète TFD dans la section Complexes de la Bibliothèque : elles n'exigent pas que la longueur du signal soit une puissance de 2. Cependant, elles sont beaucoup plus lentes que la Transformée de Fourier Rapide.

Signification : Une Transformée de Fourier Inverse Rapide (module TFI/f/t) est appelé. Donc, la longueur du signal devrait être une puissance de deux plus un (par exemple 129, 257, 513,...) si son attribut Demi vaut 1.

En particulier, c'est le cas si le signal est un signal complexe obtenu en calculant la Transformée de Fourier Rapide d'un signal réel, comme dans le filtre de passe-bas élémentaire ci-dessous. La Transformée de Fourier Inverse Rapide d'un tel signal est un signal réel.

Solution : Utilisez un module Partie ou similaire pour couper ou étendre la longueur du signal à une puissance de 2 plus un - La macro Arrondi à 2**n dans la section Opérations Élémentaires de la Bibliothèque permet de calculer la plus grande puissance de deux la plus proche de la durée du signal.

Vous pouvez utiliser aussi les macros de Transformée de Fourier Discrète Inverse TFDI dans la section Complexes de la Bibliothèque : elles n'exigent pas que la longueur du signal soit une puissance de 2 plus un. Cependant, elles sont beaucoup plus lentes que la Transformée de Fourier Rapide Inverse.

Signification : Le graphe ne peut pas être sauvegardé à cause d'une erreur interne.

Solution : Essayez d'effacer tour à tour les modules que vous avez ajoutés récemment au graphe, jusqu'à ce qu'il puisse encore être sauvegardé. Rapportez cette erreur à LIS-INPG.

Signification : Le compilateur MUSTIG ne peut pas traiter ce graphe. La cause vraisemblable est que le graphe a des dépendances circulaires plus complexe que celles détectées par l'erreurCercle Vicieux.

Solution : Modifiez votre programme pour supprimer les dépendances circulaires.

Signification : Le texte encadré en traits rouges montre une erreur de syntaxe. Cela peut se produire en entrant un texte d'interface dans le module Extern ou Fortran, en entrant une formule dans le module Formule, ou en écrivant un script de Batch.

Solution : Corrigez votre texte pour enlever l'erreur de syntaxe.

Signification : Vous essayez d'utiliser le mode Sonde (raccourci Alt+R) avec un module qui n'a pas les caractéristiques adéquates : seulement une borne d'entrée, et aucune borne de sortie :

Solution : Créez une boîte autour du module (Clic+Glisser), créez une borne sur la boîte (Majuscule + Clic), et reliez la borne à la borne d'entrée du module :

Cliquez à nouveau sur la boîte et tapez Alt+R pour utiliser le mode Sonde.

Signification : Quand un programme qui a été précédemment sauvegardé dans le format de Bibliothèque (ordre Enregistrer spécial) est ouvert pour la première fois, MUSTIG crée un fichier spécial avec une extension .bib. Cette erreur se produit si MUSTIG ne peut pas écrire ce fichier. Cela n'empêche pas MUSTIG de travailler correctement. La cause la plus commune est MUSTIG tournant sous Windows NT ou UNIX avec des droits d'accès non appropriés.

Solution : Lancez MUSTIG avec des privilèges de l'utilisateur corrects une première fois, afin qu'il puisse écrire les fichiers .bib dans le répertoire Mustig - Changer les droits d'accès de l'utilisateur dans le répertoire Mustig.

Soyez informé que si vous n'avez pas les droits d'accès adéquats, le fichier d'options Mustig.prf ne peut pas être sauvegardé : MUSTIG commencera toujours avec les options par défaut.

Signification : Vous essayez d'exécuter une opération selon une variable qui n'existe pas à ce point du graphe. Dans l'exemple ci-dessous, une variable nommée x est créée et on essaie de construire une sinusoïde selon une variable nommée t : c'est une erreur.

Solution : Changez le nom de la variable sur la face avant du module sélectionné (Clic sur le nom, ou Maj+Ctrl+clic si la boîte n'est pas verrouillée). Le nom sera changé dans toutes les sous - macros intérieures automatiquement. Aussi voir les trucs ci-dessous.

Tous les modules à l'intérieur de la macro Sinus/x qui précédemment a dépendu de la variable /t dépendent maintenant de la variable /x . Vous pouvez voir ceci en cliquant deux fois sur la macro deux fois :

Truc 1 : Si plusieurs noms de variables doivent être changés, effacez tous les noms de variables, et puis entrez les nouveaux noms dans le même ordre. Cela empêche de remplacer accidentellement deux variables par une seule :

Truc 2: Si vous voulez changer les variables qui peuvent être renommées sur la face avant (par exemple changer le nombre de variables qui peuvent être accédées par ce moyen) : effacez toutes les variables de la face avant et cliquez à l'extérieur de la boîte pour sortir. Alors, entrez en mode d'édition et entrez les variables auxquelles vous voulez pouvoir avoir l'accès :

Truc 3 : Si l'utilisateur renomme une variable sur la face avant dans le nom d'une variable interne (utilisée à l'intérieur de la macro mais pas présente sur la face avant), la variable interne est renommée en insérant automatiquement un signe "> " avant le nom pour éviter d'avoir des définitions de variables contradictoires.

Signification : Ce paramètre d'entrée doit être statique, c.-à-d. il ne devrait pas dépendre d'une autre variable. Un cas typique est quand on essaie de définir plusieurs pas d'échantillonage ou origines pour un signal (voir l'exemple dessous). Quelques modules de la bibliothèque ne supportent pas de variables dynamiques et produisent ce message quand utilisés avec des signaux dynamiques.

Solution : Modifiez votre graphe afin que la définition de variable devienne statique.

Signification : Deux bornes sont reliées dans une configuration qui n'est pas autorisée. Cela peut se passer en particulier quand on utilise des programmes créés avec de plus vieilles versions de MUSTIG. Une telle configuration invalide peut aussi être obtenue avec les faisceaux :

Solution : Insérez un " = " module (disponible dans la section Opérations Élémentaires de la bibliothèque) juste avant la borne en question.

Le module " = " ne modifie pas les données, mais agis comme un connecteur intermédiaire exigé dans de tels cas.

Signification : Trop de fenêtres sont ouvertes en même temps.

Solution : Fermez quelques fenêtres et quelques programmes MUSTIG inutilisés. Ce peut être nécessaire de sauvegarder le graphe après avoir fermé toutes les fenêtres, sortie de MUSTIG et relancer.

Signification : Une boucle est exécutée selon une variable (ici i variable dans la macro Somme/i), mais la longueur du signal change selon cette variable dynamiquement : cela n'est pas autorisé.

Dans l'exemple ci-dessous, l'erreur se produit parce qu'on essaie d'additionner selon la variable i trois signaux de longueur 100, 200 et 256 échantillons selon la variable t ce qui est impossible (vous ne pouvez pas additionner un vecteur de 100 échantillons et un vecteur de 200 échantillons !).

Solution : Changez le graphe afin que tous les signaux aient la même longueur, ou sommez selon une variable selon laquelle cette opération est valide.

Note : Sommer selon la variable t serait OK et produirait un vecteur (selon la variable i) de trois sommes.

Signification : Erreur interne.

Solution : Rapportez cette erreur à LIS-INPG. Si possible, email une copie de votre programme afin qu'il puisse être lancé avec un outil de déboguage.

Signification : Le graphe ne peut pas être calculé parce qu'il est circulaire. Cette erreur se produit fréquemment quand on oublie d'insérer un délai dans l'algorithme (ici un filtre du premier ordre).

Solution : Modifiez le graphe (par exemple en insérant un opérateur délai) pour casser la dépendance circulaire.

Signification : Une erreur s'est produite quand on essaye d'écrire les données sur le disque.

Solution : Essayez d'écrire à nouveau les données, ou écrivez-les sur un autre disque.

Quelquefois le graphe semble inconsistent, comme si un fil avait disparu :

Cela veut dire simplement que deux fils sont superposés. Comme l'opération XOR est utilisée pour manier la superposition, deux fils superposés sont tracés comme un fil invisible ! A partir de la version 5, les fils superposés sont tracés comme un fil seul, normal, ce qui rend aussi le graphe difficile à lire.

Juste placez le curseur de la souris sur le fil invisible et déplacez-le un peu pour séparer les fils  :

Sûrement les options d'impression ne sont pas correctes.

• Vérifiez que votre imprimante travaille correctement.
• Vérifiez les options dans le menu Fichier / Paramètres d'impression.
• Vérifiez les options dans la menu Edition / Options / Graphique : peut-être l'option est Imprimer dans un fichier .eps .

Quelques erreurs d'impression ont été observées avec quelques imprimantes, spécialement des imprimantes en réseau. Contactez le service d'assistance pour plus d'information.

Quelques applications n'acceptent pas le Copier/Coller de haute résolution. Si vous cochez Edition / Options / Graphique / Copie bitmap cela produit un bitmap qui est bien accepté généralement. Aussi essayez de changer l'option / Edition / Options / Graphique / Copier le tour .

Vous avez probablement cliqué à droite dans la fenêtre principale du programme MUSTIG : toutes les boîtes et sous - macros ont donc été calculées à la fois! Vous pouvez empêcher cela en cochant l'option Edition / Options / Ne pas calculer la fenêtre mère.

• Quand une modification est exécutée dans le graphe, les résultats sont mis à jour ou simplement sont réinitialisés, selon la valeur entrée dans le champ Edition / Options / Calculs / Temps pour recalcul automatique.

Une petite valeur indique que MUSTIG doit recalculer seulement les résultats qui ont besoin d'un bref temps du calcul, et seulement réinitialiser des résultats qui ont besoin de plus longs calculs. Pour un programme d'acquisition de données nous recommandons fortement de mettre cette valeur à 0, pour empêcher le lancement de l'acquisition par hasard quand une valeur d'entrée est modifiée.

• Si vous voulez que tous les résultats soient recalculés automatiquement, quel que soit le temps que cela prend, cochez le Recalcul Automatique dans le menu Calculs. Cette option ne devrait pas être utilisée quand on fait tourner des programmes d'acquisition de données.
• Vous pouvez mettre à jour une fenêtre ou une boîte manuellement en cliquant surRecalculer dans le menu Calculs.

Sûrement l'option Edition / Options / Graphique / Palette Noir & Blanc est validée. Videz le programme en cliquant sur la fenêtre principale du programme et lançant l'ordre Réinitialiser la clôture du menu Calculs. Puis, ouvrez Edition / Options / Graphique et changez l'option de la palette.

• Quand une fenêtre ou une boîte est verrouillée, vous ne pouvez pas faire glisser un module particulier de là pour l'amener ailleurs. Pour faire cela, soit,
• déverrouillez la boîte en utilisant le raccourci Alt+W,
• soit utiliser Maj+Clic au lieu de Clic pour faire glisser un module particulier.
• Si vous pouvez faire glisser le module mais si MUSTIG n'accepte pas de le déposer dans la boîte de la destination, cela veut dire que l'opération que vous essayez d'exécuter est invalide :
• Créer une image d'un module dans un panneau qui n'appartient pas à une de ses macros mères,
• Essayer de déposer une fenêtre image dans une macro au lieu de la fenêtre principale du programme,
• Déposer un module dans une fenêtre verrouillée,

MUSTIG ne peut pas écrire le fichier des options dans le répertoire MUSTIG : vous n'avez probablement pas les droits d'accès adéquats au répertoire MUSTIG.

Vous n'avez probablement pas les droits d'accès adéquats au répertoire MUSTIG.

Certaines options exigent que les programmes MUSTIG et la mémoire soient réinitialisés avant de les changer.

• Cliquez dans la fenêtre principale du programme MUSTIG pour la sélectionner et lancer l'ordre Réinitialiser la clôture du menu Calculs. Alors, essayez de changer à nouveau l'option.
• Si cela ne marche pas, essayez de fermer le programme et de le réouvrir.
• Si c'est encore inefficace, essayez de sortir de MUSTIG et changer les options avant d'ouvrir votre programme.
• Si l'option n'est pas encore acceptée, peut-être elle n'est pas valide : peut-être vous exigez plus de mémoire que disponible, ou peut-être l'option n'est pas supportée sur votre ordinateur. Contactez l'assistance.

Si les artéfacts graphiques paraissent dans une fenêtre MUSTIG quand on déplacer ou redimentionne une boîte, déplacez la fenêtre en bas de votre écran, lachez-la, et redéplacez-la à sa place originale pour forcer une mise à jour.

Vous pouvez aussi simplement redimentionner la fenêtre pour forcer la mise à jour, mais cela n'est pas recommandé quand la fenêtre est verrouillée.

Cela a été observé quelquefois (bien que rarement) : une courbe graphique est affichée avec un décalage aléatoire dans la fenêtre graphique, et donc seulement une portion de la courbe est visible.

Cela est généralement résolu en fermant la fenêtre et la recalculant. Dans quelques cas il est nécessaire de réinitialiser le programme, ou le fermer.

Si ce comportement est souvent observé avec votre application, contactez s'il vous plaît l'assistance et envoyez lui une copie de votre programme si possible.