[INTERNAL] Creation d'applications client pour ENVI ou IDL

Berangere Casson Tuesday, June 26, 2007

Cet article liste les étapes clés nécessaires à la création d'applications client pour ENVI ou IDL. Ces applications pourront alors être distribuées sous la forme de fichiers .sav contenant le code compilé. Pour plus de détails sur chaque étape vous pouvez vous référer à l'aide en ligne ENVI ou IDL.

Notes:

- La création d'application client nécessite de disposer d'une licence IDL de développement (ou d'une licence ENVI pour les applications ENVI). Des licences supplémentaires pourront être nécessaires en fonction des modules optionnels utilisés.

- Dans la suite de ce document toute référence à ENVI correspond à ENVI+IDL qui est l'environnement de développement ENVI.

Etape 1: Création de l'application dans un fichier .pro IDL ou ENVI et sauvegarde du fichier. Le nom du fichier devra être le même que celui de la procédure principale.

;*********************************************************************************
   ; Exemple de code

   FUNCTION create_data
      data=FINDGEN(100)
      RETURN,data
   END

   ;Procedure principale
   PRO application
      PLOT,create_data(),TITLE='Application Exemple'
      WAIT,5
   END
;*********************************************************************************

   Dans cet exemple le fichier sera sauvé sous le nom 'application.pro '

Note: Il est important de toujours s'assurer que l'application fonctionne correctement à cette étape avant de poursuivre.


Etape 2: Nettoyage et ré-initialisation de la session IDL avec la commande:

   .FULL_RESET_SESSION

Etape 3: Compilation de l'application:

   .COMPILE application

Etape 4: Résolution de toutes les dépendances. Cette étape diffère en fonction du type de code utilisé:

   a) Pour une application simple, utiliser la commande:

      RESOLVE_ALL

   b) Pour une application contenant des iTOOLS, utiliser la commande: :

     ITRESOLVE

   c) Pour une application contenant des classes d'objets, les dépendances de chaque classe d'objets doivent être prises en compte. Par exemple si l'application fait appel à des objets des classes Trackball et IDLexShow3 la commande suivante devra être utilisée :

      RESOLVE_ALL, CLASS=['Trackball', 'IDLexShow3']

Etape 5: Création du fichier .sav :

SAVE, /ROUTINES, FILENAME='c:\temp\application.sav'

Note: Le fichier *.sav devra avoir le même nom que la procedure principale de l'application .

Etape 6: Lancer l'application:

Applications IDL

Une application client IDL pourra être lancée soit à partir de la Virtual Machine ou d'IDL Runtime (cette dernière nécessitant une licence). Des licences additionnelles pourront être nécessaires en fonction des modules optionnels utilisés par l'application. Les différentes méthodes de lancement de l'application client sont discutées ci-dessous en fonction des plateformes.

   Windows

   Méthode 1: drag'n drop du fichier *.sav sur l'icone de la Virtual Machine IDL présent sur le bureau.

   Méthode 2: Double clic sur l'icone de la Virtual Machine IDL puis sélection du fichier *.sav .

   Méthode 3: lancement des commandes suivantes dans une invite DOS depuis le répertoire \idlx.x\bin\bin.x86\ ou \idlx.x\bin\bin.x86_64\ :

      idlrt -vm= c:\temp\application.sav (Virtual Machine)

      idlrt c:\temp\application.sav (IDL Runtime - licence requise)


   Macintosh

   Méthode 1: Double clic sur l'application Virtual Machine IDL puis sélection le fichier *.sav .

   Méthode 3: Ouvrir un terminal X et lancer les commandes suivantes :

    idl -vm=\usr\tmp\application.sav (Virtual Machine)

    idl -rt=\usr\tmp\application.sav  (IDL Runtime - licence requise)


   UNIX /Linux

Ouvrir un terminal X et lancer les commandes suivantes :

idl -vm= \usr\tmp\application.sav (Virtual Machine)

idl -rt= \usr\tmp\application.sav (IDL Runtime, licence requise)

Applications ENVI/ ENVI Runtime

Le lancement d'une application client ENVI nécessite au minimum une licence ENVI Runtime. Pour lancer une telle application nous vous invitons à suivre les étapes ci-dessous:

Etape 1
Ajouter le fichier *.sav au répertoire save_add d'ENVI. Par exemple sur une installation par défaut sous WINDOWS ce répertoire est situé dans le chemin suivant:

C:\Program Files\Exelis\envixx\classic\save_add

Etape 2
Pour ajouter un nouveau menu personnalisé au menu ENVI, afin de pouvoir appeler cette nouvelle application, vous pouvez éditer le fichier ENVI 'envi.men' avec un editeur de texte. Ce fichier se situe dans le répertoire suivant sur une installation par défaut WINDOWS:

C:\Program Files\Exelis\envixx\classic\menu

A la fin de ce fichier vous pouvez par exemple ajouter les lignes suivantes:

0 {User application}
1 {User function} {not used} { application }

Note: Si l'application utilise la routine ENVI ENVI_DEFINE_MENU_BUTTON, cette etape n'est alors pas nécessaire.

Etape 3
Redémarrer ENVI. Le nouveau menu doit maintenant apparaitre dans la barre de menu ENVI.

Etape 4
Lancer l'application en utilisant ce nouveau menu

User application > User function