*********** 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 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. Si vous avez un droit d'accés en écriture au répertoire de ScicosLab vous pouvez installez la boîte à outils dans le répertoire contrib de ScicosLab, pour charger Modnum par le menu Toolboxes de ScicosLab. - 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. 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. 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) * 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 1 - Exécuter le fichier script builder.sce du répertoire racine de la boîte à outils dans une session ScicosLab. 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 à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer ScicosLab. 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=yourscisrcdir --with-gtk2 Vous devez posséder une version de ScicosLab. Exécuter all '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 à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer ScicosLab. - 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. ************* 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 Scilab. - 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 ./inter/octave : interfaces octave ./interf/scicos : interfaces scicos demos : demonstrations 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 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 scilab demos : demonstrations scilab examples : exemples scilab gateway : fonctions d'interfacages scilab help : répertoire de documentation scilab macros : répertoire des macros scilab ************************* 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-2011 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 sous la licence et droit de copie de la librairie "modnum_lib" 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 à support@scicoslab.org. ****** AUTEUR ****** Alan Layec