Lors de l'installation de Msphinx sur votre machine, l'administrateur système a placé le fichier Msphinx.ad dans le répertoire système:

Vous avez aussi la possibilité de le modifier et de l'exécuter en local en utilisant la commande:

Dans les panels, utilisez le bouton de gauche de la souris pour sélectionner les options, activer les boutons ou pour pointer une position sur demande du logiciel.
Toute chaîne de caractères dans un éditeur peut être sélectionnée à l'aide du même bouton puis recopiée dans une autre fenêtre à l'aide du bouton central.

Un répertoire .Msphinx est créé sous votre répertoire principal ($home). Il contient différents fichiers d'initialisation des variables du logiciel. Dans ce répertoire .Msphinx se trouvent aussi les différents projets que vous avez créés, constituant votre base de données d'images. Si vous manquez d'espace disque, vous pouvez déplacer ce répertoire sur un autre disque et réaliser un lien symbolique sous votre $home ou utiliser l'option -home dans la commande de lancement. (Voir plus haut dans les remarques préliminaires)

Découpage des plans de données:

L'espace ainsi créé est virtuel; il ne sera créé, au niveau des ressources, qu'au fur et à mesure du remplissage des images. La taille (largeur, hauteur) définie n'est utilisée que comme maximum utilisable afin d'éviter des débordements intempestifs (elle peut être modifiée à tout moment). La profondeur (codage des données sur 8, 16 ou 32 bits) définie l'est aussi par défaut: elle sera figée lors du remplissage de la première image et sera de même type pour tout le plan (elle peut être modifiée à tout moment pour une profondeur plus grande afin d'éviter les troncatures des données).
L'utilisateur peut écrire une image n'importe où dans le plan; cependant pour faciliter le découpage d'un plan celui-ci peut contenir des cellules régulières ou irrégulières (sous-images) reconnues par le logiciel.

Attention:
Vous définissez un plan 2048×2048×32 en entier contenant 16 cellules 512×512.

Vous lisez une image dans la première cellule en haut à gauche (A). L'espace mémoire utilisé est alors de 512×512×4 octets.
Vous ajoutez une image dans la cellule adjacente de droite (B): l'espace utilisé devient 512×512×4×2 octets.
Maintenant, vous ajoutez une image dans la dernière cellule en bas à droite (C): l'espace utilisé devient 512×512×4×16 octets soit 16 Mo (les cellules restantes seront remplies à zero). En conclusion, les ressources mémoire augmentent en fonction de la taille du rectangle le plus petit, englobant l'ensemble des données.

Adressage mémoire dans les menus:

Dans les différents menus, la ``Widget'' la plus répandue concerne l'adressage de la mémoire, c'est à dire la définition de la zone qui contiendra l'image lue. Elle est composée de 3 objets:

• Un menu concernant le choix de la zone:

  ``Editor position'':

  Les 4 éditeurs (X, Y, Width, Height) seront utilisés. Un clic sur le rectangle vert remplit les éditeurs avec la taille réelle utilisée ou avec la taille virtuelle du plan selon les menus.

  ``Grid position'':

  On voit apparaître le découpage en cellules. Il suffit de cliquer sur une cellule pour l'activer.

  ``Mouse position'':

  L'utilisateur détermine, directement dans la fenêtre principale ou dans une fenêtre de zoom, une zone rectangulaire à l'aide de la souris. Les éditeurs seront remplis avec la positioin et la taille de la zone.

  ``Free contour'':

  Dans une fenêtre adressable, on va définir une zone non rectangulaire. Le bouton de droite permet de créer les différents points définissants le contour; le bouton de gauche est utilisé au dernier segment pour fermer ce contour.

• Un menu concernant les plans à utiliser:

  [``Red plane'']

  [``Green plane'']

  [``Blue plane'']

  [``RGB''] (les 3 plans à la fois)

  [``All planes''] (Tous les plans utilisés)

  [``Plane no''] Un plan ou une série de plans bien précis à entrer dans l'éditeur qui apparait.

• Un ensemble d'éditeurs définissant la géométrie de l'image, dans lesquels l'utilisateur peut entrer directement les valeurs désirées.

==========================================================

Chapitre 2
WORK ON

2.1  WORK ON->DEFINE PROJECT

Ce menu permet de définir un nouveau projet où seront rangés les structures des images et les plans de visualisation.
Deux options sont proposées:

• ``DATA PLANES AND WORK SPACE STORED ON DISK''
• ``DATA PLANES AND WORK SPACE WITH LINKS ACCESS''

2.1.1  Les données et le plan de travail sont stockés sur disque

Si ce choix est fait, la mémoire image de Msphinx passe sur disque sous forme de fichiers:

• un fichier par plan de données images
• 3 plans de 8bits pour la mémoire de visualisation
• un plan de (4+4) bits pour la mémoire masque et graphique.

2.1.2  Les données et le plan de travail sont accessibles par liens

Dans ce mode les images ne seront accessibles qu'en lecture. Il permet de charger rapidement une grande quantité de plans images. Le format des images doit être le plus simple, du type lignes colonnes, ne nécessitant aucun décodage.

S'il n'y a AUCUN lien actif, ce menu apparaît ; il va permettre d'associer une série d'images de même type à une série de plans.
Exemple de procédure à suivre:

• taper, dans l'éditeur plane no, le chiffre 1.
  Les images seront chargées à partir du plan 1
• sélectionner le type de données: 8,16,32 bits etc...
• si nécessaire, sélectionner ``Swap data'';
  Cette option n'est utile que pour les données codées sur 16 ou 32 bits.
  Si les données viennent d'un ordinateur de type différent du vôtre: (big-endian(HP, IBM), little-endian(DEC, PC)) (Si l'image est mal swappée, elle apparaîtra comme bruitée à la visualisation).
• entrer la géométrie (éditeurs ``Width'' et ``Height'') des images. Ces dimensions doivent être contenues dans la taille de l'espace plan préalablement défini.
• dans la fenêtre de sélection des fichiers, choisir votre répertoire d'images et cliquer sur la première image. Si la taille correspond bien à vos choix (Wight, Height, Deep), elle apparaîtra dans la liste des sélections. A ce stade vous pouvez sélectionner les images de trois manières différentes:
  1. une par une
  2. plusieurs à la fois (combinaison du clic à la souris et de la touche Control)
  3. cliquer ``Select all size matching file''

• activer ``Link selected files to planes''

Les images apparaissent alors dans la fenêtre principale.

Si un lien EXISTE déjà, le bouton ``DATA PLANES AND WORKS SPACE WITH LINKS ACCESS'' est remplacé par un bouton ``CREATE/ADD DATA PLANE LINKS''. Un menu apparaît avec les différents plans et les images utilisées. Trois choix vous sont offerts:

1. ``Clear all links and create new ones''
2. ``Add new links'' (Voir ci-dessus §2.1.2)
3. ``Cancel''

2.2  WORK ON->WORKSPACE GEOMETRY

Ce menu permet de définir ou de modifier l'espace de travail virtuel.
La liste des espaces déjà définis apparaît dans la liste en haut à gauche.
Le sigle C->(Current) indique l'espace utilisé.
Si vous avez plusieurs espaces définis, vous pouvez cliquer sur un autre espace: le signe P->(Pending) apparaît.
OPTIONS:

• Définition de l'espace de travail:
  ``Replace/Create workspace'' permet de créer ou de modifier un espace de travail.
  ``Apply this workspace'' permet de modifier la géométrie de l'espace existant en conservant les images.
  Si la mémoire contient des images, un panel de ``Warning'', montrant la mémoire utilisée, apparaît.
  Si la profondeur du nouvel espace est différente, les plans différents garderont leur profondeur initiale. Par contre, si la géométrie (Width, Height) diffère, les plans seront retaillés avec possibilité de perte de colonnes et lignes à droite et en bas. (Options du menu Warning ``do it'' ou ``cancel'')

• Définition des cellules:
  le bouton ``Clear all cells'' permet de repartir d'un espace vide de cellules.

  Cas de cellules irrégulières:
  Vous avez deux façons de fixer la géométrie d'une cellule:

  1. Taper la géométrie et la position de la cellule dans les éditeurs puis activer ``Create new cell''.
  2. activer le bouton ``fill with mouse'' puis dessiner en haut à droite dans la fenêtre ``espace courant'' la cellule avec le bouton gauche de la souris. puis activer ``Create new cell''.

  Pour modifier la géométrie d'une cellule: la sélectionner directement avec la souris dans l'``espace courant'' ou à l'aide des flèches de sélection des cellules, puis modifier sa géométrie dans les éditeurs, ensuite activer ``Replace current cell''.

  Cas de cellules régulières:
  Activer le toggle ``Regular grid''; puis taper la géométrie dans les éditeurs ex :
  

  X = 0 Y = 0 Width = 100 Height = 100

  puis activer ``Create new cell'': l'espace à partir du point (X,Y) est couvert d'une grille.
  

• Cas particulier:
  Deux grilles différentes régulières dans le même espace. Activer le toggle ``Regular grid'' puis taper la première géométrie dans les éditeurs ex:

  X = 0 Y = 0 Width = 512 Height = 512

  puis activer ``Create new cell''; cliquer sur la cellule en bas à droite puis activer ``Delete cell'' puis taper la seconde géométrie dans les éditeurs ex:

  X = 512 Y = 512 Width = 256 Height = 256

  puis activer ``Create new cell''.

2.3  WORK ON->SET VIEW PLANES

Ce menu offre 3 possibilités:

1. il permet de choisir l'un des 3 (ou les 3) plans servant à la visualisation, codés sur 8 bits et représentant les intensités Rouge, Vert et Bleu en mode vraie couleur ou représentant un index (0->255) dans une table codant les couleurs en mode fausse couleur. Un travail automatique important de transformation est réalisé lors du passage d'un plan de données à un plan de visualisation si les données de base ne sont pas codées entre 0 et 255.
   

   L'utilisateur peut affiner cette transformation linéaire par l'utilisation du menu ``Display->Enhance display''.
   

   Sélectionner dans la liste un plan (de 1 à 512), puis activer l'un des toggle ``Set Red'' ``Set Green'' ou ``Set Blue''. Si le plan choisi contient déjà une image (son nom est écrit à la suite du numéro du plan), et si la fenêtre principale est dans le mode du plan choisi (positionnée sur ``Blue''avec le toggle activé ``Blue'') ou si elle est en mode vraie couleur, l'image apparaît.

   Une fois le toggle sélectionné, (``Set Red'' etc...), il suffit de cliquer 2 fois sur un plan dans la liste pour l'affecter au plan visualisé.

2. il permet de détruire complètement un plan et de libérer les ressources correspondantes. Sélectionner dans la liste un plan puis activer le toggle ``Destroy'' (contrairement aux affectations, un seul plan peut être détruit à la fois).

3. il permet de modifier le type de données donc la profondeur d'un plan: sélectionner dans la liste un plan; activer le menu ``None'' et choisir une des options ``Unsigned char'', ``Signed char'' ...
   Le plan change de type. À partir de cette étape, il suffit de cliquer 2 fois sur un plan pour qu'il adopte le même type. Cette transformation est uniquement ascendante (8 bits ->16 bits ->32 bits); le type de données englobant les autres étant le ``Float'' 32 bits.

2.4  WORK ON->DEFINE VIEWPORT

Ce menu permet de définir rapidement les plans R, V, B ainsi qu'un sous-domaine de l'espace réel à visualiser (Zoom permanent).

• Couleur:
  Modifier, s'il y a lieu, les éditeurs ``Red'' ``Green'' ``Blue'' puis activer ``Apply''.

• Géométrie:
  Modifier les éditeurs ``X, Y, Width, Height'' directement ou par l'option ``Grid position'' ou ``Mouse position'' puis activer ``Apply''.

• L'option ``Fit view window'' détruit la proportionnalité largeur/hauteur de la zone sélectionnée par rapport au rapport largeur/hauteur de la fenêtre principale.

Chapitre 3
WINDOW

3.1  WINDOW->STANDARD WINDOW

Ce mode réalise un échantillonnage en lignes et colonnes de l'image réelle pour l'adapter à la taille de la fenêtre de visualisation en conservant les proportions de l'image de base.

Si l'image de base possède un quadrillage régulier ou si le plan graphique contient un quadrillage régulier, celui-ci pourra ne pas apparaître dans ce mode de visualisation. pour le voir, il faudra passer en mode Window->Scroll window.

3.2  WINDOW->SCROLL WINDOW

La visualisation est en pleine résolution mais vous ne voyez qu'une partie de l'image. Ce mode est facilité par un agrandissement maximum de la fenêtre principale de visualisation. Pour se déplacer, il faut utiliser les ascenseurs bas et droit (la zone rouge indiquant la zone où le déplacement sera immédiat) ou utiliser la petite fenêtre en haut à gauche de la fenêtre principale et cliquer dans la zone à visualiser. On peut également se déplacer dans cette petite fenêtre en maintenant le bouton de la souris pour déplacer la zone visualisée.

Deux modes de comportement existent dans ce mode:

• l'option de lancement ``-ScrollPage [taille de la page]'' englobe complètement l'espace de travail défini; la création de l'image sera plus longue mais tous les déplacements seront instantanés. L'image générée est une pixmap, transférée sur l'écran: celui-ci doit pouvoir supporter localement la taille demandée.
• l'espace de travail est supérieur à la taille de la page; Seule sera créée une image de la taille de la fenêtre sur l'écran. Les déplacements successifs entraîneront une recomposition de cette image; les déplacements seront donc plus lents.

3.3  WINDOW->REFRESH

Redessine la fenêtre principale.

3.4  WINDOW->MASK/UNMASK OVERLAY PLANE

Le plan graphique se superpose (``Overlay'') sur le plan image; cette option permet de le cacher ou de le faire apparaître.

3.5  WINDOW->CLEAR GRAPH PLANE

La partie du plan graphique contenant les graphiques (ajout d'annotations, par exemple) est réinitialisée à la couleur transparente.

3.6  WINDOW->CLEAR MASK PLANE

La partie du plan graphique contenant les masques (menu Edit->Pixel & mask §5.5) est réinitialisée à la couleur transparente.

==========================================================

Chapitre 4
FILE

Généralités:
Tous les menus d'entrées-sorties comportent les mêmes options de sélection pour les répertoires de travail et les mêmes options de sélection de la géométrie (espace, plan) des images.

• répertoire de travail:
  

  Le répertoire de travail est montré dans l'éditeur en haut de la fenêtre. Vous pouvez taper directement un nouveau répertoire dans l'éditeur ou utiliser la souris pour naviguer dans l'arborescence des fichiers Unix.

  Selection

  Charge le contenu du répertoire indiqué.

  ..

  Charge le répertoire directement supérieur.

  $home

  Charge votre répertoire principal.

  $cwd

  Charge le répertoire où Msphinx a été lancé.

  Pour sélectionner un fichier, vous pouvez taper son nom dans l'éditeur ``file'' ou cliquer sur son nom dans la liste des fichiers.
  L'éditeur ``File name filter'' vous permet de placer en tête de liste tous les fichiers contenant la chaîne de caractère spécifiée.
  ex:
  

  	vous tapez:	vous obtenez en tête de liste:
  	*data	tous les fichiers finissant par ``data''.
  	data*	tous les fichiers commençant par ``data''.
  	*data*	tous les fichiers ayant ``data'' dans leur nom.

• L'espace de travail:
  Voir précédemment (page pageref) le détail de l'adressage mémoire dans les menus.

• File->Simple file read
  Si vous sélectionnez une image mais que l'espace de travail est en vraie couleur, l'image sera dupliquée dans les plans ``Red Green Blue''.

• File->Tiff Gif Jpg ppm (etc...) read
  

  Vous sélectionnez une image vraie couleur (par exemple en format Tiff ou jpg).
  

  • Si votre espace de travail est en vraie couleur les trois plans seront chargés
  • Si votre espace de travail est Red, Green ou Blue ou un plan quelconque, l'image sera transformée en une image d'index associée à une table couleur (image et table seront chargées dans le plan de travail), le résultat restituant ``au mieux'' l'image d'origine codée sur 16 millions de couleurs.

  Vous sélectionnez une image fausse couleur (index + table couleur) (par exemple en format gif ou tiff).

  • Si votre espace de travail est en vraie couleur, l'image sera transformée en trois plans Red, Green, Blue et les trois plans de travail seront chargés
    
  • Si votre espace de travail est Red, Green ou Blue ou un plan quelconque, image et table seront chargées dans le plan de travail.

4.1  FILE->SIMPLE FILE READ

En sélectionnant un fichier dans la liste, deux solutions s'offrent à vous:

• soit le logiciel est capable de déterminer la taille. En effet, les types et les tailles d'images déjà lues sont enregistrés dans un fichier (``sphinx_fmt'' sous $home/.Msphinx). Si Msphinx reconnait l'image, les caractéristiques seront affichées dans la fenêtre en bas à gauche et il suffira d'activer ``Load''.
• soit il faut décrire la structure de l'image dans le menu ``Format descriptor'' (voir le §4.1.2).
  

4.1.1  Description des options générales:

• ``fit size to cell''
  Si cette option est activée, l'image sera agrandie ou réduite à la taille choisie pour la visualisation (éditeurs ``Width'' et ``Height'' ou leurs valeurs par défaut), tout en gardant son facteur de proportionnalité.
• ``No rotation''
  Ce menu est un menu à choix multiple qui permet de réorienter l'image:
  • No rotation
  • Up side down
  • Left side right
  • Up/down & Left/right

• ``Enhance display image''
  
• ``8 bit (Unsigned)''
  Ce menu permet de préciser le type des données:
  • 8 bit (Unsigned)
  • 8 bit (Signed)
  • 16 bit (Unsigned)
  • 16 bit (Signed)
  • Integer (32 bit Unsigned)
  • Integer (32 bit Signed)
  • Float (32 bit)
  • Free Format Cette option permet de lire des images dont les pixels sont codés de manière particulière. Ce codage est décrit dans le menu ``Format descriptor'' voir le §4.1.2

• ``Format descriptor''
  appelle le menu de description du format de l'image dans le cas où celle-ci ne serait pas reconnue ou mal reconnue (voir le §4.1.2).
• ``Image preview''
  appelle un menu de sélection qui permet d'extraire une zone à lire dans l'image (voir le §4.1.3).

Le rectangle vert, en bas à droite, contiendra un aperçu de l'image une fois la lecture terminée.

4.1.2  Descripteur de format

Ce menu permet une description détaillée de l'image.

• Actions à la lecture (``Pixel value selection'').
  Les options suivantes permettent de modifier les valeurs des pixels décodés.
  • ``Cut values''
    Permet d'écrêter les valeurs des pixels:
    Les pixels dont la valeur est inférieure au ``minimum'' sont ramenés à ce minimum; ceux dont la valeur est supérieure au ``maximum'' sont ramenés à ce maximum.
  • ``Best (Min,Max)''
    Une recherche automatique est réalisée: 1% des pixels donne le minimum et 99% des pixels donne le maximum.
  • ``Mask value''
    réalise un filtrage des données:
    exemple: si mask=``00ff'' alors l'opération ``pixel & 00ff'' est réalisée et les bits de poids fort (> 255) sont supprimés.

• Dans le cas de fichier contenant plusieurs images ``Image bands description'':
  
  

  dans le cas de fichier ``Interleaves'', ``Band nr'' est le nombres d'images différentes contenues dans le fichier. Il faut alors préciser le format d'enregistrement (lignes ou colonnes).
  Par exemple pour 3 canaux rangés en ligne:
  

  ligne1	...	data	...	(canal1)
  ligne1	...	data	...	(canal2)
  ligne1	...	data	...	(canal3)
  ligne2	...	data	...	(canal1)
  ligne2	...	data	...	(canal2)
  ligne2	...	data	...	(canal3)

  il faudra indiquer ``Band nr''=3 et sélectionner ``In row''.
  ``Band selection'' est le numéro du canal à extraire.

• Description du fichier proprement dit (``File description'').
  
  

  3 éditeurs:

  • Lines [default]: nombre de lignes de l'image
  • Columns [default]: nombre de colonnes de l'image
  • Header length: longueur (en octets) de l'en-tête du fichier (zone à sauter au début du fichier avant de trouver la première ligne)

  Le ``[default]'' est la longueur de la ligne ou de la colonne que Msphinx  a apparemment reconnu. N.B. Le ``Trailer'' du fichier n'est pas décrit, puisque inutile.

• Description d'un enregistrement (``Record description'').
  Dans un enregistrement de base:
  • Header size: taille de l'en-tête de l'enregistrement
  • Trailer size: taille de la zone à sauter en fin de l'enregistrement
  • Length: longueur de l'enregistrement, ``Header size'' et ``Trailer size'' compris

  Toutes les tailles sont exprimées en octets.

• Description d'un pixel dans le cas d'une lecture en ``Free format''.
  Cette option est accessible en activant l'onglet triangulaire en bas de la fenêtre.
  4 éditeurs:
  

  Pixel length	Block length
  Header	Trailer

  Toutes les longueurs sont exprimées en bits.

4.1.3  Image preview

Le menu ``Sphinx_read_preview'' peut être agrandi pour améliorer la définition de l'image prévisualisée.

Ce menu permet d'échantillonner une zone de l'image d'entrée. Pour cela il faut, soit remplir les éditeurs à la main (Line start, end et step), (Column start, end et step), soit utiliser la souris (cliquer sur ``Mouse selection''). L'option ``Rebuild'' reconstruit l'image sélectionnée. Quand le choix de la sélection est correct, il suffit d' activer ``Load'' du menu ``Sphinx_read_on_display'' pour charger l'image.

4.2  FILE->TIFF GIF JPG PPM READ

Ce menu a pour but le décodage de fichiers-images normalisés. Le bouton ``Show matching files'' permet de balayer un répertoire et de n'en sélectionner que les fichiers visualisables.
Ils sont présentés sous la forme : [logiciel de visualisation] fichier.
Dans l'exemple:

La fenêtre ``Directory content'' permet la sélection d'un ou de multiples fichiers de types différents; dans ce cas, plusieurs visualiseurs externes vont être exécutés et plusieurs images vont être chargées dans les plans de travail.

Si l'espace de travail sélectionné est unique (Red ou Green ou Blue) les images s'écrasent les unes après les autres. Si l'espace de travail sélectionné est ``Plane no'' avec un no de plan de 1 à 511, le numéro du plan sera incrémenté à chaque image et toutes les images lisibles seront chargées dans les mémoires de travail.

4.3  FILE->HDF READ

Lancement du module externe de lecture des fichiers au format HDF (Hierarchical Data File).
Ce logiciel, HDFLook , a son propre manuel. Il permet de générer ou de modifier un projet existant et d'ajouter des images dans les plans de travail de Msphinx .

4.4  FILE->SATELLITES->POLDER

Lancement du module externe de lecture des fichiers POLDER.
Ce logiciel représente un bel effort pour simplifier l'analyse et la visualisation de données complexes définies dans un format où rien n'a été fait pour optimiser les accès à un paramètre précis. Il s'appuie fortement sur des logiciels réalisés précédemment Mgraph et HDFLook .
Tous ces logiciels ont leur propre manuel.
Mpol permet de générer ou de modifier un projet existant et d'ajouter des images dans les plans de travail de Msphinx .

4.5  FILE->LUT READ

Ce menu permet d'ajouter des tables de fausses couleurs personnalisées aux tables de base du logiciel. Elles seront ensuite disponibles dans le menu ``Color->More palettes->user lut base''. Le fichier doit être de type ASCII dans le format: pixel no (0-255), intensité de ``Red'', ``Green'', ``Blue'' (0-255)

exemple d'une table en niveaux de gris:

Après avoir sélectionné le fichier, activer le bouton ``Load'' qui vérifie le format du fichier. Un éditeur ``Base lut name'' apparaît; taper le nom de la palette qui sera visualisée dans la base puis activer ``Save on base''.

4.6  FILE->ASCII FILES

Ce menu permet de décoder des fichiers ASCII représentant des données particulières:

• surface X,Y,Z ou simplement Z
• fichiers de tracé de lignes, symboles et textes
• Champs de flèches

4.6.1  Création d'une image à partir d'un fichier ASCII de points.

• ``(Z) Regular grid''
  Il s'agit d'un fichier de valeurs représentant les points d'une surface sur une grille régulière.

  La surface finale aura la taille de l'espace de travail défini par l'adressage mémoire (X, Y, Width, Height). La surface sera, soit interpolée par des triangles, soit par le ``Nearest pixel interpolation'' si cette option est activée. Si des trous (zones sans résultats) apparaissent dans l'image finale, la valeur ``Region distance factor'' devra être incrémentée.

  les éditeurs :

  • ``numbers of columns'' précise le nombre de colonnes du fichier ASCII (optionnel)
  • ``Number of lines'' précise le nombre de lignes (optionnel)
  • ``Lines to skip'' indique le nombre de lignes à sauter au début du fichier
  • ``Undefine value'' indique un nombre particulier représentant un masque et ne devant pas être utilisé dans les interpolations.

  Activer `` Load''; la surface apparaît dans la zone sélectionnée.

• ``(X Y Z) Regular or Irregular grid''
  Les données sont représentées sous la forme une valeur de X de Y puis de Z.

  Les mêmes options que pour la ``Regular grid'' existent avec 3 éditeurs de positionnement supplémentaires: ``X column, Y column, Z column'' qui permettent d'extraire un champ particulier.

  Activer `` Load''; la surface apparaît dans la zone sélectionnée.

4.6.2  Tracés de lignes, de symboles ou de textes

• ``Plot (X Y) file''
  Un fichier ASCII permet de réaliser des tracés simples dans le plan graphique. L'espace final a la taille, en pixels, de l'espace de travail défini par l'adressage mémoire.
  ATTENTION: Le point origine du tracé se trouve en bas à gauche de l'espace de travail défini. Un exemple de fichier est donné dans le répertoire:
  DEVEL_DOCUM/TUTOR_MSPHINX/IMAGES/ASCII ASCII_DRAWING
  • Format du fichier:
    La géométrie de tracé peut être introduite dans les éditeurs ``Field geometry'' (X min, Xmax, Y min, Y max) dans les unités des X, Y à tracer.
    Le fichier ASCII le plus simple est une série de valeurs X, Y tracées avec la couleur sélectionnée (Menu ``Red'') et l'épaisseur dans l'éditeur ``line width''

  • Format des directives:
    Des directives peuvent être introduites dans le fichier: les lignes du fichier commençant par le caractère # seront considérées comme des commentaires; le caractère \ signale que la ligne suivante est la suite de cette ligne.
    Le mot ``Break'' permet de rompre la continuité d'une courbe.
    Le mot ``NewCurve'' permet de changer de courbe. Le numéro servant de référence à la courbe est incrémenté automatiquement à chaque nouvelle courbe créée.
    Ce numéro est utilisé dans l'option ``LineStyle'' (``Curve='').
    

    Verbose
    XLimits	MINIMUM=-1 MAXIMUM=-1
    YLimits	MINIMUM=-1 MAXIMUM=-1
    LineStyle	CURVE=1 STYLE=Solid COLOR=Black THICKNESS=1
    PlotText	X=0 Y=0 FONTNO=1 FOREGROUNDCOLOR=Black BACKGROUNDCOLOR=White BORDERTHICKNESS=1 TEXT="text to plot"
    PlotMark	X=0 Y=0 COLOR=Black STYLE=BigDot SIZE=1
    PlotBox	X1=0 Y1=0 X2=0 Y2=0 COLOR=Black STYLE=BigDot THICKNESS=1
    PlotLine	X1=0 Y1=0 X2=0 Y2=0 COLOR=Black STYLE=Solid THICKNESS=1
    PlotArrow	X1=0 Y1=0 X2=0 Y2=0 COLOR=Black STYLE=Solid THICKNESS=1

    Color :

    Red Blue Magenta Black Green Forest Sienna Yellow Coral Violet Plum Cyan Turquoise

    LineStyle :

    Solid NoLine MicroDash SmallDash Dash LongDash DashDot LineDot

    MarkStyle :

    NoMark BigDot SmallDot Cross X Square Diamond TriangleUp TriangleDown Circle FSquare FDiamond FTriangleUp FTriangleDown Fcircle

  • Exemple de fichier:
    

    # as first character comments the line
                    #Verbose
                    Xlimits  Minimum=1 Maximum=2.875
                    Ylimits  Minimum=5.148 Maximum=174.8
    
                    #  curves are separated by the word NEWCURVE
                    # inside a curve:
                    #               -the word BREAK interrupt the plot
                    #               -a word with a color name modify the current color style
                    # in the command LINESTYLE:
                    #               -if CURVE=-1 (apply to all curves)
    
                    LineStyle Curve=1 Style=MICRODASH Color=YELLOW Thickness=2
    
                    PlotText X=1.08  Y=170 ForegroundColor=BLACK BackgroundColor=WHITE FontNo=0 \
                                           BorderThickness=2  "CONTOUR DRAWING"
    
                    PlotMark Color=RED Style=FDIAMOND Size= 6 x=2.552 y=150.673
    
                                          1.45781 57.8183
                                          1.46869 57.3763
                                          1.59857 50.015
                                          1.61742 48.9019
                                          1.75384 43.2077
                                          ...
                                          Break
                                          1.57157 107.341
                                          1.5755 107.437
                                          1.6927 110.763
                                          1.7308 111.119
                                          1.80193 113.415
                                          ...
                                          NewCurve

• ``Arrow field (X,Y,Ro,Teta)''
  Tracé d'un champ de flèches définies par la position de départ, le module et l'argument.
  La géométrie de tracé peut être introduite dans les éditeurs ``Field geometry'' (X min, Xmax, Y min, Y max) dans les unités des X, Y à tracer; elles correspondent, en pixels, à l'espace de travail défini par l'adressage mémoire. Trois options sont possibles: la couleur, l'épaisseur du trait et un facteur arbitraire ``Length factor'' permettant d'ajuster les longueurs des flèches au tracé.

4.7  FILE->WRITE

Rappel: Les programmes d'écriture ci-dessous s'appliquent soit aux plans de données, appelés égalent plans de TRAVAIL, (qui sont de taille et de profondeur quelconques, voir page 1), soit aux plans de VISUALISATION (3 plans de 8 bits de profondeur associés à une table de couleur, voir §2.3).

Les formats Jpeg, Tiff et Gif sont utilisés en général pour de la visualisation. Ils s'adressent donc particulièrement aux plans de VISUALISATION.

Les autres formats (HDF et simple) permettent de sauvegarder les plans de TRAVAIL dans un format quelconque.

4.7.1  File->WRITE->Simple file write

Permet d'enregistrer des fichiers sur disque à partir des images archivées dans les plans DE TRAVAIL. Si les plans à écrire sont ``RGB'' les fichiers générés auront un nom de la forme : myfilename.R ,myfilename.G ,myfilename.B Si les plans à écrire sont : ``All planes'' les fichiers générés auront un nom de la forme : myfilename.P001, myfilename.P002 etc... Dans le cas général le nom est celui écrit dans éditeur ``File''.

4.7.2  File->WRITE->Tiff Gif Jpg Ppm write

Permet de générer des fichiers disques à partir des images archivées dans les plans de VISUALISATION en 8 bits avec les tables couleur associées.
Il permet également d'ajouter un bandeau de couleur, avec du texte, autour de l'image (Add a frame).

4.7.3  File->H.D.F. Write

Permet de créer ou d'ajouter des fichiers au format HDF (Hierarchical Data File), soit à partir des plans de données en créant des fichiers SDS (Scientific Data Set) soit à partir des plans de visualisation en créant :

• des fichiers images associés à une table de couleur pour les plans simples
• des fichiers images vraie couleur (3 plans de 8 bits représentant les intensités de rouge, vert, bleu de l'image, mode RGB).

4.7.4  File->Write LUT in user's lut base

Ce menu permet de sauver dans un fichier le contenu de la LUT (Look Up Table) utilisée dans la visualisation des images en mode plan simple (Red, Green or Blue). Le format est: pixel no (0-255), intensité de "Red", "Green", "Blue" (0-255)

exemple d'une table en niveaux de gris:

4.8  FILE->MPEG ANIMATION

Création d'une animation en format mpeg à partir d'images consécutives chargées dans les plans de travail, ceci indépendamment de la taille des images d'origine.

Au lancement du menu la fenêtre ``Sphinx_zoom'' apparaît. Cette fenêtre représente exactement la zone qui sera animée et la taille de l'animation.

• [étape 1] activer ``Select area'' dans la fenêtre ``Zoom''; puis sélectionner tout ou partie de l'image dans la fenêtre principale. Ajuster la taille du zoom en fonction de la taille de l'animation finale que vous désirez.
• [étape 2] remplir les éditeurs ``Fisrt plane'' ``Last plane'' avec le début et la fin de l'animation
• [étape 3] Activer ``Same lut for all frames'' si vous voulez une table de conversion couleur identique pour toutes les images.
• [Remarques] si votre série d'images a été obtenue par lecture d'image tiff, gif, jpeg, chaque plan a été chargé avec sa propre table de conversion couleur; aussi il faudra désactiver l'option ``Same lut for all frames'';
  deux éditeurs permettent dans le cas d'une série d'images nécessitant une convertion (data ->table de couleur) de fixer les mêmes extrêmes pour l'ensemble des images. Le minimum sera vu au niveau zéro de la table de couleur, le maximum au niveau 255 de la table de couleur.

Vous pouvez insérer, en tête de l'animation, une image de même taille saisie sur votre écran: Par exemple: lancer ``Print&Settings->XFIG tools'', taper un texte dans la page XFIG, exécuter ``Grab an image as first frame'', encadrer votre texte, appuyer sur un bouton de la souris, l'image est saisie.
Exécuter ``Show (run a few frames)'';
si le résultat vous convient:
Exécuter ``Create the final animation'', le fichier mpeg est créé avec le nom introduit dans éditeur ``Output mpeg file name''.

Quelque options suppplémentaires sont disponibles. Elles représentent les données d'entrée du programme mpeg_encode qui permet de générer l'image finale:

                											PSEARCH_ALG <algorithm>
                											     algorithm must be one of {EXHAUSTIVE, TWOLEVEL, SUBSAMPLE,
                											     LOGARITHMIC}.  Tells what kind of search procedure should be
                											     used for P-frames.  Exhaustive gives the best compression,
                											     but logarithmic is the fastest.  You select the desired
                											     combination of speed and compression.  TWOLEVEL is an
                											     exhaustive full-pixel search, followed by a local half-
                											     pixel search around the best full-pixel vector (the PIXEL
                											     option is ignored for this search algorithm).

                											BSEARCH_ALG <algorithm>
                											     algorithm must be one of {SIMPLE, CROSS2, EXHAUSTIVE}.
                											     Tells what kind of search procedure should be used for B-
                											     frames.  Simple means find best forward and backward
                											     vectors, then interpolate.  Cross2 means find those two
                											     vectors, then see what backward vector best matches the best
                											     forward vector, and vice versa.  Exhaustive does an n-
                											     squared search and is EXTREMELY slow in relation to the
                											     others (Cross2 is about twice as slow as Simple).

                											IQSCALE <n>
                											     use n as the qscale for I-frames

                											PQSCALE <n>
                											     use n as the qscale for P-frames

                											BQSCALE <n>
                											     use n as the qscale for B-frames

                											

Vous trouverez également le manuel de l'encodage MPEG en annexe B.

4.9  FILE->GIF ANIMATION

Création d'une animation en format Gif à partir d'images consécutives chargées dans les plans de travail, ceci indépendamment de la taille des images d'origine.

Voir le détail au paragraphe précedent: ``Create an Mpeg animation''.

4.10  FILE->SPINNING GLOBE

Création d'une animation en format GIF, c'est à dire directement utilisable dans les présentations des pages Web. Cette animation permet de faire tourner un globe représentant, par exemple tout ou partie de la terre à partir d'une image de taille quelconque chargée dans un plan de travail.

étape 1 Sélectionner la zone et le plan de travail à l'aide des menus éditeurs placés en haut à gauche.
étape 2 Dans la partie du menu appelée ``From geometry'', sélectionner la géométrie de la zone sélectionnée en degrés
étape 3 Choisir la taille de l'animation finale en pixels ``Icon size''. Au plus la taille est grande, au plus le fichier final sera important et donc le transfert sur le Web long.
Déterminer le décentrage en degré latitude et longitude. Déterminer le nombre d'images à générer.
étape 4 Dans la partie ``Addings'', si l'on veut tracer des grilles, choisir la géométrie en longitude, et latitude et le pas, choisir la couleur et activer ``Add grids''.
Si l'on veut ajouter un fond de carte, choisir sa couleur et activer ``Add earth map''.
étape 5 taper le nom du fichier à générer.

Activer ``create the icon file''

==========================================================

Chapitre 5
EDIT

5.1  EDIT->PIXEL VALUES

Permet d'éditer les valeurs des pixels d'une petite zone 3×3 ou 5×5 ou 9×9. Il suffit de cliquer dans l'image pour changer de zone. Les valeurs sont éditables en décimal, hexadecimal ou binaire. L'option ``Show all banks'' change la visualisation des valeurs en un mode représentant une ligne par plan de données. ex: (seuls les plans 1 2 3 5 6 7 contiennent des données)

                											           b= Red[ChU] x=  450 y=  488 v=      92 mean 3X3 =   103.7
                											           b= Gre[ChU] x=  450 y=  488 v=      77 mean 3X3 =    82.3
                											           b= Blu[ChU] x=  450 y=  488 v=      77 mean 3X3 =    78.8
                											           b=   5[ChU] x=  450 y=  488 v=      77 mean 3X3 =    78.8
                											           b=   6[ChU] x=  450 y=  488 v=      77 mean 3X3 =    82.3
                											           b=   7[ChU] x=  450 y=  488 v=      92 mean 3X3 =   103.7
                											

En option, existe la possibilité de tracer une courbe à partir de la valeur du pixel ou le la valeur moyenne (3×3 ou 5×5 ou 9×9) pour tous les plans contenant des données (par exemple pour étudier une évolution temporelle). Dans le menu, passer l'option ``No plot'' à l'option ``Draw pixel'' ou ``Draw mean'' puis cliquer un point de l'image: une fenêtre Mgraph apparaît avec le (les) point(s). Si vous sélectionnez d'autres points les courbes s'accumuleront dans la fenêtre de tracé.
Si des valeurs aberrantes viennent perturber le tracé, vous pouvez les enlever en utilisant le menu ``Drawing_area->Clear area'' de Mgraph .
En choisissant cette option de tracé, 3 nouveaux boutons apparaissent:

• ``Clear graph''
  efface toute la fenêtre de tracé.
• ``Clear&keep last''
  efface toute la fenêtre de tracé mais conserve la dernière courbe.
• ``Set User's X''
  Cette option très particulière permet de donner des valeurs, autres que le numéro du plan, aux abscisses de la courbe.
  Pour cela, il faut utiliser la zone d'édition à gauche du panel et taper la correspondance du numéro du plan de données avec la valeur en abcisse:
  exemple:
  

  1	443
  2	490
  3	565
  5	670
  6	763
  7	765

  Si vous activez l'option, les valeurs éditées deviennent:

                  											        b= Red[ChU] :443 x=  938 y=  735 v=     136 mean 3X3 =   132.3
                  											        b= Gre[ChU] :490 x=  938 y=  735 v=     164 mean 3X3 =   159.4
                  											        b= Blu[ChU] :565 x=  938 y=  735 v=     197 mean 3X3 =   192.3
                  											        b=   5[ChU] :670 x=  938 y=  735 v=     197 mean 3X3 =   192.3
                  											        b=   6[ChU] :763 x=  938 y=  735 v=     164 mean 3X3 =   159.4
                  											        b=   7[ChU] :765 x=  938 y=  735 v=     136 mean 3X3 =   132.3
                  											

  Le tracé des points est réalisé avec les nouvelles valeurs de x.

5.2  EDIT->DUMP IMAGE VALUES

Cette option réalise un affichage dea valeurs des pixels du plan de données visualisé dans la fenêtre principale. Vous pouvez agrandir la fenêtre ``Sphinx_show_values'' pour plus de commodité de lecture.
Les ascenseurs à droite et en bas permettent de se déplacer dans une sous-matrice 50×50 pixels. Les ascenseurs en haut et à gauche permettent de déplacer la sous-matrice 50×50 dans l'image globale.

les données peuvent être imprimées dans plusieurs types: decimal, hexadecimal ou binaire.

5.3  EDIT->MOVE EXCHANGE ROTATE

Ce menu permet de modifier :

• les plans de données
• les plans de visualisation
• le plan graphique et le plan de masque
• les tables de couleurs (copy, exchange)

Un menu et des éditeurs apparaissent permettant de déterminer la géométrie de la zone émettrice, la géométrie de zone réceptrice, les plans de travail.

• [Clear...] Efface une zone de l'image en mettant toutes les valeurs à zéro
• [Copy...] Copie d'une zone dans une autre
• [Exchange...] Echange de deux zones
• [Rotate & Cut...] Rotation d'une zone (carrée) sur elle-même de 90 degrés
• [Rotate...] Rotation d'une zone (rectangulaire) sur l'image de 90 degrés
• [Up side down...] Inverse l'image de haut en bas
• [Left side right...] Inverse l'image de gauche à droite
• [Complement...] Réalise un complément à 255 des valeurs de l'image visualisée.
• [Clear selected color...] Uniquement sur le plan ``Work on mask area'', cette option permet d'effacer une couleur particulière du plan.

5.4  EDIT->IMAGE RESIZE

Ce menu permet de modifier la taille d'une image. Un menu et des éditeurs apparaissent permettant de déterminer la géométrie de la zone émettrice, la géométrie de la zone réceptrice, les plans de données impliqués.

Plusieurs méthodes d'échantillonnage des données sont proposées:

• Linear interpolation
• Nearest pixel
• Bicubic spline
• Nearest pixel (Build an icon)

Pour déterminer la taille deux méthodes:

1. Remplir les éditeurs de géométrie des zones émettrices et réceptrices. Lors de l'``Apply'', les facteurs d'échelle seront calculés automatiquement.
2. Remplir soi-même les éditeurs ``X factor'' ``Y factor''. Dans ce cas, l'image résultat pourra être tronquée à la géométrie de la zone réceptrice.

Un toggle important ``Linear color scale'':
dans la majorité des cas, les données en mémoire sont représentées à la visualisation par l'intermédiaire d'une échelle couleur linéaire. Par contre les photos numérisées ou le résultat de classifications ont des échelles complètement hachées (non linéaire). Si vous appliquez une méthode d'échantillonnage autre que ``Nearest pixel'', le résultat visuel sera désastreux.
Pour effectuer des échantillonnages interpolés sur ce genre d'image, désactivez le bouton ``Linear color scale'' et cliquez sur ``Apply''. Le calcul se fera en travaillant sur les composantes rouge, vert, bleu et les données recompressées dans une échelle équivalant visuellement à la précédente. (Attention: si les deux images sont dans le même plan de données, l'image d'origine sera translatée dans la nouvelle table couleur).

Fonction ``Nearest pixel (Build an icon)''

Cette fonction a été introduite pour créer de petites images représentatives d'images plus grandes (utilisation typique d'icônes sur le WEB).

Après avoir défini la géométrie des zones émettrices et réceptrices, sélectionnez ``Nearest pixel (Build an icon)''. Deux éditeurs apparaissent:

• Pixels to keep: ce seront les pixels obligatoirement conservés lors de la projection.
• Pixels to overlap: ce seront les pixels pouvant être écrasés lors de la projection.

ex: du texte noir sur un fond blanc. Le blanc peut être écrasé, le noir doit être conservé. Les valeurs des pixels peuvent être déterminées par la fonction ``Edit->Pixel value...''

5.5  EDIT->PIXEL & MASK

5.5.1  Création de masque à partir des valeurs des pixels

Ce menu permet de générer dans le plan de masque (4 bits) des zones colorées (14 couleurs) correspondant à des valeurs de pixels filtrés par une série de tests.

Pour l'utiliser, il faut définir la géométrie de la zone à traiter (menu en haut à gauche pour la zone et plan de travail).

2 modes de filtrages des pixels:

1. direct
   Il suffit de remplir les éditeurs (ex : From <= Blue <= To) avec les bornes à tester. Dans le cas de multi plans (R, G, B) vous pouvez choisir les options ``Do AND'' ou ``Do OR'' à réaliser entre chaque plan.
2. Free format
   Un éditeur et une liste apparaissent. L'éditeur du haut permet de définir des tests sur n'importe quel plan de données avec une syntaxe très simple, ex:
   

                   											         100<Blue<200
                   											         230<Blue<240
                   											         100 < 4 < 300
                   											         100 < 100 < 400
                   											         # 1<Red<10  (le # permet de commenter une ligne)
                   											

   sera compris comme

                   											         100<Blue<200   (plan bleu, pixel compris entre 100 et 200)
                   											         ou
                   											         230<Blue<240   (plan bleu, pixel compris entre 230 et 240)
                   											         et
                   											         100 < 4 < 300 (plan no 4, pixel entre 100 et 300)
                   											         et
                   											         100 < 100 < 400 (plan no 100, pixel entre 100 et 400)
                   											

   Vous avez la possibilité, en choisissant l'une des options ``Do OR'' ou ``Do AND'', de combiner les plans entre eux à l'aide d'opérations logiques.

A l'``Apply'', les tests réellement pris en compte sont affichés dans la liste du bas.

Options générales:

• Vous avez la possibilité d'utiliser une gomme ``Mouse eraser'' pilotée par votre souris.
  Activez cette option: Placez votre souris dans l'image; le bouton de droite permet d'effacer les pixels du masque sous un rectangle prédéfini, le bouton de gauche permet de sortir de la boucle d'effacement.

• Vous avez la possibilité d'utiliser un crayon ``Mouse drawer'' piloté par votre souris.
  Activez cette option: Placez votre souris dans l'image; le bouton de droite permet d'ajouter des pixels dans le masque sous un rectangle prédéfini, le bouton de gauche permet de sortir de la boucle d'écriture.

5.5.2  Détection automatique des masques

Ce menu permet de trouver des zones de pixels constants dans l'image et de créer des zones de couleur dans le plan masque afin de les mettre en évidence.

Définissez une géométrie et un plan de travail dans les menus en haut à droite. Activez ``Compute mask value list''. S'il y a des zones de pixels constants, les valeurs apparaissent dans éditeur ``mask values'' sous la forme: 0 Magenta 50.79%
La donnée zéro représente 50% de la zone et sera dessinée en magenta. Vous avez la possibilité d'ajouter des valeurs à détecter ou de modifier les couleurs prédéfinies en utilisant directement l'éditeur, ex:

                											        0 Magenta 50.79%
                											

                											        0 yellow
                											        100 red
                											

Activez ``Draw mask from the Mask values list''

Les masques rouge et jaune apparaissent dans la fenêtre principale.

Options:

• ``Clear mode'' La zone de masque est effacée
• ``Add mode'' Les différents masques se superposeront.

5.5.3  Modification des plans RGB à partir du masque

Ce menu permet de modifier les plans de visualisation (8 bits) Red, Green, Blue (imprimables) sans toucher aux plans de données, en affectant au pixels ayant un masque (de couleur quelconque) une couleur déterminée dans une liste ou prédéfinie par l'utilisateur.
Pour l'utiliser, il faut définir la zone de travail et la couleur. Passez en visualisation vraie couleur ``RGB'' activez ``Apply''; activer ``Clear mask area'': la zone qui était masquée apparaît dans la couleur déterminée.
Dans ce mode on va créer une différence entre les plans de données d'image et leur représentation visuelle à l'écran. Pour retrouver les pixels des plans de visualisation Red, Green, Blue d'origine, il faut utiliser le menu ``Display->Enhance display'' qui va permettre de recalculer les pixels des zones de visualisation 8 bits.

5.5.4  Modification d'un plan à partir du masque

Ce menu permet de modifier les plans de données, en affectant aux pixels ayant un masque (de couleur quelconque) une valeur définie par l'utilisateur.
Pour l'utiliser: définir la zone de travail, taper la valeur dans éditeur ``Data plane value'', puis activer ``Apply'', puis activer ``Clear mask area''. La zone qui était masquée apparaît constante. Si vous utilisez ``Edit->Pixel value...'' vous pourrez voir que les données initiales ont été écrasées.

5.6  EDIT->SCALE 24 BITS TO 8 BITS

Ce menu permet de transformer, en utilisant l'algorithme de Heckbert's (Color Image Quantization for Frame Buffer), une image 24 bits vraie couleur, définie donc par 3 plans Rouge, Vert, Bleu, archivés dans les plans de visualisation de Msphinx , en une image 8 bits associée à une table de couleur représentant au plus près l'image d'origine codée sur 16 millions de couleurs.

Ce sous-programme ne travaille que sur les plans de visualisation sans toucher aux plans de données.

Pour l'utiliser:
Définir la taille de la zone émettrice/réceptrice, choisir le plan d'archivage du résultat (Red, Green, Blue ou plan no), puis activer ``Apply''; Vous pouvez ensuite visualiser le plan résultat et la table couleur (``Show plane..'' ``Show scale'').

Attention dans cette fonction les plans de données ne sont plus représentatifs des plans de visualisation. Pour retrouver les pixels des plans de visualisation Red, Green, Blue d'origine, il faut utiliser le menu ``Display->Enhance display'' qui va permettre de recalculer les pixels des zones de visualisation 8 bits.

5.7  EDIT->SCALE 8 BITS TO 24 BITS

5.8  EDIT->GRAB DISPLAY

Permet d'acquérir une copie d'écran en sélectionnant la zone à l'aide de la souris et de la ranger dans les plans de données de Msphinx .
Pour l'utiliser:
Définir la zone réceptrice et le plan de travail. Attention si le plan de travail est simple, l'image sera chargée avec une table de couleur spécifique, si le plan de travail est RGB, l'image est chargée en 3 composantes rouge, vert, bleu.

Options:

• ``Cut mode''
  la taille de l'image ne peut dépasser la taille de la zone réceptrice.
• ``Fit mode''
  la taille de l'image sera déformée par échantillonnage (ligne, colonne) à la taille de zone réceptrice
• ``Fit mode (keep ratio)''
  la taille de l'image sera déformée par échantillonnage (ligne, colonne) à la taille de zone réceptrice en conservant ses proportions hauteur/largeur.

Activez ``Apply''.

Utilisez le bouton de gauche de la souris pour encadrer la zone, ou cliquez dans un panel (le panel et son contenu seront transférés), ou cliquez sur le fond de votre écran (l'ensemble de votre écran sera saisi).

5.9  EDIT->VIEW PLANE PIXEL CHANGE

Cette fonction permet de modifier les pixels des plans de visualisation à partir de plages de valeurs des plans de données. Définir la zone réceptrice et le plan de travail. Remplir la zone d'édition ``Value change list''; la syntaxe des commandes est simple: Nom du plan (R, G, B), plage de test, composante couleur (red, green, blue).
ex:.

                											            G .1  .2  255 0 255
                											            B .0  .1    0 255 0
                											

Remarque un éditeur de couleur permet de voir en mode RGB une couleur à partir de ses composantes R, G, B ou en mode plan une couleur à partir d'une valeur de pixel (0-255) dans la table des couleurs associée au plan.

En mode RGB, si votre écran est 8 bits, il vous faudra peut être pointer le rectangle ``Lut color'' pour voir effectivement la couleur définie par les éditeurs R, G, B.

Option Un bouton ``Undo'' permet de retrouver l'image d'origine.

==========================================================

Chapitre 6
DISPLAY

6.1  DISPLAY->SHOW TRUE COLOR

6.2  DISPLAY->SHOW (Red/Green/Blue) PLANE

                											     Sorry !!! Free Color Cells < 96 :: 7 I have to set My own lut
                											

6.3  DISPLAY->SHOW COLOR SCALE

6.4  DISPLAY->ENHANCE DISPLAY

Ce menu permet d'affiner ou de modifier la transformation automatique réalisée par le logiciel à la lecture des plans de données d'ordres de grandeur quelconques. Il s'agit d'une transformation linéaire générant les plans 8 bits (256 niveaux) de visualisation. Pour l'utiliser :
Définir la zone de travail et les plans de données concernés: obligatoirement les plans rouge vert ou bleu ou les 3 ensemble.
Activer ``Apply''; le programme va calculer de lui-même les minima et maxima des plans de données et appliquer la transformation pour dilater les mesures dans une échelle 0 à 255. Si le résultat ne convient pas, modifier les éditeurs ``Minimum'' et ``Maximum'' avec votre plage de valeurs et activer ``Apply'' pour visualiser le résultat.

Options:

6.5  DISPLAY->ZOOM (linked)

Voir la figure 6.5, pour avoir un exemple de l'utilisation du ``zoom linked''.

6.6  DISPLAY->ZOOM & ANIMATE

Ce menu permet de réaliser un zoom de l'image principale: jusqu'à 10 fenêtres de zoom différentes peuvent être utilisées simultanément. Les fenêtres sont ``resizable'' et sensitives, c'est à dire qu'elles peuvent être utilisées comme entrée de données dans tous les menus de sélection de zone ou pixel values etc...
Activez ``Select area'' et choisissez une zone dans l'image principale à l'aide de la souris ou dans une autre fenêtre de zoom contenant une image.

Options:

Options d'animations:

Remarques:
Dans les menus ``Animate'', le bouton gauche de la souris permet de ralentir l'animation, le bouton du milieu permet de réaliser une animation sur une petite zone autour du pointeur de la souris.
Le bouton de droite permet de sortir de la boucle d'animation. Pour ralentir ou accélérer l'animation une autre possibilité consiste à agrandir ou rapetisser la fenêtre du zoom.

Les plans graphiques et masques sont incrustés dans le zoom; utilisez l'option ``Window->Mask/Umask overlay plane'' pour les masquer.

6.7  DISPLAY->SCROLL ZOOM

Permet de créer une fenêtre de navigation dans l'image.

Les boutons de la souris ont un usage diffèrent si la souris pointe dans l'image principale ou dans l'image de la fenêtre ``Sphinx_scroll_zoom''.

• Dans la fenêtre principale:
  • Le bouton du milieu sélectionne la zone à visualiser
  • Le bouton de gauche augmente la taille de la zone
  • Le bouton de droite diminue la taille de la zone

• Dans la fenêtre ``Sphinx_scroll_zoom'':
  • Le bouton du milieu sélectionne un pixel dont la valeur est à éditer
  • Le bouton de gauche ou droite fait défiler les différents plans de données
  • Le bouton de gauche plus le bouton du milieu anime une petite zone autour du point fixé

La croix rouge dans la fenêtre du zoom montre le pixel dont la valeur est imprimée dans éditeur. Vous pouvez cliquer sur des pixels dans la fenêtre de Zoom pour afficher leur valeur.

Les flèches (haut, bas, droite, gauche) permettent de se déplacer finement dans l'image principale.

Pour arrêter la visualisation le ``Close'' de la fenêtre Xwindow est utilisé.

Remarque:
Les plans graphiques et masques sont incrustés dans le zoom; utilisez l'option ``Window->Mask/Umask overlay plane'' pour les masquer.

==========================================================

Chapitre 7
COLOR

7.1  COLOR->TRUE COLOR

7.2  COLOR->MORE PALETTES

7.3  COLOR->BUILD COLOR SCALE

Activer ``Display->Show color scale'' qui va visualiser une image montrant tous les niveaux de la table de couleur.
Placer la fenêtre graphique de Mgraph au premier plan de votre écran (pas de recouvrement par une autre fenêtre).
Dans le menu ``Mgraph_RGB'' activer l'une des composantes par exemple le bouton ``Red''.
La souris est automatiquement placée dans la fenêtre de Mgraph (en abcisse les pixels (0-255), en ordonnée l'intensité de la couleur (0-255)).
Utiliser le bouton de droite comme marqueur et dessiner à main libre en appuyant en continu ou par plage la courbe du rouge.

Appuyer sur le bouton de gauche pour sortir de la boucle. La nouvelle table de couleur remplace l'ancienne et vous pouvez voir le résultat sur l'image principale et dans l'image représentant l'échelle de couleur.

Faire la même chose pour les 2 autres composantes.

Dans le menu ``Mgraph_RGB'' une option ``Draw lines'' permet de tracer non pas à main levée mais par segments de droite. Le bouton de droite appuyé une première fois définit le premier point puis en se déplaçant bouton appuyé on trace la droite, dès que l'on relâche le bouton de droite, le deuxième point est introduit etc...

Appuyer sur le bouton de gauche pour sortir de la boucle.

7.4  COLOR->FILL LEVELS WITH COLORS

Ce menu ne peut s'activer en mode vraie couleur. Il ne concerne donc que la visualisation d'un plan associé à une table de couleur. Il permet de modifier la table de couleur par plage ou par valeur très précise (0-255) à partir d'une table de composantes prédéfinie ou à partir des composantes R, V, B introduites par l'utilisateur.
Un rectangle en haut à droite du menu montre la couleur de remplissage. Sur des écrans 8 bits, il faut que le pointeur de la souris soit dans le panel ``Sphinx_fill_color'' pour pouvoir voir la couleur de remplissage.

Choisissez une couleur dans la liste; vous pouvez la modifier en changeant directement la valeur des éditeurs ou en déplaçant les ascenseurs pour chaque composante couleur.

Choisissez les niveaux (auxquels il faudra affecter la couleur définie) dans les éditeurs ``From'' et ``To'', puis cliquez sur ``Do''

Options:

Remarque: pour conserver la LUT ainsi créée, n'oubliez pas d'effectuer un ``Save LUT'' avant de fermer la fenêtre ``Sphinx_fill_color''.

7.5  COLOR->COLOR STRETCH

7.5.1  FAST STRETCH

Ce menu permet de dilater ou contracter l'échelle couleur sur un simple mouvement de la souris. Il ne peut s'activer que sur des écrans couleur 8 bits (sur des écrans 24 bits vraie couleur, la fonction serait trop longue à exécuter perdant ainsi tout intérêt).

Activer ``Apply''

Déplacer le curseur dans la fenêtre: la visualisation est immédiate.
Cliquer sur un bouton pour sortir de la boucle.

Options:

7.5.2  STRETCH THE 8 BITS COLOR SCALE

Ce menu permet de dilater, contracter, inverser ou exécuter une rotation de l'échelle couleur.
Utiliser les ascenseurs en observant le résultat sur l'image principale.

Options:

7.5.3  COMPUTE IMAGE BALANCE

Ce menu, utilisable en mode vraie couleur, permet d'ajuster les amplitudes des 3 images constituant les trois composantes (rouge, vert, bleu) afin améliorer le contraste général de l'image restituée.
Il permet, associé à un masque, de contraster par exemple les pixels constituant la partie mer d'une image sans toucher à la partie terre.
Sélectionner une zone de test et un plan de travail (en général RGB).
Activer ``Show'': l'image résultante est montrée.
2 options sont possibles:

{\it ``Undo''} pour revenir à l'état initial
{\it ``Apply''} pour appliquer définitivement le calcul, après avoir, par exemple, sélectionné l'ensemble de l'image comme nouvelle géométrie de travail.

==========================================================

Chapitre 8
PLOTS

Les menus ci-dessous utilisent le logiciel Mgraph :
Mgraph est un logiciel de tracé permettant une visualisation et une mise en page rapide de données scientifiques présentées sous forme de fichiers ASCII pour les courbes classiques, sou s forme de fichiers binaires pour les données de surfaces.
Les fichiers de sorties sont en PostScript. Des images en format Tiff ou Gif peuvent aussi être générées.

Caractéristiques Principales

• Une visualisation rapide sans limitation du nombre de données.
• Jusqu'à 10 fenêtres de tracé simultanées
• Une gestion de la base de données graphiques de l'utilisateur.
• Une mise en page interactive de documents.
• Une numérisation de courbes, soit à partir d'images lues en format TIFF/GIF (par ex, une sortie de scanner), soit à partir d'images importées directement sur l'écran.
• Des fits multiples et équations sur les courbes.
• Un tracé de contours et projections
• Une production automatique à partir de fichiers de commandes, eux-mêmes pouvant être créés par Mgraph .
• Une intégration simple dans des programmes fortran ou C.
• Présentation 3D des surfaces
• WWW Cgi implantation

8.1  PLOTS->HISTOGRAM

Ce menu permet de tracer des histogrammes à partir des plans d'images archivées.

Choisir la géométrie d'une zone, puis exécuter ``Apply''.

Description des options:

8.2  PLOTS->TRANSECT

Permet de tracer une radiale à la souris dans l'image et de tracer sous forme de courbe les pixels correspondants.

Description des options:

8.3  PLOTS->CONTOURING

Ce menu, un peu complexe, est utilisé soit pour tracer des valeurs de pixels représentant des frontières, directement dans le plan masque du système sous forme de pixels de couleurs soit au travers du logiciel Mgraph pour visualiser une image et s'il y a lieu des contours sous forme de courbes.

8.3.1  Tracé dans le plan masque

Le résultat apparaît dans la fenêtre principale.

Description des options:

8.3.2  Utilisation de Mgraph.

• on veut simplement visualiser une image en ajoutant un titre, des axes etc...

  Dans le bloc ``Background image'', exécuter ``Send to Mgraph'': une fenêtre Mgraph apparaît avec l'image. Utiliser les menus de Mgraph pour réaliser la présentation.

Description des options:

• on veut tracer des contours avec Mgraph

  dans la liste des contours, introduire une valeur; dans le bloc ``contour drawing'', exécuter: ``Send to Mgraph''. Une fenêtre Mgraph apparaît avec le tracé.

  À ce niveau vous pouvez sélectionner, dans la géométrie, un autre plan de données. Dans la liste des contours, introduire une nouvelle valeur avec une autre couleur dans le bloc ``Contour drawing''; puis activer le Menu ``Curve add Mode'' et exécuter: ``Send to Mgraph''
  

Description des options:

On peut avec les deux menus ``Contour drawing'' et ``Background image'', OBLIGATOIREMENT dans cet ordre:

1. Calculer des contours à partir de différents plans.
2. Ajouter une image de fond (vraie couleur, ou plan avec table de couleur) pour illustrer les contours tracés (les valeurs des pixels de cette dernière pouvant être complètement différents des plans de données ayant généré les contours).

8.4  PLOTS->BIDIMENSIONAL PLOT

Ce menu permet de tracer, sous forme de nuage de points, un plan de données en fonction d'un autre plan de données. Les mesures étant situées dans le même espace (X et Y identiques) ou dans des cellules différentes.

Mise en øeuvre:

• Sélectionner la géométrie de travail dans le menu ``X axis'' en haut à gauche. Si les géométries X et Y sont identiques, cela suffit; sinon, sélectionner la géométrie de travail dans le menu ``Y axis'' en haut à droite.
• Sélectionner le plan de visualisation que vous voulez représenter en X
• Sélectionner le plan de visualisation que vous voulez représenter en Y
• Activer ``Apply'':
  le nuage de point apparaît dans la fenêtre de tracé. Si des points ``hors normes'' existent (c'est le cas dans la plupart des images) le nuage de points apparaîtra écrasé. Utiliser alors l'option ``Mgraph->Drawing_area->Clear Area'' pour effacer les données hors échelle puis, le cas échéant, ``Mgraph->Drawing_area->Rescale''.

Description des options:

menu Bidimentionnal
Les pixels allumés dans la zone donnée vus dans la fenêtre graphique
Le tracé des pixels sélectionnés

``Highlight values''
Ce menu permet d'associer des zones de l'histogramme à des pixels de l'image. Vous pouvez agrandir le panel pour améliorer sa lisibilité.
Activer cette option.
Activer ``Apply''.

Une nouvelle fenêtre ``Sphinx_bidim_hightlight'' apparaît contenant la zone ayant servie au calcul du nuage de points (zone correspondant à l'image visualisée dans la fenêtre principale).

Dégagez sur l'écran la nouvelle fenêtre et la fenêtre Mgraph montrant le nuage de points.

Activer l'option ``Get from plot''.
Le curseur passe dans la fenêtre de Mgraph où vous devez entourer les pixels à visualiser.
Les éditeurs ``From'' ``To'' de ``X Y axes'' contiennent les plages en X et Y sélectionnées dans le graphique et les pixels correspondants sont visualisés sur l'image de la zone.
Vous pouvez aussi modifier directement les éditeurs et faire ``Apply''

Option:
Ce menu permet aussi de créer des masques correspondant aux zones de l'histogramme mais sur la fenêtre principale de visualisation.
Activez : ``Set main window area''
Sélectionner la géométrie de la zone de calcul.
Choisissez une couleur de masque par exemple ``Green''
Activer ``Apply to main window''
En vert dans la fenêtre principale apparaissent tous les pixels ayant les mêmes caractéristiques que dans la zone sélectionnée.

Pour revenir à l'option ``Get from plot'', désactiver: ``Set main window area''

8.5  PLOTS->CALL GRAPHIC MENU

==========================================================

Chapitre 9
PROCESS

9.1  PROCESS->IMAGE ALGEBRA

Ce menu permet d'appliquer une ou plusieurs formules aux images. Une fenêtre montre l'ensemble des formules déjà utilisées. Les formules sont contenues dans l'éditeur ``f=''. Les calculs sont réalisés en flottant puis ramenés à la précision des plans d'archivages. exemple ces 3 lignes:

                											                         r=r/100
                											                         g=g/100
                											                         b=b/100
                											

Notations pour les opérandes au niveau d'un plan complet:
R pour Red plane
G pour Green plane
B pour Blue plane
P[no] pour un plan quelconque no étant le numéro du plan (de 1 à 511).

Notations particulières:
R[x,y] ou P[3,x,y]
où x sera un décalage en colonne, y sera un décalage en ligne, à partir desquelles les données seront traitées ou écrites.

exemple:
R[40,40]=B[100,50]+G[100,50]
le plan rouge rempli à partir de la colonne et de la ligne 40 sera égal à la somme des plans bleu et vert décalés chacun de 50 lignes et 100 colonnes.

Notations pour les opérandes d'une cellule:
C[no du plan, no de la cellule]
Le calcul du numéro de la cellule est facilité par le dessin en haut à droite du menu. Il suffit de cliquer sur une cellule pour voir son numéro s'afficher dans le label situé au-dessus.

Les opérandes particuliers:
X no de la colonne dans le calcul
Y no de la ligne dans le calcul
W largeur de l'image
H hauteur de l'image

Opérateurs utilisés dans les équations :
+, -, *, / , % (division entière),
** (élévation à la puissance)
& (AND) , | (OR) , ^ (XOR), ~ (complement)

Fonctions utilisées dans les équations :
Exp, log10, log, sqrt, rnd()
sign (le signe du paramètre ex: sign(x) résultat -1 ou 1),
abs, int,
sin, cos, tan (en radian),sind, cosd, tand (en degrés)
asin, acos, atan, asind, acosd, atand,
sinh, cosh, tanh,
asinh, acosh, atanh,
cosec, sec, cotan, cosecd, secd, cotand

9.2  PROCESS->AREA STANDARD DEVIATION

Ce menu permet de calculer des statistiques simples sur une zone de l'image. Le résultat est présenté, dans une seconde fenêtre, sous la forme:

                												** Statistics  on the image pixel values **
                												Points 80066 :  plane    3
                												Minimum      :       6.000000
                												Maximum      :     222.000000
                												Sum          : 4440516.000000
                												Mean         :      55.460695
                												RMS          :      66.814003
                												Average  Dev.:      30.807705
                												Variance     :    1388.239615
                												Standard Dev.:      37.259088
                												Skewness     :       0.354782
                												Kurtosis     :      -0.761872
                											

9.3  PROCESS->CONVOLUTION PRODUCT

Permet de réaliser des lissages ou des filtres sur une image en utilisant une matrice ou un vecteur en ligne ou en colonne.

Options:

==========================================================

Chapitre 10
MODELS

10.1  MODELS->SATELLITE SIGNAL SIMULATION 6S

Ce menu lance le logiciel Msixs, simulation du signal satellitaire dans le spectre visible.

10.2  MODELS->SOLAR ZENITH ANGLE CALCULATION

Ce menu calcule, pour un lieu et pour une date donnés, différents paramètres solaires.
Exemple pour:

                											      Julian day: 286
                											      Latitude: 50.0 Longitude: 0.0
                											      Hour: 12.0 (UTC)
                											

                											      Solar zenith angle  =      57.927 deg
                											      Solar azimuth angle =     184.146 deg
                											      Correction =  1.00464
                											      (of the mean annual Earth-Sun square distance
                											      and the mean annual solar irradiance)

                											      Values of the annual mean solar irradiance (in w/m2/micron)
                											      between 0.25 and 4.0 microns, by step of 0.0025 microns.
                											      The value of the total irradiance is 1372 w/m2 on the whole
                											      spectrum (1358 w/m2 between 0.25 and 4.0 microns).
                											      Reference: Neckel, H., and D. Labs, 1984. Solar Physics, 90, 205- 258.
                											      0.2500   69.30
                											      0.2525   77.65
                											      0.2550   86.00
                											      0.2575  100.06
                												......
                											

10.3  MODELS->WARPER

Ce menu permet de superposer deux images de géométries différentes par une méthode de polynômes de Legendre, les polynômes de déformation étant calculés à partir d'amers introduits interactivement par l'utilisateur.
L'opération se fait en deux étapes:

• détermination des amers
• application de la déformation à une ou plusieurs images.

Le panel ``Sphinx_warper_view'' est divisé en 2 parties:

1. la partie gauche concerne l'image de référence donc la géométrie d'arrivée.
2. la partie droite concerne l'image à déformer.

Vous pouvez agrandir le panel pour améliorer sa lisibilité. Les 2 images du haut représentent les zones sélectionnées, les images du bas servent à montrer des zooms pendant la séquence de choix des amers puis à montrer des résultats intermédiaires sur les déformations.

Mise en uvre:
Dans le premier menu ``Sphinx_warper'', vous sélectionnez l'image de référence et l'image déformée puis vous lancez le ``Warper'' proprement dit:

10.3.1  Lecture de l'image de référence

10.3.2  Lecture de l'image à déformer

10.3.3  Selection des points d'ancrage

À ce niveau, vous êtes dans une boucle d'entrée des amers, c'est à dire de points que vous estimez être identiques dans les deux images.

Vous pouvez cliquer directement dans l'image de référence ou utiliser les 2 options ``Zoom'' pour agrandir une partie de l'image. le zoom est visualisé dans la partie basse du panel ``Sphinx_warper_view''.
Vous pouvez maintenant sélectionner vos points:

Sélectionner un point dans l'image de référence (ou dans son zoom), à l'aide de la souris, puis sélectionner le point correspondant dans l'image à déformer.
Votre premier amer est introduit. S'il est faux, activez le bouton ``Delete last entry'' du panel ``Sphinx_warper''. Recommencer l'opération autant de fois que nécessaire: vous devez, pour un résultat optimum, introduire des points bien répartis sur toute la surface: au minimum 4 points sont nécessaires (l'algorithme utilisé interpole bien mais extrapole très mal). À partir du 4ème point, la sélection d'un point dans l'image de référence provoque le dessin d'une croix verte, sur l'image à déformer, à l'endroit de la prévision; vous pouvez ainsi apprécier la précision de la projection et la nécessité ou non d'introduire d'autres amers.

10.3.4  Visualisation du résultat

Si vous activez de nouveau le bouton ``Select matching points'', vous pouvez ajouter des amers à la liste.

En fin de travail, choisissez une géométrie d'application du résultat dans le menu ``Sphinx_warper'' en haut à droite. Activez ``Apply''.
Changez de plan s'il y a lieu, activez ``Apply'' etc...

10.4  MODELS->PROJECTIONS

Ce menu permet de projeter une image de satellite dont la géométrie est connue. Il permet aussi d'ajouter une grille et un fond de carte précis (environ 1km) dans la bonne projection. Il peut être directement associé au logiciel Mgraph pour une présentation rapide des données.

Mise en uvre:

10.4.1  Définir la géométrie et le plan de l'image d'origine:

Définir, en latitude et longitude, le domaine que couvre l'image. Si rien n'est défini, l'image est supposée globale (-90->90, -180->180 degrés).

Activer ``Show (From area in the TO projection image)''.
Cette fonction permet de réaliser une simulation de la projection à partir d'une carte du monde synthétique. La projection et la géométrie sont celles définies dans ``TO PARAMETERS''; elle va correspondre au résultat final. En vert et bleu apparaît le recouvrement de ``FROM'' vers ``TO''; en noir et blanc la zone non recouverte de ``TO''.

10.4.2  Définir la géométrie et le plan de l'image d'arrivée:

Définir, en latitude et longitude, le domaine que couvre l'image. Si rien n'est défini, l'image est supposée globale (-90->90, -180->180 degrés).

Si vous travaillez en ``patch work'', choisissez l'option ***** Overlap pixel mode ***** à la place de ***** Replace pixel mode *****.

Activer ``Show (From area in the TO projection image)'' pour visualiser le résultat. Activer ``Apply'': la reprojection est réalisée.

10.4.3  Grilles et contours de côtes

• Ajout d'une grille
  Remplir les éditeurs définissant la grille.
  Choisir une couleur.
  Activer ``Draw Grid''.
  

• Ajout d'une carte
  Choisir une couleur.
  Activer ``Draw map''.
  

10.4.4  Send results to Mgraph

Activer le toggle ``Send results to Mgraph''.
Après avoir défini tous les paramètres de projections (voir ci-dessus), activer ``Apply'': la reprojection est réalisée.
Une fenêtre Mgraph apparaît.
Activer ``Draw Grid''.
La grille est dessinée dans la fenêtre graphique.
Activer ``Draw map''.
La carte est dessinée dans la fenêtre graphique.

10.5  MODELS->AERONET Fast-link

Deux bases identiques sont implémentées:

• au LOA USTL France
• au GSFC USA.

Utilisez le menu en haut à gauche pour sélectionner la base voulue (vous pouvez basculer sur l'autre à tout moment).

10.5.1  Menu extraction

• ``Photometer selection''
  L'extraction est faite pour un photomètre spécifique à la date (en remplissant l'éditeur ``Date: dd/mm/yyyy'') et à l'heure données par l'utilisateur (si le champ ``time'' est vide, l'extraction sera faite pour la journée complète).

• ``Area selection''
  L'extraction est faite pour une zone et une date (en remplissant l'éditeur ``Date: dd/mm/yyyy'') et une heure données. L'utilisateur peut remplir les éditeurs de latitude et de longitude ou il peut utiliser l'option ``show map'' et sélectionner directement une zone à l'aide de la souris. (Si vous ne voyez pas les sites des photomètres sur la carte, cliquez sur le bouton ``Show Photometers list'').

10.5.2  Types des données

Sélectionner les données que vous voulez visualiser:

• Optical thickness
• Size distribution
• Refraction index
• Polarization
• All data

remarque: L'option ``plot'' fonctionne uniquement avec les sélections ``All data'' ou ``Optical thickness'' .

10.5.3  Les options

• ``Show map''
  Cette option trace une carte du monde avec les photomètres opérationnels pour le jour choisi. (jaune pour non polarisé, magenta avec polarisation)

• ``Save on disk''
  Cette option sauve sur disque tous les résultats transférés dans un fichier appelé ``MskyResult''. Si le fichier existe, il sera rallongé.

• ``Mgraph plots''
  Cette option permet d'effectuer des tracés dans 4 fenêtres:
  
  * Angström coefficients
  * Optical thickness
  * Dubovik size distribution
  * Polarization ratio
  

• ``Mgraph prints''

  Cette option crée un fichier de commandes pour le logiciel graphique Mgraph . Si Mgraph est installé sur votre système, le travail est automatiquement lancé et un second fichier est créé (un fichier PostScript) avec les résultats du tracé. Il suffit ensuite d'envoyer le fichier sur votre imprimante ou de le visualiser avec ``Ghostview'' par exemple.

• ``Show Photometers list''

  Cette option permet de voir les photomètres opérationnels à une date donnée. (vous pouvez agrandir le panel ``Photometers_list'') Sont imprimés:
  Le numéro et le nom du photomètre, sa localisation et le nombre de mesures disponibles. Si vous cliquez sur une ligne, les caractéristiques du photomètre sont remplacées par le panel ``Msky_look''.

• ``Clear text''

  Efface la zone d'affichage.

• ``About Msky''

  Imprime l'avertissement et le manuel.

• ``Check DB''

  Cette option est très importante; après la première extraction, le logiciel utilise un cache mémoire pour éviter les multiples connexions à la base de données.
  Si vous changez de base, vous retrouverez les données présentes dans le cache. Le bouton ``Check DB'' force le chargement à partir de la base et remet à jour la mémoire cache.

==========================================================

Chapitre 11
NETWORK

11.1  NETWORK->USERS DIALOG

• L'échange de messages et d'images entre utilisateurs.
• La lecture et la visualisation d'une base d'images locales
• des jeux de détente entre utilisateurs.

11.1.1  Architecture générale :

• Un serveur de listes
  Sur l'un des ordinateurs du LOA, est implanté un serveur de liste. Sur interrogation, ce serveur délivre la liste des sites où sont implantés les serveurs de noms.
• Un serveur de nom local.
  Localement, un serveur délivre, sur interrogation, les noms des utilisateurs travaillant avec Msphinx .

11.1.2  Mise en route locale.

                											(PATH)/Mfiles/Msdiaser -P 8999 -T "GROUP NAME" -B
                											(PATH)/Mfiles/bin > /dev/null 1>&2 &
                											

options:

Un fichier (PATH)/Mfiles/compta/network doit être initialisé pour prévenir Msphinx de la présence d'un serveur de nom.
ex: vi Mfiles/compta/network

                											      # Msphinx local Image data base and local dialogs (Only one)
                											      LOCALdatabase: loaser.univ-lille1.fr   8999
                											

Options:

11.1.3  Dialogues entre utilisateurs

Dans la liste située en haut à gauche ``LOCAL users list'', est imprimée la série de personnes utilisant le logiciel. Vous avez la possibilité d'un sélectionner une ou plusieurs. Les sélections s'affichent dans la liste de droite.
Vous pouvez gérer plusieurs listes:
Activer ``Create a new list''
Puis sélectionner un autre utilisateur.
Les flèches <- -> permettent de passer d'une liste à l'autre.

L'option ``Refresh selectable list from serveur'' permet d'interroger le serveur et de rafraîchir la liste ``LOCAL users list''.

options:
``Send a message ''
Un panel de tchatche apparaît; dans la partie haute le dialogue va s'afficher. La partie basse permet de taper du texte. 2 options
``Clear text'' Pour effacer la frappe en cours.
``Save on file'' pour écrire sur disque le dialogue dans un fichier de nom imposé Dialogs01, Dialogs02 etc...

Le panel peut être agrandi pour améliorer sa lisibilité.

Taper vos lignes dans le panel du bas; pour expédier votre courrier, il suffit de taper deux [CR, Enter] retour à la ligne en suivant.
Le début de votre message est imprimé dans la partie haute sous la forme

Remarques:
Si votre ``Mailing list'' contient plusieurs noms, votre texte sera envoyé à tout le monde.

Vous pouvez créer une nouvelle liste et donc changer rapidement de correspondant en utilisant les flèches pour réaliser un apparté dans vos messages.

Options:

``Network status and Image position menu''

Il permet de visualiser le déroulement des communications. Le panel de droite permet de définir une géométrie d'image qui sera utilisée pour ranger un message de type image ou pour expédier les données contenues dans les plans de visualisation de Msphinx en activant le bouton ``Send the selected image''

``Send a grabed image'' permet d'envoyer à votre correspondant tout ou partie de votre écran.
Activer ``Send a grabed image''; le bouton devient rouge; si vous cliquez dans un panel, le panel complet sera expédié.
Par ex cliquez dans la couleur du fond de votre écran. (l'image de votre écran est expédiée) Si vous maintenez appuyé votre bouton et définissez une zone, c'est cette zone qui sera expédiée.

Votre correspondant va recevoir un panel ``Mdial_incoming_(votre nom)'' avec l'image; il peut l'agrandir pour la voir et la charger dans un plan de travail de Msphinx(Voir plus haut ``Network status and Image position menu'')

11.2  NETWORK->SERVER MAIN LIST

==========================================================

Chapitre 12
PRINT & SETTINGS

12.1  PRINT & SETTINGS->QUICK PRINT

Ce menu permet de créer un fichier PostScript à partir d'une image vraie couleur (24 bits ) ou associée à une table couleur (8 bits) archivée dans les plans de visualisation (R, G, B) de Msphinx.

Options:

ATTENTION:

• Si vous utilisez comme commande d'impression : lp -dPRINTER_NAME dans éditeur ``Spooler shell'' et que rien n'est imprimé, essayez la commande lp -c -dPRINTER_NAME

• Si vous choisissez le format ``Custom'' pour le papier, vous pouvez remplir les deux éditeurs (Width , Height) et cliquer sur ``Refresh show page panel''. Cette option, ainsi que la taille, est sauvée dans le contexte de travail.

• Les impressions PS peuvent ne pas s'exécuter en mode image 8 bits associée à une table couleur. L'algorithme de compression PostScript donne une page blanche sur certaines imprimantes comme par exemple sur Phaser340.
  Activer l'option ``Print&Settings->Page setting->RGB PS Encoding'' et réessayez l'impression. Cette option est sauvegardée dans votre contexte de travail.

• Si vous ouvrez le menu ``Add EPS icons'', vous pourrez ajouter votre icône favorite (en Encapsulé PostScript) sur la page

12.1.1  Les fichiers d'environnement

Voici un aperçu du contenu du fichier $home/.Msphinx/VotreNomdeProjet.prj/Print_Options:

                											          INCH               0
                											          post_costr      /usr/LOA/bin/vidpsLEX
                											          post_grstr      /usr/LOA/bin/vidpsMAN
                											          PAPER_SIZE         0  100 -1 -1
                											

La signature en bas de page est par défaut: L.O.A. Computer Team. Pour la modifier, éditez le fichier $home/.Msphinx/SIGNATURE, et remplacez par votre signature personnelle.

12.2  PRINT & SETTINGS->PAGE SETTING AND PRINT

Ce menu permet de réaliser des mises en page à partir d'images archivées dans les plans de visualisation:

• Création de cellules contenant des images sur la page
• Annotations de page.
• Ajout d'icônes EPS

Il se compose de 2 fenêtres ``Sphinx_page_setting'' et ``Sphinx_show_page''. Vous pouvez agrandir cette dernière fenêtre pour améliorer sa lisibilité.

Les mises en page réalisées et les images imprimées sont sauvegardées sur disque sur demande de l'utilisateur (option ``Save Page setting images on disk'') et peuvent être réimprimées par la suite.
Attention: la résolution d'une image (``dot per inch'') est fixée lors du remplissage de la cellule par l'image, elle est donc définitive; si vous devez changer cette résolution, il faudra recharger l'image dans la cellule.

Ce menu complexe est divisé en plusieurs zones:

12.2.1  Définition d'une page

menu en haut à gauche. Les flèches (
Picture Omitted

) permettent de visualiser les différentes pages existantes et leur contenu. La création d'une nouvelle page passe par l'option ``Duplicate page setting'' qui va créer une nouvelle page avec les mêmes cellules vides que de la page en cours.

Différentes options sont prévues pour l'impression de la page:

* Si vous choisissez le format ``Custom'' pour le paper, vous pouvez remplir les deux éditeurs (Width, Height) et cliquer sur ``Refresh show page panel''. Cette option, ainsi que la taille, est sauvée dans le contexte de travail.


* Si vous n'avez pas d'annotation, le menu ``Sphinx_page_annotations'' sera ouvert, sinon la position de l'annotation sera visualisée sur le panel ``Sphinx_show_page''.


* Si vous n'avez pas d'icône EPS, le menu ``Sphinx_page_add_EPS_files'' sera ouvert, sinon la position de l'icône sera visualisée sur le panel ``Sphinx_show_page''.

12.2.2  Définition d'un patch ou cellule

Comme pour les pages, vous pouvez, à l'aide des flèches (
Picture Omitted

), pointer les zones d'images définies dans la page.

Création d'une cellule
Il existe 2 méthodes pour créer une cellule:

• Remplir les éditeurs ``X start, Y start, Width Height''. Il suffit ensuite d'activer ``Create new patch'' ou ``Replace current patch''.
• Activer l'option ``Fill with mouse'' qui vous permet de dessiner à l'aide de la souris votre cellule dans le panel ``Sphinx_show_page''. Corriger ensuite, s'il y a lieu, les valeurs dans les éditeurs et activer ``Replace current patch''.

12.2.3  Remplissage de la cellule

Save context

Attention! Si vos images sont très grandes, spyez prudent: désactivez cette option sinon les images seront dupliquées sur disque.

12.2.4  Fichiers d'environnement

aperçu du contenu du fichier $home/.Msphinx/VotrNomdeProjet.prj/Print_Options:

                											          INCH               0
                											          post_costr      /usr/LOA/bin/vidpsLEX
                											          post_grstr      /usr/LOA/bin/vidpsMAN
                											          PAPER_SIZE         0  100 -1 -1
                											

La signature de bas de page est par défaut: L.O.A. Computer Team. Pour la modifier, il suffit d'éditer un fichier $home/.Msphinx/SIGNATURE, avec les nouvelles informations:

12.2.5  Remarques

• deux types d'annotations sont disponibles
  1. au niveau d'une image:
     Print&Settings->Draw Image annotations (§12.4)
  2. au niveau de la page:
     Print&Settings->Draw Page annotations (§12.5)

• Les plans masqués et graphiques sont automatiquement inclus dans l'image.

12.3  PRINT & SETTINGS->POSTER SETTING

Ce menu permet de réaliser des posters de taille quelconque avec des images stockées dans les plans de visualisation de Msphinx . Vous pouvez aussi ajouter des annotations de page et insérer plusieurs icônes en Encapsulé PostScript.
Ce menu crée un fichier PostScript.

Deux panels sont affichés: ``Sphinx_poster_setting'' et ``Sphinx_show_page''.
Vous pouvez agrandir ce dernier panel pour avoir une meilleure résolution.

Pour plus de facilités, vous pouvez réaliser le poster en petit format (A4 par exemple) puis, quand l'impression est correcte, vous pourrez ajuster le format de papier à la taille désirée. Toutes les définitions seront traduites dans la bonne échelle.

Ce menu complex est divisé en plusieurs zones:

12.3.1  Page definition

* Si vous choisissez le format ``Custom'' pour le paper, vous pouvez remplir les deux éditeurs (Width, Height) et cliquer sur ``Refresh show page panel''. Cette option, ainsi que la taille, est sauvée dans le contexte de travail.


* Si vous n'avez pas d'annotation, le menu ``Sphinx_page_annotations'' sera ouvert, sinon la position de l'annotation sera visualisée sur le panel ``Sphinx_show_page''.


* Si vous n'avez pas d'icône EPS, le menu ``Sphinx_page_add_EPS_files'' sera ouvert, sinon la position de l'icône sera visualisée sur le panel ``Sphinx_show_page''.

12.3.2  Définition d'un patch ou cellule

Création de la cellule
Vous ne pouvez créer qu'une seule cellule. 2 méthodes sont possibles:

• Remplir les éditeurs ``X start, Y start, Width Height''. Il suffit ensuite d'activer ``Create new patch'' ou ``Replace current patch''.
• Activer l'option ``Fill with mouse'' qui vous permet de dessiner à l'aide de la souris votre cellule dans le panel ``Sphinx_show_page''. Corriger ensuite, s'il y a lieu, les valeurs dans les éditeurs et activer ``Replace current patch''.

Point important:
Pour plus de facilités, vous pouvez réaliser le poster en petit format (A4 par exemple) puis, quand l'impression est correcte, vous pourrez ajuster le format de papier à la taille désirée. Toutes les définitions seront traduites dans la bonne échelle.

Remplissage de la cellule Indiquer dans la partie ``Patch content'', (dans la fenêtre principale de Msphinx), la géométrie de l'image désirée. L'image qui sera chargée est l'image visualisée dans la fenêtre principale de Msphinx.

Option

Contrairement au menu ``Page_Setting'', le résultat ne sera pas affiché dans le panel ``Sphinx_show_page'' mais vos préférences seront néammoins conservées pour un prochain poster.

Vous pouvez aussi sauver des descriptions différentes de poster dans une base en utilisant l'option ``Save POSTER Settings'' et vous pourrez en rappeler une en cliquant sur son nom.
Chaque description sauvée est enregistrée dans le répertoire $home/.Msphinx/VotreNomdeProjet.prj/POSTERS/

12.4  PRINT & SETTINGS->DRAW IMAGE ANNOTATION

Ce menu permet de définir des annotations qui pourront être ajoutées au moment du ``Page setting '' à une image ou incrustées dans le plan graphique pour générer un fichier (gif etc...) ou une présentation papier.
Vous pouvez agrandir la fenêtre pour améliorer sa lisibilité.

Ce menu fonctionne également avec des pages de présentations appelées ``Set''. Vous vous déplacez dans les pages avec les flèches en bas à droite:

Choisissez, dans ``Annotation type'', le type d'annotation à ajouter puis activez ``Add''. Vous pouvez utiliser la zone de visualisation de l'image pour choisir l'emplacement ou dessiner l'objet à l'aide de la souris.

Les flèches permettent de sélectionner les objets déjà introduits. Une coloration magenta permet de les repérer dans la fenêtre d'annotation.

Options:

En fin de mise en page vous pouvez tracer l'ensemble dans le plan d'overlay graphique en activant l'option ``Send annotations to graphic plane''.

12.4.1  Echelle de couleur

Fenêtre principale en mode ``True color'':
Dans ce mode vous pouvez définir n'importe quelle couleur pour vos objets, l'annotation ``Draw rainbow'' qui n'a pas de signification dans ce mode va tracer l'échelle contenue dans le plan Blue de Msphinx.

Fenêtre principale en mode Plan ``Red, Green, Blue'':
Dans ce mode vous ne devez définir que des couleurs contenues dans l'échelle couleur de l'image pour vos objets.

La commande ``Send annotations to graphic plane'' va dessiner dans le ou les plans de visualisations et dans le mode ``True color'' ou Plan ``Red, Green, Blue''

Si vous changez de mode après avoir incruster les objets vous devez réactiver l'option ``Send annotations to graphic plane'' pour retrouver les bonnes couleurs.

Les flèches permettent de sélectionner les objets déjà introduits. Une coloration magenta permet de les repérer dans la fenêtre d'annotation.

Options:

Exemple d'une série d'actions:
Choisir l'option ``Fill area'', choisir une couleur ``White'' puis activer ``Add''.
Dessiner un rectangle dans l'image des annotations où seront rangées les icônes.
Choisir l'option ``Draw icon''
Introduire un facteur de taille dans l'éditeur: par exemple 2.
Sélectionner un type d'icône par exemple ``Triangle Icon''.
Sélectionner une couleur :
Soit en remplissant les éditeurs des composantes rouge, vert, bleu ou plus simplement en activant l'option ``Select color from image'' et en sélectionnant une couleur dans la fenêtre principale de visualisation: appuyer sur un bouton et glisser en continu sur l'image; un rectangle vous indique la couleur; relâcher quand vous l'avez obtenue.
Activer ``Add''.
Sélectionner une position dans la zone préparée à cet effet.
Activer les toggles ``Keep x ou Keep y'' selon l'orientation de votre zone.
Reprendre à Sélectionner une couleur: etc...

Sélectionner ``Draw text''.
Taper un texte dans éditeur.
Sélectionner les couleurs du texte et la police de caratères.
Activer ``Add''.
Annoter l'icône correspondant.
etc...

Activer ``Move all scale''.
Avec le bouton de droite de la souris, sélectionner une autre position dans l'image des annotations: l'ensemble de l'objet ``COLOR SCALE'' change de position.

ATTENTION:
Après avoir activer la commande ``Send annotations to graphic plane'', s'il y a des annotations de ``COLOR SCALE'', les plans de visualisation sont écrasés et ne représentent plus exactement les plans de données correspondant. En cas d'erreur, il faut regénérer les plans de visualisation à l'aide des commandes du menu ``Display->Enhance display''.

12.5  PRINT & SETTINGS->DRAW PAGE ANNOTATION

Ce menu permet d'ajouter du texte et quelques figures (ligne, rectangle, flèche) sur la page.

Choisissez le type d'annotation: remplissez les éditeurs de géométrie ou activez ``Fill with mouse'' qui va vous permettre de définir la position de l'objet dans la fenêtre ``Sphinx_show_page'', puis corrigez les éditeurs de position s'il y a lieu, puis activez le bouton ``Add''. L'annotation est matérialisée dans la page.
Options:

12.6  PRINT & SETTINGS->(ADD) EPS ICONS

Ce menu permet d'ajouter des icônes sur la page. Ces images doivent être en format EPS (Encapsulated PostScript language).

Deux bases sont disponibles: la base de données du laboratoire et votre base personnelle.
La base de données du laboratoire est mise dans le répertoire Mfiles à l'installation du logiciel.
Pour constituer votre base personnelle, vous pouvez remplir les éditeurs ``EPS file name'' avec le chemin complet du fichier EPS, puis cliquer sur ``Add file in the data base''. Le fichier sera copié dans le répertoire $home/.Msphinx/USER_EPS_LOGOS.

Sélectionner une icône, cliquer sur son nom dans la base de données, il apparaîtra dans la deuxième liste ``Selected LOGOS''.

Pour positionner l'icône, sélectionnez la dans la deuxième liste, remplissez les 4 éditeurs, cliquez sur ``fill with mouse'' puis dessinez un rectangle sur la fenêtre ``Sphinx_show_page''. Vous pouvez également utiliser le bouton ``replace''.

12.7  PRINT & SETTINGS->XFIG TOOLS

Les images sont rangées dans divers répertoires sous $home/.Msphinx.

==========================================================

Chapitre 13
ABOUT

13.1  About->Authors panel...

13.2  About->Memory...

13.3  About->LUT...

13.4  About->Server...

13.5  About->Tests->Send image test to display

13.6  About->Tests->Send image test to cells

13.7  About->Tests->Kaleidescope

**********************************************************

Part 2
Utilisation d'un fichier de commandes

                													LINEAR[..],		POLDER[..],		GOODE[..],	MOLLWEIDEEA[3],
                													HAMMER[3],		AZIMUTHAL[2,3],		LAMBERT[2,3],	MILLER[3],
                													MOLLWEIDE[3],		ORTHOGRAPHIC[2,3],	ROBINSON[3],	SINUSOIDAL[3],
                													VANDERGRINTEN[3],	WAGNER7[3],		MODIS[0,3,8,9]