
                                MegaWave2 Versions 2.x and 3.x



Please read this note entirely before installing MegaWave2.


1) COPYRIGHT AND LICENSE

  MegaWave2 is a "software publication" from a french laboratory of applied mathematics, 
the CMLA (CNRS UMR-8536). Please read the file COPYRIGHT to learn more on the different
contributions. 
  This is a free, open source software : you may freely use it, copy it, distribute it 
and modify it providing that you follow the conditions set in the file LICENSE. 


2) WHAT IS MEGAWAVE2

  MegaWave2 is a Unix software environment which help human being to write algorithms
on signal processing and image analysis. 
  The human being is actually assumed to be non-computer scientist, in 
particular he is likely to be a mathematician (notice however that a good 
knowledge of the C language is assumed).

  This means that the programmer should focus its mind on the algorithm only and
not on pure computer problems (such how to read an image, how to display a movie
on the screen, how to select a curve with the mouse, how to manage an object 
library). 

  The solution adopted by MegaWave2 is the concept of modules that is, of black
boxes where the algorithms are described as C functions, without any 
assumption about the context in which the modules may be executed.
This is the task of the MegaWave2 compiler (basically a MegaWave2 preprocessor
followed by a standard C compiler) to make from a module a run-time command, 
a function of a library or a function to be run under a window-oriented 
interpreter.

  Anyway, there exists other very good signal and image processing softwares.
Therefore, the main advantage you may see by using MegaWave2 is to have access to
some modules implementing new algorithms not available elsewhere. Indeed, if
MegaWave2 is first used as a research tool inside our team, its publication outside
our lab participates in reproducible research : you will find here most of the
source codes that have been used to perform the experiments presented in our
traditional paper publication.


3) HOW TO GET THE LAST VERSION OF MEGAWAVE2 3.x

  From the Web site http://www.cmla.ens-cachan.fr/Cmla/Megawave
download the main package named MegaWave2_V3.<x>.tar.gz (if you have gunzip) or
MegaWave2_V3.<x>.tar.Z (if you don't), where <x> is a minor version number.

  Decompress the main package using the command:
		gunzip MegaWave2_V3.<x>.tar.gz
	  or 
		uncompress MegaWave2_V3.<x>.tar.Z  

  Then restore the main package MegaWave2 by typing
		tar xf MegaWave2_V3.<x>.tar

  in the current local directory where you want to put the software.


4) HOW TO INSTALL MEGAWAVE2
  
  The complete procedure to install MegaWave2 is described in the section 2 of 
the guide #1 "MegaWave2 User's Guide".
  So the first step of the installation should be to print this guide. You will 
find it in the subdirectory "doc" of the main package, under two formats: 
guid1.dvi (DVI format produced by LaTeX) and guid1.ps (PostScript format). You may 
also want to print the other guides but there are not needed for the installation.

  There exists a shell script Install that will try to do the installation for you. 
To run it, just call ./Install from the MegaWave2 root directory. This shell works
for the very common systems and machine architectures only. 


5) SYSTEM REQUIREMENT AND COMPATIBILITY

  MegaWave2 needs a Unix system with the following standard tools :

  [in brackets one gives the group or section name where the 
   corresponding package is usually located on standard Linux distributions. 
   Beware, some of these packages are not selected by default during Linux 
   installation stage !]

  C compiler K&R or ANSI-compliant                       [Development/C]
  Bourne shell script /bin/sh (bash on Linux)            [Shells] or [Base system]
  X11 libraries and development files (libx11-dev)       [System/XFree86] or [Libraries/Development]
  bc/dc                                                  [Sciences/Mathematics] or [Mathematics]
  LaTeX (since MegaWave2 Vers 2.10 LaTeX2e is assumed)   [Publishing] or [TeX Authoring]

  The 'traditional' preprocessor needs the additional standard tools 
(note : the 'traditional' preprocessor is the standard one on versions 2.x;
on versions 3.x the standard is the 'light' preprocessor. Therefore, you don't need
these tools on versions 3.x) :

  C language preprocessor cpp                             [Development/C] or [Interpreted Computer Languages]
  Parser generator yacc or bison                          [Development/Other] 
  Lexical analyzer generator lex or flex                  [Development/Other]

  The following tools are not needed but highly recommended :

  JPEG library and development files (libjpeg*-dev)       [Libraries/Development]
  TIFF library and development files (libtiff*-dev)       [Libraries/Development]
  ImageMagick, xv or other image display tool             [Graphics]
	
  The installation procedure has been successfully checked on the following Unix
  systems. Notice that 64-bit Unix are not supported at that time.
  On versions 3.x, syntax error may occur with the 'traditional' preprocessor; 
  the 'light' preprocessor is the default. 

  MegaWave2 Vers 3.00 & 3.01 :
    - Linux :
      + Ubuntu 7.04 (The Feisty Fawn) kernel  2.6.20-15-generic (gcc 4.1.2, glibc 2.5)
      + Ubuntu 6.06.1 LTS (Dapper Drake) kernel 2.6.15-28-386 (gcc 4.0.3, glibc 2.3.6)
      + Ubuntu 5.10 (Breezy Badger) kernel 2.6.12-10-386 (gcc 4.0.2, glibc 2.3.5)
      + Mandrake 9.2 kernel 2.4.22-10mdk (gcc 3.3.1, glibc 2.3.2)

  MegaWave2 Vers 2.31 :
    - Linux :
      + Mandrake 10.0 kernel 2.6.3-7mdk (gcc 3.3.2, glibc 2.3.3)
      + Mandrake 9.2 kernel 2.4.22-10mdk (gcc 3.3.1, glibc 2.3.2)
      + Mandrake 9.0 kernel 2.4.19-16mdk (gcc 3.2, glibc 2.2.5)

  MegaWave2 Vers 2.30 :
    - Linux :
      + Mandrake 9.2 kernel 2.4.22-10mdk (gcc 3.3.1, glibc 2.3.2)
      + Mandrake 9.0 kernel 2.4.19-16mdk (gcc 3.2, glibc 2.2.5)
    - SunOS 5.7 (with optional SPROcc package)

  MegaWave2 Vers 2.20 :
    - Linux :
      + Mandrake 9.0 kernel 2.4.19-16mdk (gcc 3.2, glibc 2.2.5)
      + Mandrake 8.1 kernel 2.4.8-26mdk (gcc 2.96, glibc 2.2.4)
    - SunOS 5.7 (with optional SPROcc package)

  MegaWave2 Vers 2.10 :
 
    - Linux :
      + Mandrake 8.1 kernel 2.4.8-26mdk (gcc 2.96, glibc 2.2.4)
      + RedHat 6.2 kernel 2.2.19ext3 (gcc 2.91, glibc 2.1.3)
      + RedHat 5.2 kernel 2.0.36  (gcc 2.7.2.3, glibc 2.0.7) 
    - HP-UX B.10.20 (with optional HP-UX C compiler)
    - SunOS 5.7 (with optional SPROcc package)

  MegaWave2 Vers 2.00 :

    - Linux RedHat 5.2, Mandrake 6.0
    - HP-UX B.10.20 (with optional HP-UX C compiler)
    - SunOS 5.6, SunOS 5.7 (with optional Solaris C compiler)

6) BUGS AND COMMENTS

  Remember that there is no warranty on MegaWave2 : this is a research software.
If you have bugs, comments or anything else to report, feel free to send an e-mail to 
megawave@cmla.ens-cachan.fr or, better, use the Forum available from the MegaWave
web page http://www.cmla.ens-cachan.fr/Cmla/Megawave.
