********* WHAT IS ? ********* "MODNUM" is a toolbox for the modelling and the simulation of communication systems. This toolbox proposes blocks, schematics and in-line functions of base-band PSK/QAM modulations in order to build communication chains. Components used to build spread-spectrum communication systems, such Pseudo Noise sequence generators (Quasi-Chaotic, PN and Gold sequence generators) are also included as well as some miscellaneous scopes for scicos (spectrum analyzer, eye diagram Scope, scattered diagram scope,...). Schematics and blocks of integer and fractionnal frequency synthesizer components (Phase/Frequency Detector, VCO, Delta-Sigma modulators and others) and are provided. This toolbox also focus on the simulation of chaotic systems and gives schematics of Chua's, Rössler's, Van-der Pol's systems (and others). ******* INSTALL ******* For the Scilab functions, you need ScicosLab. For the Scicos blockset, you need Scicos. Windows platform ---------------- - Binary version - Run the loader.sce script file provided in the root directory of the toolbox in a ScicosLab session. If you have a writting access to the ScicosLab directory, you can install the toolbox in the contrib directory of ScicosLab to load Modnum from the Toolboxes menu of ScicosLab. - Source version (MSVC and LCC-Win32 are supported) - (No fortran compiler supported at this time) 1 - Run the builder.sce script file provided in the root directory of the toolbox in a ScicosLab session. 2 - To reload the toolbox, simply run the loader.sce script file provided in the root directory of the toolbox in a ScicosLab session. RMK : * If you don't have a MSVC compiler, you can use LCC-WIN32 (for non-commercial use) and put it into the directory of ScicosLab. (see : ScicosLab-x.x\lcc\Readme_LCC.txt) * On windows platform : - Fortran routines are not compiled. - Documentation isn't build. Unix/Linux platform ------------------- - Source version (gcc is supported) - Method A : Construction in ScicosLab 1 - Run the builder.sce script file provided in the root directory of the toolbox in a ScicosLab session. 2 - To reload the toolbox, simply run the loader.sce script file provided in the root directory of the toolbox in a ScicosLab session or go to the root directory of the toolbox and launch ScicosLab from a terminal prompt. Method B : Construction with Makefile 1 - Go to the root directory of the toolbox and run the configure script : ./configure --with-scisrc=yourscisrcdir --with-gtk2 You must have ScicosLab. Then run 'make all' at the root directory. 2 - To reload the toolbox, simply run the loader.sce script file provided in the root directory of the toolbox in a ScicosLab session or go to the root directory of the toolbox and launch ScicosLab from a terminal prompt. - Binary version - Run the loader.sce script file provided in the root directory of the toolbox in a ScicosLab session or go in the root directory of the toolbox and launch ScicosLab from the terminal prompt. ************* DOCUMENTATION ************* - The source version and the binary version of this toolbox should include a html format documentation. Main index of this documentation is available by the "whatis.htm" file in the directories MODNUM/interf/scicos/help for Scicos and MODNUM/interf/scicoslab/help for Scilab. - Two languages are supported : english and french. **************** TOOLBOX CONTENTS **************** ./src : low-level computational routines of "modnumlib" ./interf : interfacing functions directory ./interf/nsp : interfacing functions for nsp ./inter/octave : interfacing functions for octave ./interf/scicos : interfacing functions for scicos demos : demonstrations of scicos examples : examples of scicos scs_diagr : directory of scicos diagrams comsys : diagrams of communication systems dyna : diagrams of non-Linear chaotic systems pll : diagrams of frequency synthesizer and PLL simu : directory of simulations of communication systems gif_icons : directory of gif icons of scicos blocks help : directory of man pages of scicos macros : directory of scilab macros build_util : macros used for the building of the toolbox pll : pll macros scicos_blocks : interfacing functions of Scicos blocks scicos_util : some macros which use scicos_simulate function signal : signal macros routines : scicos blocks computational functions ./interf/ScicosLab : interfacing functions for scilab demos : demonstrations of sciclab examples : examples of scilab gateway : interfacing functions of scilab help : directory of man pages of scilab macros : directory of scilab macros ********************* COPYRIGHT AND LICENSE ********************* "Modnum" toolbox is based on the thesis work "Development of CAD models for the system level simulation of communication systems" (http://www.unilim.fr/theses/2006/sciences/2006limo0006/notice.htm) With the evolution of the "Modnum" toolbox, a library called "modnum_lib" (dedicated to the modelling and simulation of commmunication systems) is now free. The "modnum_lib" (Copyright (C) 2007-2011 Alan Layec) library is under GPL license. For Modnum realases >= 4.2.1, "modnum_lib" includes all C source files of the toolbox. All source files that you can find in this toolbox that are not included in the "modnum_lib" library are completely free of use or under Scilab restrictions license. ******* SUPPORT ******* - Support for installation issues, bug fixs and updates of this toolbox, are at this time provided. This can be claimed to support@scicoslab.org. ****** AUTHOR ****** Alan Layec