http://www.saphir-control.fr/

Les Contributions au Logiciel Libre Scilab

Papa Momar Ndiaye & Matthieu Philippe
Société Saphir Control
s/c INRIA Rocquencourt BP105,
78153 Le Chesnay Cedex, France
www.saphir-control.fr

1   Introduction

2   Installation

1. Extraction de l'archive

   -->unix('tar xzf slicot-1.0.tar.gz') //extraction : commande unix 
    ans  =
    
       0.
   

2. Positionnement dans le répertoire nouvellement crée et installation de la contribution en lançant le script builder.sce

   -->chdir slicot-1.0
    ans  =
   
       0.
   --> 
   -->exec("builder.sce") // installation 
   
   -->mode(-1)
   
    Be patient, this may take a while
   
    making all in slicot
   
    making all in auxiliary
   Warning :redefining function: compile
   
   
    making all in slicot-scilab
   
   -->
   

   Cette opération d'installation est à exécuter une fois pour toutes.
3. Chargement de la contribution en lançant le script loader.sce

   -->exec("loader.sce") // chargemant 
   -->mode(-1)
   linking files
   /home/saphir-control/slicot-1.0/src/slicot-scilab/slicot_gateway.o
   /home/saphir-control/slicot-1.0/libs/slicotlib.a
   /home/saphir-control/slicot-1.0/libs/slicotaux.a
   to create a shared executable
   shared archive loaded
   Linking slicot_gateway
   Interface 0 slicot_gateway
   --> 
   
   

3   Construire votre propre contribution

3.1   Architecture d'une contribution

1. Un fichier d'installation : script Scilab builder.sce exécuter une seule fois par l'administrateur.
2. Un fichier de chargement de chargement des fonctions dans l'environnement Scilab : script Scilab loader.sce à exécuter par l'utilisateur.
3. Un fichier README décrivant le contenu de la contribution ainsi que la procédure d'installation.
4. Un répertoire src contenant les sources des routines C ou Fortran ainsi qu'un fichier C ou Fortran contenant la routine d'interface avec Scilab (Cf. Linuxmag numéro 26)
5. Un répertoire macros contenant les macros Scilab.
6. Un répertoire examples contenant les examples.
7. Un répertoire man contenant les pages du manuel de vos fonctions. Un fichier whatis et un fichier *.cat sont nécessaires pour chaque fonction.
8. Un répertoire doc contenant la documentation aux formats ps, pdf, html, tex.

[saphir-contol slicot-1.0]: ls
Makefile      builder.sce  libs/       macros/     src/
texput.log    Makefile.mak doc/        loader.sce  man/
tests/

3.2   Construction des fichiers d'installation et des pages de help

• · création des Makefiles si nécessaire ;
• · lancement des commandes de compilation ;
• · création des librairies Scilab, si nécessaire ;
• · éventuellement création de la macro Scilab loader.sce.

1. une partie spécifique contenant les définitions des noms de librairies ;
2. une partie générique contenant :
   • des instructions de positionnement de Path,
   • des instructions permettant la génération automatique des Makefile et la compilation des fichiers Fortran et C,
   • des instructions permettant la génération de la librairie de macros Scilab,
   • et éventuellement des instructions permettant la génération du fichier loader.sce.

3.3   Un petit exemple

#include "/usr/local/scilab-2.6/routines/machine.h"
int F2C(ext1c)(n, a, b, c)
     int *n;
     double *a, *b, *c;
{
  int k;
  for (k = 0; k < *n; ++k)
      c[k] = a[k]*a[k] + b[k]*b[k];
  return(0);
} 

      subroutine fsom(n,a,b,c)
      real a(*),b(*),c(*)
      do 1 k=1,n
 1       c(k)=a(k)*a(k)/(b(k)*b(k))
      end 

1. Création d'un répertoire src dans lequel on copie les fichiers source C et Fortran.
2. Utilisation de intersci, par exemple, pour générer une interface commune pour les fichiers C et Fortran.
3. Création du répertoire macros dans lequel on met les 3 fonctions Scilab : add_sq.sci, div_sq.sci et bizarre.sci.
4. Création du répertoire man dans lequel on met les 3 trois fichiers-sources du help : add_sq.man, div_sq.man et bizarre.man. Ces fichiers seront compilés lors de l'exécution du builder.sce qui lance la commande Scilab formatman.
5. Construction du builder.sce et du loader.sce en adaptant celui donné dans le GUIDELINE.tar.gz.
6. Installation de la contribution avec le builder.
7. Chargement de la contribution avec le loader.

-->;exec("builder.sce");
  
Building PETITE ALGEBRE
  
Building Completed

Manuel Installed

-->;exec("loader.sce"); 
linking files /home/saphir-control/example/src/exf.o 
/home/saphir-control/example/src/ex1c.o 
/home/saphir-control/example/src/ex2f.o  
to create a shared executable
shared archive loaded
Linking exf 
Interface 0 exf
 
PETITE ALGEBRE loaded
Primitive add_square added
Primitive div_square added
 
Very Exotic library totolib loaded
 
 Functions files location :/home/saphir-control/example/macros/
 
 add_sq    bizarre   div_sq    

-->x = [1 2 3]
 x  =
 
!   1.    2.    3. !
 
-->y = 2 *x
 y  =
 
!   2.    4.    6. !
 
-->div_sq(x,y)
 ans  =
 
!   0.25 !
!   0.25 !
!   0.25 !
 
-->div_sq(x',y')  
 ans  =
 
!   0.25 !
!   0.25 !
!   0.25 !

-->add_sq(x, 2*x)
 ans  =
 
!   5.  !
!   20. !
!   45. !

3.4   Soumission d'une contribution

1. fabriquer une archive contenant votre contribution et de remplir un fichier lsm (cf http://metalab.unc.edu/pub/Linux/LSM-TEMPLATE) ou alors un fichier texte contenant les informations suivantes :
   • Title:
   • Version :
   • Description :
   • Author:
   • Maintained-by:
   • Maintained-at:
   • Platforms:
   • Copying-Policy:
   • Keywords:
2. déposer le tout par ftp à l'adresse : ftp://ftp.inria.fr/INRIA/Projects/Meta2/Scilab/incoming/
3. envoyer un mail à Scilab@inria.fr pour information.

4   Annexe : liste des contributions

• ANN : conception de réseaux de neuronnes.
• CmapUtility : Manipulation des cartes de couleurs.
• DYNOPTIM : Discrete time optimal control problems.
• EMACS : Mode scilab sous emacs.
• ENRICO : Fonctions graphiques de haut niveau pour l'imagerie.
• EVOL : Evolution strategies.
• FABBRI : Fonctions graphiques de haut niveau pour l'imagerie.
• FAULT_D : Détection de pannes.
• FEM_Post : Finite Element Post Processing.
• FISLABFuzzy : Commande à logique floue.
• FRACLAB : Manipulation de Fractales.
• FREEFEM : Eléments finis 2d.
• FSQP : Interface Scilab-FSQP pour l'optimisation.
• FISLAB :  Fuzzy logic inference.
• GENFILT : Code assembleur pour l'implémentation de filtre IIR.
• GUIDELINE : Guide pour la construction de contributions.
• HMM : Chaînes de Markov.
• IMAGE : Lecture et l'écriture d'images aux formats PBM, PPM ou PGM.
• Interactive documents with Scilab : Interface pour appeler Scilab à partir d'un document PDF ou HTML.
• LABOSTAT : Fonctions basiques pour les statistiques.
• LIPSOL : Programmation Linéaire par points intérieurs.
• Mac : Macintosh 2.1.1 version.
• MAXPLUS : Algèbre Maxplus.
• MODAL : Output modal analysis and diagnosis
• NETBSD : Support pour NetBSD.
• NURBS : Nurbs library.
• OLDSAVE :  chargement des fichiers sauvegardés avec des vielles version s de Scilab.
• Plotting library : Fonctions émulant le plot() de Matlab.
• POLYTOOL : Manipulation de polynômes.
• RAYPP :  Quick travel-time calculations of P-P reflections for flat earth.
• SCIGRAPH : Manipulation de graphes METANET.
• SLICOT : Interface with SLICOT.
• STIXBOX : Package de statistiques pour l'agregation de mathématiques.
• TELECOM : Simulation des chaînes de transmission numrique de télcommunications.
• TIME SERIES PLOTTING.
• TKGUI : Fonctions et IHM utilisant TCL/TK.
• XPM : Génération d'images bitmap XPM contenant des pixels.

This document was translated from L^AT_EX by H^EV^EA.