*********** 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. Plate forme 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. La variable d'environnement SCI doit être spécifiée. Si vous ne possédez pas de la version source de Scilab alors changez les chemins spécifiés par INCLUDE_DIRS en : INCLUDE_DIRS=-I(MODNUM)/routines/sci_headers puis exécuter "make all". 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. Plate forme Windows ---------------------- - Version source (VC++ 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 VC++, 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 plate forme 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/htm/eng/ et MODNUM/man/htm/fr/. - 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/pdf/eng/ et MODNUM/man/pdf/fr/. - Deux langues sont supportées par le système de documentation : l'anglais et le français, mais pour l'instant, les efforts de documentation se focalisent sur la version anglaise. - La construction de la documentation de cette boîte à outils est seulement possible sous environnement Linux, car elle nécessite des outils comme xwd, xfig/transfig et une bonne distribution LaTex. Si vous voulez essayer de construire la documentation sous environnement Linux, suivez ces différentes étapes : -->exec(MODNUM+"/loader.sce"); -->exec(MODNUM+"/macros/generate_doc/load_generate_doc_function.sce"); -->generate_mod_num_html('all'); //génération de la doc. html -->generate_mod_num_guide('ref'); //génération du guide de référence -->generate_mod_num_guide('user'); //génération du guide de l'utilisateur -->generate_mod_num_guide('internal'); //génération du guide interne - Le répertoire de documentation de la boîte à outils est ./man et il contient les répertoires suivants : ./man/data : répertoire des fichiers de données. ./man/demos : répertoire des démonstrations. ./man/htm : répertoire des pages html pour le navigateur web de Scilab. ./man/pdf : répertoires des manuels. ./man/sblock_equiv : répertoires des modèles équivalents sous forme de super blocs. ./man/tex : répertoire des fichiers sources LaTex et Xfig. ./man/xml : répertoire des fichiers XML. ./man/web : répertoire du site web de la boîte à outils. **************************** CONTENU DE LA BOITE A OUTILS **************************** ./macros : répertoire des macros Scilab. ./macros/generate_doc : macros du générateur de documentation. ./macros/gen_doc_util : macros utilitaires pour le générateur de documentation. ./macros/xml2tex : macros de conversion entre fichiers XML et fichiers LaTex ./macros/misc : macros diverses. ./macros/scicos_blocks : fonctions d'interface des blocs Scicos. Communication : palette Communication 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 (!) ./macros/build_util : macros utilisées pour la construction de la boîte à outils. ./macros/find_file : macros de gestion de fichiers. ./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. ./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. ******* SUPPORT ******* - Aucun support d'installation et d'utilisation de cette boîte à outils n'est pour l'instant assuré. Les seules informations concernant l'installation et 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. - La correction des bugs ainsi que la mise à jour de la boîte à outils, en cas de changement de version majeure (x.) du logiciel Scilab, sont pour l'instant assurées. La correction des bugs et les mises à jour peuvent être réclamées à l'adresse e-mail : alan.layec@brive.unilim.fr. ****** AUTEUR ****** Alan LAYEC Université de Limoges IRCOM 123 Rue Albert Thomas 87000 LIMOGES email : alan.layec@brive.unilim.fr