Comme on a vu dans le chapitre 2, chaque fil du graphe porte un signal qui, dans le cas le plus fréquent où ce n'est pas un scalaire seul, dépend d'une ou plusieurs variables. Le nom de la variable traitée par un module ou une macro est indiqué sur sa face avant. Il peut être édité et peut être changé en utilisant Majuscule+Ctrl+Cli pour traiter une autre variable.

Chaque variable (aussi appelée une dimension) est définie par sept paramètres ou attributs qui peuvent être changés en utilisant individuellement les modules de la section Changements de variables de la Bibliothèque :

Attention : Les indices de variables commencent à 0 comme dans le langage C.

Les Attributs qui n'ont pas de valeur par défaut (c.-à-d. nom et longueur de la dimension) doivent être définis quand on commence une nouvelle branche du graphe Mustig (voir Définir une variable).

Si un module exige au moins deux signaux à l'entrée, et si chacun de ces signaux dépend d'une variable avec le même nom, les caractéristiques des deux variables doivent être identiques.

Les variables peuvent être définies par l'utilisateur explicitement, ou automatiquement dérivées des caractéristiques d'une autre variable dans le graphe.

Bien que le module Valeur dans les Entrées de la Bibliothèque puisse entrer des valeurs scalaires, il peut être aussi utilisé pour définir commodément de petits vecteurs.

Pour cela, entrez les échantillons consécutifs le long de la dimension que vous voulez créer, en les séparant par un retour chariot, puis entrez le nom que vous souhaitez donner à cette nouvelle dimension sur la dernière ligne, juste après un signe ' / ' :

Dans l'exemple précédent, un vecteur est défini : il contient quatre éléments et la variable créée est nommée n. Le pas de l'échantillonage par défaut est 1 seconde, l'origine par défaut est 0 comme vu sur le graphe.

N.B. : Ce vecteur est regardé en utilisant la macro Visu/t standard : nous avons juste édité et changé le nom de la variable à traiter sur sa face avant (Majuscule+Ctrl+Clic), déplacé la fenêtre graphique sur la face avant pour commodité (voir Créer des images), et changé la ligne par défaut en une ligne rouge épaisse.

Vous pouvez créer une variable comportant un nombre d'échantillons quelconque en utilisant l'un des deux modules suivants :

Tout fil dans le graphe MUSTIG contient l'information entière au sujet des variables qu'il porte. Donc, il est possible de créer une variable ayant les mêmes caractéristiques qu'une variable précédemment définie en connectant simplement un fil à un emplacement où l'information est présente.

Cette technique peut être utilisée pour construire plusieurs signaux sur la même variable. Vous êtes alors sûr que vous pouvez ajouter, multiplier, etc. les signaux, car ils ont exactement les mêmes caractéristiques.

Exemple : Supposons que vous voulez ajouter un bruit et une sinusoïde. Vous pourriez construire séparément les deux signaux comme dans le graphe ci-dessous :

Cependant, si vous changez l'une des caractéristiques de l'un des signaux (par exemple le pas d'échantillonage), vous devez exécuter les mêmes changements sur l'autre signal, autrement vous ne pourrez pas les ajouter.

Donc, c'est beaucoup plus efficace de récupérer toute l'information sur la variable t directement sur un fil pour construire les signaux :

ou

Vous pouvez aussi récupérer l'information sur une variable et changer quelques caractéristiques avant de l'utiliser :

Dans l'exemple précédent, deux signaux contenant 100 échantillons chacun avec une fréquence d'échantillonage de 1Hz par défaut est créé. Une sinusoïde est construite sur ce t variable (sommet). Dans la branche inférieure du graphe le taux de l'échantillonage est changé dans 100Hz avant de construire la sinusoïde avec le même nombre d'échantillons.

Une variable est dite dynamique quand la longueur du signal selon cette variable dépend d'une autre variable. Les variables dynamiques peuvent être définies en entrant un vecteur de longueurs dans un module Partie ou Partie_décalée (voir Changer les attributs d'une variable dynamiquement).

Elles peuvent être aussi définies en utilisant directement le module Var_dyna/t dans la section Changements de Variables de la Bibliothèque :

Dans l'exemple précédent une variable dynamique nommée t est créée : sa longueur dépend d'une autre variable nommée x. Après le module Var_dyna/t, une sinusoïde de fréquence 0.1Hz est construite sur la variable dynamique créée. La sinusoïde est donc produite trois fois : une sinusoïde avec 64 échantillons, une avec seulement 32 échantillons et une avec 16 échantillons.

Noter que la macro de visualisation à deux dimensions Visu_2D_n/t/x permet de regarder des signaux portés par des variables dynamiques (la longueur des trois signaux affichés est différente). Dans l'exemple précédent, la fenêtre graphique a été glissée sur la face avant de la macro de visualisation pour créer une macro de prévisualisation (voir Créer une image). L'option Lignes composites individuelles a été choisie pour changer l'apparence des courbes individuellement.

Des modules spécifiques permettent de changer les caractéristiques d'une variable (ou dimension) individuellement. Ils sont localisés dans la section Changements de Variables de la Bibliothèque.

Le module ChVar/u/v dans la section Changements de Variables de la Bibliothèque permet de changer le nom d'une variable de u à v. Vous pouvez éditer bien sûr et changer les anciens et nouveaux noms des variables.

Dans l'exemple ci-dessous une variable de 100 échantillons nommée t est créée et une sinusoïde est construite sur cette variable. Le nom de la variable est changé en tau avant de construire une autre sinusoïde selon la variable tau . Excepté leur nom, les deux variables ont les mêmes caractéristiques.

La valeur à l'entrée sur la borne du haut du module Pas est le nouveau pas d'échantillonage du signal, c'est-à-dire, l'intervalle (en secondes si la variable /t est le temps) entre deux échantillons consécutifs.

La fréquence de la sinusoïde est en Hertz, afin que le résultat dépende de la fréquence d'échantillonage Fe du signal : dans la figure du haut la fréquence de la sinusoïde est Fe/10, dans la figure du bas elle est seulement Fe/1000.

Noter que la macro Visu/t montre des dates sur son axe horizontal, pas des indices.

L'origine d'un signal est la date (en secondes si la variable /t est le temps) associée au premier échantillon du signal. Elle peut être changée en utilisant le module de Origine dans la section Changements de Variables de la Bibliothèque :

Plusieurs modules existent pour changer le nombre d'échantillons selon une dimension. Ils permettent de sélectionner une partie d'un signal, ou augmenter sa longueur en ajoutant des zéros. Voir leur aide en ligne pour plus d'informations sur comment les utiliser.

Les attributs d'une variable sont généralement statiques : ils ne peuvent pas dépendre d'une autre variable.

Dans l'exemple ci-dessous, un vecteur de trois éléments selon la variable /x est ajouté à un vecteur de quatre éléments selon la variable /t .

Cette opération est valide parce que les signaux ont des noms de variable différents : la sortie de l'additionneur est donc une matrice selon les variables /t et /x. Cette dernière peut être regardée comme un ensemble de trois vecteurs selon la variable /t, les indices de la variable /x dénotant le rang d'un vecteur : 0, 1 ou 2.

Puis, nous essayons de définir un pas d'échantillonage différent pour chacun des trois vecteurs en utilisant le module Pas avec trois valeurs selon la variable /x : une pour chacun des trois vecteurs.

Bien que ce graphe soit logique, le module Pas n'acceptera pas d'entrée non scalaire sur sa borne du haut, car le pas d'échantillonage d'un signal ne peut pas dépendre d'une autre variable. Si vous essayez d'afficher la matrice après le module Pas vous obtiendrez le message d'erreur suivant : Les définitions de variables doivent être statiques.

Une exception à ceci est la longueur d'un vecteur : dans quelques cas elle peut être dynamique. C'est-à-dire, la longueur d'un vecteur peut dépendre d'une autre variable. En réalité, les modules Partie et Partie_décaléeacceptent des entrées scalaires et vectorielles :

Dans l'exemple précédent, le module Partie_décalée coupe des vecteurs de longueur variable (3,1 et 2 éléments) à partir des lignes de la matrice d'entrée 3x4 . Cette sortie du module est donc un ensemble dynamique de vecteurs : la longueur d'un vecteur selon la variable /t dépend de son rang selon la variable /x .

1. Quand on utilise le module Partie ou Partie_décalée dynamiquement, aucune valeur dans le vecteur de nouvelle longueur peut être plus grande que la longueur du signal de départ. C'est-à-dire, les modules Partie ou Partie_décalée ne peuvent pas rajouter des zéros à un signal quand ils sont utilisés dynamiquement. Ils peuvent le faire seulement quand ils sont utilisés avec un nouveau paramètre de longueur scalaire.
2. Le compilateur MUSTIG ne sait pas a priori la longueur du signal, car il est calculé dynamiquement. Par conséquent, un bloc de mémoire de même dimension que le signal d'entrée est réservé. Donc, vous ne devriez pas utiliser ce mécanisme dynamique pour extraire de petites parties d'un long signal : utilisez un module supplémentaire Partie en amont avec une valeur de longueur statique faible pour réduire la dimension de mémoire exigée.
3. Quelques modules et macros peuvent ne pas accepter de traiter des signaux dynamiques. Dans quelques cas, il peut être nécessaire de rajouter des zéros aux signaux jusqu'à une longueur fixe avant de les traiter, et de les couper après les avoir traités dynamiquement.
4. L'ordre dans lequel les opérations sont faites peut être important quand on travaille avec les variables dynamiques. Dans l'exemple ci-dessous, si vous voulez calculer la valeur maximale dans la matrice, vous devez calculer la valeur maximale selon la variable t en premier, et puis calculer la valeur maximale du vecteur obtenu selon la variable x . Si vous essayez d'utiliser un module Max/x directement sur la matrice dynamique, vous obtiendrez un message d'erreur, parce que le vecteur obtenu de valeurs maximales dépendrait de la variable t dont la longueur est dynamique :

Vous pouvez changer les attributs dual d'un signal si nécessaire (voit les attributs de variables pour savoir ce à quoiservent les attributs Dual) :

Cependant, cela est rarement fait explicitement, car l'information sur une variable créée par une Transformée de Fourier peut être reprise généralement directement.

Exemple : Supposons que vous vouliez créer un filtre passe-bas très simpliste en sélectionnant seulement les coefficients de Fourier de basse fréquence d'un signal. Au lieu de créer le gabarit du filtre séparément comme dans le graphe ci-dessous :

C'est beaucoup plus intelligent d'extraire l'information au sujet de la variable fréquence f à partir d'un fil après la Transformée de Fourier. Vous n'avez pas à vous soucier de calculer le pas de la fréquence ni de mettre les attributs Dual et Demis à un : tous les attributs sont mis à leur valeur correcte par la Transformée de Fourier.

Le graphe correct est plus compact, plus général, et plus facile à comprendre :

Par conséquent, vous pourrez généralement éviter de changer les attributs dual d'un signal explicitement en vous reliant aux fils appropriés sur le graphe.

Des modules supplémentaires sont disponible dans la section Changements de Variables de la Bibliothèque pour exécuter des opérations de base sur les variables, tels que:

• Sous-échantillonner ou sur-échantillonner un signal
• Extraire une valeur d'un vecteur
• Changer une valeur à un index donné
• Convertir indices en dates (et dates en indices)

Voir l'aide en ligne des modules décrits pour plus d'information sur comment ils opèrent et comment relier leurs bornes.

Les modules sont disponible dans la section Changements de Variables de la Bibliothèque pour le sous - ou sur - échantillonage d'un signal. Voir leur aide en ligne pour savoir comme ils devraient être utilisés.

Les modules sont disponible dans la section Changements de Variables de la Bibliothèque pour extraire un échantillon donné d'un vecteur. Voir leur aide en ligne pour savoir comment ils doivent être utilisés. Se rappeler : Dans MUSTIG comme dans C, le premier élément d'un vecteur est référé par l'index 0, et non 1.

Si l'index de coupe entré sur la borne du haut est plus grand que la longueur du signal, le résultat de la sortie est zéro.

Comme une seule valeur est extraite de la dimension entrée sur la face avant (par exemple /u sur les modules ci-dessus), les données de la sortie ne dépendent plus de cette variable. Si les données de l'entrée dépendent de deux variables ou plus, et une opération de " Coupe " est faite selon une dimension, l'opération de coupe est faite pour chaque occurence dur les autres dimensions.

Ici, le signal à l'entrée est une matrice. Si vous coupez un échantillon selon les lignes (variable /li ) vous obtenez une ligne de la matrice (selon la variable /co ), car l'opération de coupe a été faite sur chaque colonne.

D'autre part, si vous coupez selon la variable /co , l'opération de coupe est faite sur chaque ligne de la matrice et vous obtenez un vecteur égal à une colonne particulière de la matrice.

Dans quelques cas vous pouvez avoir besoin de changer la valeur dans un vecteur à un index donné. Vous pouvez faire ceci en utilisant directement le macro Ch_val/t dans la section Changements de Variable de la Bibliothèque. Dans l'exemple ci-dessous, la valeur du troisième élément du vecteur (index = 2) est changée en 200 :

Quand une variable est définie, un index de l'échantillon donné no est associé à une date donnée to en secondes qui dépend de l'origine et du pas d'échantillonage D t (les deux en secondes) fixés par l'utilisateur (voir Changer le pas d'échantillonage d'une variable) :

Quand vous exécutez des opérations telles qu'extraire une valeur d'un vecteur, sélectionner une portion d'un vecteur, etc., dans certains cas vous devez entrer les indices de(s) échantillon(s) sélectionné(s), et dans quelques autres cas vous devez entrer leur dates.

Les macros I - >V/t et V->I/t dans la section Changements de Variables de la Bibliothèque permettent de convertir respectivement des dates en indices , et indices en dates :

Pour certainesapplications il nécessaire de découper un signal en plusieurs parties plus courtes . Cela peut être fait automatiquement en utilisant le module Decoupe/t/b dans la section Changements de Variables de la Bibliothèque :

Un groupe de signaux à deux dimensions peut être recollé en un seul signal, plus long en utilisant le module Recolle/t/b disponible dans la section Changements de Variable de la Bibliothèque:

Vous pouvez découper un signal en plusieurs sous-signaux, en supposant que le signal original a été produit par un multiplexeur. Le module Demultiplex/t/p est disponible dans la section Changements de Variables de la Bibliothèque. Le module crée une nouvelle variable (/p dans l'exemple ci-dessous) lequel peut être considéré comme le numéro de canal après l'opération du demultiplexage :

Vous pouvez regrouper un groupe de signaux en un seul signal comme c'est fait par un multiplexeur. Le module Multiplex/t/p est disponible dans la section Changements de Variables de la Bibliothèque:

Après l'opération de multiplexage, le signal dépend de seulement une variable. Comme montré sur l'exemple précédent, l'ordre dans lequel les échantillons sont fondus dépend de l'ordre des variables (/x/t ou /t/x) fixé par l'utilisateur sur la face avant du module Multiplex.

Le macro Concatenate/t dans Changements de Variables / Opérations sur les vecteurs de la Bibliothèque permet de concaténer deux signaux selon la même variable.

Dans l'exemple précédent une sinusoïde de 5Hz de 100 échantillons est concaténée à une sinusoïde de 1Hz de 150 échantillons. Le résultat est un signal de 250 échantillons (=2.5 secondes ici).

Les deux signaux doivent avoir le même nom de variable et les mêmes attributs, mais leur longueur peut être différente.

Vous pouvez étendre la dimension du signal, c'est-à-dire, créer un vecteur à partir d'un scalaire, une matrice à partir d'un vecteur, un tenseur 3D à partir d'une matrice, et ainsi de suite, en utilisant le module " = " dans la section Changements de Variables de la Bibliothèque :

Une macro très utile est la macro Info dans la section Changements de Variables de la Bibliothèque. Quand elle est connectée à un fil, cette macro terminale fournit à l'utilisateur l'information générale sur les signaux portés par le fil : type de données, nom, longueur, origine, etc. des variables :

Si vous calculez le macro Info en cliquant à droite sur elle, une nouvelle fenêtre s'ouvre :

Elle indique que ce fil contient les données réelles de 4 octets (R4), décrites par deux variables /t (longueur 256 échantillons, pas d'échantillonnage 100Hz, origine 10s) et /gain (longueur 4, pas d'échantillonage par défaut 1Hz). Ce groupe de données peut donc être vu soit comme une matrice 4x256, soit comme un groupe de 4 signaux qui contiennent 256 échantillons chacun.

Si la longueur est affichée entre parenthèses, la variable correspondante est une variable dynamique : sa longueur dépend d'une autre variable. La longueur affichée est la longueur maximale de la variable.

Les boîtes en paquet sont utilisées pour construire des algorithmes qui traitent les éléments d'un vecteur individuellement, au lieu de faire les mêmes opérations sur tous les échantillons d'un vecteur. Bien qu'un grand nombre d'opérations soit proposé dans la Bibliothèque, vous pouvez vous-même construire des paquets si cela est requis par votre application.

Voir : Compacter le graphe en paquets ou boucles

Créer des boîtes en paquet

Comme un paquet est un processus qui fait référence à une variable, l'utilisateur doit fournir au paquet l'information sur la variable qu'il doit traiter. Cette variable peut être une variable existante, ou elle peut être créée exprès.

Si un signal n'est pas un scalaire, il porte l'information sur ses variables. Si un tel signal vient sur une borne latérale d'une boîte en paquet, et si le signal dépend de la variable de la boîte en paquet, l'information exigée aux calculs de la boucle est connue.

Par exemple, soit un signal une fonction de la variable t et calculons la somme des éléments de ce signal selon t. Le programme MUSTIG sera :

La variable de boucle est la même que celle apportée par le signal entrant. Cette variable est nommée /t et porte un signal de cinq échantillons. Donc, le paquet exécute cinq boucles, un pour chaque échantillon du signal de l'entrée, et donne la somme des éléments en conséquence.

Par conséquent, quand la variable sur laquelle vous voulez faire une boucle existe déjà, le graphe est assez simple à construire.

Si la variable de boucle n'est pas portée par un de ses signaux d'entrée, une variable spécifique doit être créée et doit être reliée à une borne latérale sur la frontière du paquet.

Pour ce faire, définissez la variable de boucle à l'extérieur de la boîte du paquet (voir Créer une variable), et créez un fil entre la sortie de cette définition de variable et une borne latérale de la boîte du paquet, pas déjà reliée (voir Créer une borne).

Supposez par exemple que vous voulez produire un vecteur fait des puissances consécutives d'un nombre donné : X={1,a,a2,a3,... ,aN-1}, où a est un scalaire. Une bonne façon de faire cela est de commencer avec une " graine " (a=3 par exemple), et la multiplier par elle-même un nombre donné N de fois.

Cela peut être fait facilement avec un paquet comme dans le programme ci-dessous (pour a = 3 et N = 5):

Comme vous commencez avec une graine scalaire (a), aucune variable n'est disponible pour faire une boucle. Cependant, vous devez dire au paquet combien de fois il doit faire la boucle ! Cela est fait en créant la nouvelle variable /x et la reliant à une borne latérale créée sur la frontière du paquet.

Cette variable /x a été définie mais elle ne contient pas de valeur, ce n'est pas un " signal ". Tout ce dont le paquet a besoin ici est sa longueur pour savoir combien de boucles doivent être faites. C'est pourquoi relier la borne latérale à un module de calcul à l'intérieur de la boucle n'est pas exigé.

Le résultat obtenu est pris de l'intérieur de la boucle. C'est donc un vecteur selon la variable de boucle /x . Il contient cinq échantillons qui correspondent aux valeurs portées par le fil à chacune des cinq itérations de la boucle (voir Compact le graphe en paquets ou boucles).