*********** 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 (Oscilloscope de trajectoires 3D, 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 ************ Une version de Scilab >=3.0 est nécessaire. Plateforme Linux/Unix ---------------------- - Version source (gcc/g77 supportés) - Méthode A : Construction dans Scilab 1 - Exécuter le fichier script builder.sce du répertoire racine de la boîte à outils dans une session scilab. 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 scilab ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer scilab. Méthode B : Construction avec Makefile 1 - Aller dans le répertoire racine de la boîte à outils et modifier les chemins spécifiés dans le fichier Makefile.incl. Les variables SCI et MODNUM doivent être spécifiées. Vous devez posséder une version source de scilab. 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 scilab ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer scilab. Autres options fournies par Makefile : make clean : enlève les fichiers objets (.o) des répertoires de routines et enlève quelques autres fichiers temporaires (*~) des répertoires de la boîte à outils. make distclean : nettoie tous les répertoires de la boîte à outils (fichiers objets, librairies, macros compilées,...). make targz : crée un fichier .tar.gz de la boîte à outils. make srctargz : exécute make distclean puis make targz. - Version binaire - Exécuter le fichier script loader.sce du répertoire racine de la boîte à outils dans une session scilab ou à partir d'un terminal, aller dans le répertoire racine de la boîte à outils et lancer scilab. Plateforme Windows ---------------------- - 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 scilab. 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 scilab. 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 Scilab. (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. - Version binaire - Exécuter le fichier script loader.sce du répertoire racine de la boîte à outils dans une session scilab. ************* 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/man/eng/htm et MODNUM/man/fr/htm. - Seule la version binaire de la boîte à outils devrait contenir la documentation papier, détaillée en trois manuels : * modnum_ref : guide de référence. * modnum_user : guide de l'utilisateur. * modnum_internals : guide interne. Ces manuels sont disponibles au format pdf dans les répertoires MODNUM/man/eng/pdf et MODNUM/man/fr/pdf. - Deux langues sont supportées par le système de documentation : l'anglais et le français. - Le répertoire de documentation de la boîte à outils est ./man et il contient les répertoires suivants : ./man/demos : répertoire des démonstrations ./man/xx/htm : répertoires des pages html pour le navigateur web de Scilab ./man/xx/pdf : répertoires des manuels ./man/xx/xml : répertoires des fichiers XML avec xx la langue (français :fr, anglais :eng). **************************** CONTENU DE LA BOITE A OUTILS **************************** ./macros : répertoire des macros Scilab ./macros/build_util : macros utilisées pour la construction de la boîte à outils ./macros/find_file : macros de gestion de fichiers ./macros/gif_icons : icones gif pour le visualisateur de blocs de scicos ./macros/misc : macros diverses ./macros/scicos_blocks : fonctions d'interface des blocs Scicos Communication : palette Communication Filter : palette Filter NonLinear : palette Non-Linear Pll : palette Phase Locked Loop Sinks : palette Sinks Sources : palette Sources Tools : palette Tools ./macros/scicos_util : quelques macros utilisant la fonction scicos_simulate ./macros/signal : macros signal (!) ./man : répertoire de documentation de la boîte à outils -voir la section documentation- ./routines : répertoire des routines C et Fortran ./routines/mod_num_lib : routines de calcul bas-niveau et fonctions d'interfaces de "modnumlib" ./routines/scicos : fonctions de calcul des blocs scicos ./scs_diagr : répertoire des diagrammes scicos ./scs_diagr/dyna : schémas de systèmes non-linéaires chaotiques ./scs_diagr/comsys : schémas de systèmes de communication ./scs_diagr/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 ************************* DROIT DE COPIE ET LICENCE ************************* La boîte à outils "Modnum" est basée sur le travail original 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) Ce travail original appartient aux instituts français de recherches XLIM et INRIA. Cependant, à 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 autonome. La librairie "modnum_lib" (Copyright (C) 2007 Alan Layec) est sous licence GPL. 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 ******* - Aucun support d'utilisation de cette boîte à outils n'est pour l'instant assuré. Les seules informations concernant l'utilisation de cette boîte à outils sont disponibles via ce fichier README et les différents fichiers de documentation inclus dans la boîte à outils. - 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@inria.fr. ****** AUTEUR ****** Alan Layec INRIA - Unité de Rocquencourt Domaine de Voluceau, BP 105 78153 Le Chesnay Cedex France email : alan.layec@inria.fr