Matlab Migration Package 0.9 alpha

---Known Problems---

This program has been tested with Matlab 5.1.  It will not work with
earlier versions of Matlab.

This program was designed to be used with Mathematica 3.0.x.x.  New
versions will be provided with later versions of Mathematica.

---Installation---

When unzipped, the archive should have a folder called Matlab.  This
folder
and its contents should be placed in the Mathematica installation
directory under Addons/Applications.  The structure should appear as 
follows:

Mathematica-->Addons -> Applications -> Matlab ---> Binaries
Installation                                    |-> Documentation
Directory                                       |-> Source
                                                |-> Examples

Normally, the Mathematica installation directory will be:

Under Windows:

  C:\Program Files\Wolfram Research\Mathematica\3.0\
  
Under Mac:

  Mathematica 3.0 Files
  
Under UNIX 

  /usr/local/mathematica/

The source is currently built only for Windows, but you are free to 
build it for other systems.  However, the Engine part of the package
will not work on Macintosh.  It is not supported by Mathworks on that
platform.

When the directory is placed in Addons/Applications, you can start
Mathematica and rebuild the Help Index (by selecting Rebuild Help 
Index from the Help menu).  This will make all of the online
documentation available through the Help Browser.  You can find it
by selecting Help from the Help Menu, then switching to the Addons
section.  You should read all of the sections and attempt to perform
all of the calculations.

---Contents of the Directories---

Binaries 

  Contains a MathLink program which can be Installed[] into the 
Mathematica kernel.  This is accomplished by the Matlab Package.

Documentation 

  Contains information about using these packages.  If you rebuild the
Help Index, these notebooks will appear in Addons|Matlab Migration.

Source 

  Contains the source code for the binary MathLink applications.

Examples 

  Includes files necessary to run the examples in the documentation.

---Finding the Executables---

One significant problem is that Mathematica does not know where to
find executables during Installation.  You will need to explicitly 
state where you have put the package before it will work.  The 
package code contains a variable called MatlabExecutable, it 
refers to the link that is used by the program.  You will need to
change the value from $TopDirectory if you use a directory different
from the one assumed by the package.

---Matlab files---

In order to get the package to work correctly, you will need to do
one of two things:

1.  Put the Matlab bin directory on your path in the autoexec.bat
    (or whatever is appropriate for you system).
    
2.  Put the following files in the Binary subdirectory of the Matlab
    Package.
    
    libeng.dll
    libmat.dll
    libmx.dll
    libut.dll
    
    These can be found in the Matlab bin directory.