*********** QU'EST CE ? *********** "MODNUM" est une boîte à outils pour la modélisation et la simulation des systèmes de communication. Cette boîte à outils propose des blocs, des schémas et des fonctions pour des modulations MDP/MAQ en bande de base, afin de réaliser des chaînes de communications. Des composants pour construire des systèmes à étalement de spectre sont aussi inclus, comme des générateurs de séquence pseudo-aléatoire (générateur de séquence de Gold, PN et quasi-chaotiques) ainsi que quelques "oscilloscopes" pour Scicos (analyseur de spectres, diagramme de l'oeil, constellation,...). Des schémas et des blocs constitutifs de synthétiseurs de fréquence à rapport de division entier et fractionnaire (Détecteur phase/fréquence, OCT, modulateurs Sigma-Delta et autres) sont fournis. Cette boîte à outils concerne aussi la simulation de systèmes chaotiques et donne des schémas des systèmes de Chua, de Rössler, de Van Der Pol, et bien d'autres. ************ INSTALLATION ************ Pour les fonctions Scilab, ScicosLab ou Nsp est nécessaire. Pour les blocs Scicos, Scicos est nécessaire. Plateforme Windows ------------------ - Version binaire - Exécuter le fichier script loader.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou Nsp. Si vous avez un droit d'accés en écriture au répertoire de ScicosLab ou Nsp vous pouvez installez la boîte à outils dans le répertoire contrib de ScicosLab (ou bien toolboxes pour Nsp), pour charger Modnum par le menu Toolboxes. - Version source (MSVC et LCC-Win32 supportés) - (pas de compilateur Fortran supporté pour le moment) 1 - Exécuter le fichier script builder.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou bien le ficher builder_nsp.sce pour Nsp. 2 - Pour recharger la boîte à outils, exécuter simplement le fichier script loader.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou Nsp. RMQ: * Si vous ne possédez pas de compilateur MSVC, vous pouvez utiliser LCC-WIN32 (pour applications non-commerciales) et l'installer dans le répertoire de ScicosLab. (voir : scilab-x.x\lcc\Readme_LCC.txt) * LCC-WIN32 n'est pas supporté dans Nsp. * La compilation de la boîte à outils sous Windows avec Nsp et MSVC nécessite des fichiers supplémentaires comme des en-têtes gtk et fftw. La version courante pour Nsp sous windows est compilée à partir du paquet source et d'une chaîne de compilation croisée MINGW32. La compilation est effectuée sous Linux en utilisant le script configure (voir plus bas pour plus de détails) comme par exemple : ./configure --host=i686-pc-mingw32 --with-nspsrc=nspdir_cross avec nspdir_cross le chemin d'une version de Nsp "cross-compilée". * Sur la plateforme Windows : - Les routines Fortran ne sont pas compilées. - La documentation n'est pas constructible. Plateforme Linux/Unix --------------------- - Version source (gcc supporté) - Méthode A : Construction dans ScicosLab/Nsp 1 - Exécuter le fichier script builder.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou bien builder_nsp.sce pour Nsp. 2 - Pour recharger la boîte à outils, exécuter simplement le fichier script loader.sce du répertoire racine de la boîte à outils dans une session ScicosLab/Nsp ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer ScicosLab (cette méthode n'est pas supportée pour Nsp). Méthode B : Construction avec Makefile 1 - Aller dans le répertoire racine de la boîte à outils et éxecuter le script de configuration : ./configure --with-scisrc=scicoslabdir --with-gtk2 ou bien pour Nsp : ./configure --with-nspsrc=nspdir --with-gtk2 Vous devez posséder une version de ScicosLab ou bien de Nsp. Les chemins scicoslabdir ou nspdir correspondant aux endroits où sont installés les logiciels (typiquement dans /usr/lib/scicoslab-gtk-4.4.1 ou /usr/lib/nsp). Exécuter ensuite 'make all' à la racine du répertoire. 2 - Pour recharger la boîte à outils, exécuter simplement le fichier script loader.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou Nsp ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer ScicosLab (cette méthode n'est pas supportée pour Nsp). - Version binaire - Exécuter le fichier script loader.sce du répertoire racine de la boîte à outils dans une session ScicosLab ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer ScicosLab (cette méthode n'est pas supportée pour Nsp). ************* DOCUMENTATION ************* - La version source et binaire de la boîte à outils devraient contenir une documentation au format html. L'index principal de cette documentation est accessible grâce au fichier "whatis.htm" situé dans les répertoires MODNUM/interf/scicos/help pour Scicos et MODNUM/interf/scicoslab/help pour Scicoslab. - Deux langues sont supportées par le système de documentation : l'anglais et le français. **************************** CONTENU DE LA BOITE A OUTILS **************************** ./src : routines de calcul bas-niveau de "modnumlib" ./interf : repertoires des fonctions d'interfacage ./interf/nsp : interfaces nsp demos : démonstrations nsp gateway : fonctions d'interfacages nsp ./inter/octave : interfaces octave ./interf/scicos : interfaces scicos demos : démonstrations scicos examples : exemples scicos scs_diagr : répertoire des diagrammes scicos comsys : schémas de systèmes de communication dyna : schémas de systèmes non-linéaires chaotiques pll : schémas de synthétiseurs de fréquence et de boucles à verrouillage de phase simu : répertoires de simulations de système de communication gif_icons : icones gif des blocs scicos (pour Scicoslab) png_icons : icones png des blocs scicos (pour Nsp) help : répertoire de documentation scicos macros : répertoire des macros scilab build_util : macros utilisées pour la construction de la boîte à outils pll : macros pll scicos_blocks : fonctions d'interfacages des blocs scicos scicos_util : macros utilisant la fonction scicos_simulate signal : macros pour le traitement du signal routines : fonctions de calcul des blocs scicos ./interf/scicosLab : interfaces scicoslab demos : démonstrations scicoslab examples : exemples scicoslab gateway : fonctions d'interfacages scicoslab help : répertoire de documentation scicoslab macros : répertoire des macros scicoslab ************************* DROIT DE COPIE ET LICENCE ************************* La boîte à outils "Modnum" est basée sur le travail de la thèse "Développement de modèles de CAO pour la simulation système des systèmes de communication" (http://www.unilim.fr/theses/2006/sciences/2006limo0006/notice.htm) A travers l'évolution de la boîte à outils "Modnum", une librairie appelée "modnum_lib" (dédicacée à la modélisation et à la simulation des systèmes de communications) est maintenant libre. La librairie "modnum_lib" (Copyright (C) 2007-2013 Alan Layec) est sous licence GPL. Pour les versions de Modnum >= 4.2.1, "modnum_lib" inclut tous les fichiers source en C de la boîte à outils. Tous les fichiers de cette boîte à outils qui ne sont pas inclus dans "modnum_lib" et qui sont pas sous droit de copie sont totalement libres d'utilisation ou bien sous restrictions de la licence Scilab. ******* SUPPORT ******* - Le support pour les differentes méthodes d'installation, la correction des bogues ainsi que la mise à jour de la boîte à outils sont pour l'instant assurées. Celles-ci peuvent être réclamées à alan.layec@cermics.enpc.fr. ****** AUTEUR ****** Alan Layec