sphinx/proj_matlab.rst

   1 .. -*- mode: rst; fill-column: 78 -*-
   2 .. ex: set sts=4 ts=4 sw=4 et tw=79:
   3
   4 .. _project_matlab:
   5
   6 *********************************
   7 Integrating Matlab-based software
   8 *********************************
   9
  10 There is a vast amount of Matlab-based software for neuro-imaging and
  11 psychological research. For various reasons, such software has not been
  12 considered for integration into Debian in the past. However, recent advances of
  13 the Octave_ project allow running a significant number of Matlab tools without
  14 the proprietary environment.
  15
  16 To ease the transition to a completely open-source research environment, we are
  17 following a two-fold approach. On one hand we start packaging all relevant
  18 Octave-compatible software for Debian. On the other hand we work on a proper
  19 integration of (still) Matlab-only software.
  20
  21 The latter shall be achieved by providing a support Debian package that can
  22 represent local Matlab installations to the Debian package management system.
  23 Moreover, this package provides helper tools that ease building MEX extensions
  24 from source during package installation with a local Matlab and therefor allow
  25 for inclusion of such packages into Debian 'contrib' suite (given an appropriate
  26 licence).
  27
  28 The goal is to provide researchers with fully functional Matlab software, that
  29 can be used with Matlab on Debian systems, while benefiting from all advantages
  30 of Debian integration. However, at the same time researchers should have the
  31 possibility to seamlessly switch to Octave_ whenever possible or necessary (e.g.
  32 a laptop being out of reach of a university's license server), and eventually
  33 completely migrate to Octave when full compatibility for a particular software
  34 is achieved.
  35
  36 This effort includes talking to upstream projects about the possibility to run
  37 with Octave, as well as developing patches to achieve such compatibility.
  38
  39 .. _Octave: http://www.gnu.org/software/octave
  40
  41 Status
  42 ------
  43
  44 A :ref:`Matlab-support package <pkg_matlab-support>` is available starting from
  45 Debian 7.0 (wheezy) and Ubunty 11.10 (oneiric). Backports for older releases can
  46 be obtained from NeuroDebian.
  47
  48 Packaging of individual Matlab-based software has started. An
  49 :ref:`SPM <pkg_matlab-spm8>` package is ready, and a preliminary package of
  50 :ref:`EEGLAB <pkg_matlab-eeglab11>` is available from NeuroDebian.
  51 An upcoming :ref:`Fieldtrip <pkg_fieldtrip>` package is work-in-progress (see
  52 references_ for more packages). Further expansion of the coverage is planned.
  53
  54 .. todo:: Integrating Matlab-based software
  55
  56    * Finish packaging of fieldtrip which is necessary to complete the packaging
  57      of SPM.
  58    * Create :ref:`matlab-psychtoolbox-3 <pkg_matlab-psychtoolbox-3>` to
  59      complement :ref:`octave-psychtoolbox-3 <pkg_octave-psychtoolbox-3>`.
  60    * Create :ref:`matlab-biosig <pkg_matlab-biosig>` to
  61      complement :ref:`octave-biosig <pkg_octave-biosig>`.
  62
  63 References
  64 ----------
  65
  66 * `SPM packaging progress <http://bugs.debian.org/592390>`_ report.
  67 * `Fieldtrip packaging progress <http://bugs.debian.org/605492>`_ report.
  68 * `EEGLab packaging progress <http://bugs.debian.org/605739>`_ report.
  69 * `PsychToolbox packaging progress <http://bugs.debian.org/606557>`_ report.
  70