Manual installation of the WFDB Toolbox for MATLAB
_______________________________________________________________________________
Copyright (c) 2009 by Michael Craig, All Rights Reserved
Contact wfdb-matlab-support@physionet.org

   This library (wfdb-swig-matlab) is free software; you can redistribute
   it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   02111-1307  USA

_______________________________________________________________________________

This file describes how to manually install WFDB Toolbox for MATLAB.

To begin, you will need the following files:

  wfdb-swig.jar
  wfdb-swig-matlab-${OS}.jar
  wsm-matlab-code.jar
  wfdb-nativelibs-${OS}-${ARCH}.jar

where ${OS} is one of "linux", "macosx", or "windows" (without quotes) and
${ARCH} is one of "amd64", "i386", "x86", "x86_64", and "ppc" (again without
quotes).  These files can be downloaded from

  http://physionet.org/physiotools/matlab/wfdb-swig-matlab/

or built from source code.

Note that wfdb-nativelibs is not available for all combinations of ${OS}
and ${ARCH}; currently the following combinations are supported:

  linux-amd64
  linux-i386
  macosx-i386
  macosx-ppc
  macosx-x86_64
  windows-amd64
  windows-x86

${ARCH} should match the architecture of the JVM that your MATLAB installation
is using; you can find it by running the following command in MATLAB:

  java.lang.System.getProperty('os.arch')

You will need to create a directory to store wfdb-swig-matlab; call it
${WSMROOT}. Unjar wsm-matlab-code.jar, wfdb-swig.jar, and
wfdb-swig-matlab-${OS}.jar into ${WSMROOT}. Make the subdir.
${WSMROOT}/lib-${ARCH} and unjar wfdb-nativelibs-${OS}-${ARCH}.jar into it.
You can remove any files in ${WSMROOT}/lib-${ARCH} whose names do not end
in -${ARCH}. Now you need to strip the -${ARCH} suffixes from those remaining
files; on a *nix system you can do so as:

  $ for i in *${ARCH}; do mv $i `basename $i "-${ARCH}"`; done

Now you need to update MATLAB-specific files. Call the root directory of your
MATLAB installation ${MATLABROOT}. Files
${MATLABROOT}/toolbox/local/librarypath.txt and
${MATLABROOT}/toolbox/local/classpath.txt should exist; if not, create them
(if ${MATLABROOT}/toolbox/local does not exist, something is probably wrong
with your MATLAB installation!) Add the following line to librarypath.txt:

${WSMROOT}/lib-${ARCH}

(with ${WSMROOT} and ${ARCH} properly substituted, of course.) Add the
following two lines to classpath.txt:

${WSMROOT}/wfdb.jar
${WSMROOT}/wsm-classes.jar

(again with ${WSMROOT} properly substituted.)

Finally, you need to update MATLAB's path, adding both these two directories:

  ${WSMROOT}
  ${WSMROOT}/util

The easiest way to do this is with the command PATHTOOL in MATLAB. You might
also try the following sequence of MATLAB commands:

  addpath('${WSMROOT}');
  addpath('${WSMROOT}/util');
  try
    savepath;
  catch
    path2rc;
  end

(with ${WSMROOT} substituted, as usual.)

That's it! The WFDB Toolbox for MATLAB should be ready to go. If you are still
having problems, consult

    http://physionet.org/physiotools/matlab/wfdb-swig-matlab/

and feel free to use the "contact us" link to ask for help.