.. highlightlang:: us

.. index:: matlab_load

.. _matlab_load:

matlab_load
===========

.. us.tag  matlab_load NOTREADYGERMAN matlab New5100 Changed5102 Changed5503

:ref:`matlab_load` lädt MATLAB-Dateien (mat-Dateien) in ein UniScript-Objekt.

.. function::  obj = matlab_load(ssFileName)

.. us.return

**Returnwert**

*obj* ist ein UniScript-Object. Falls ein Fehler aufgetreten ist, wird ein
Error-Object (siehe :ref:`error_create`) zurück gegeben.

.. us.params

**Parameter**

.. uparam:: ssFileName

   *ssFileName* ist der Name der MATLAB-Datei. Die Dateien haben gewöhnlich die 
   Dateinamenerweiterung :file:`.mat`.

.. us.example

**Beispiel**

.. include:: ../include/test_matlab_load.ic

.. us.comment

**Kommentar**

Falls in der MATLAB-Datei Sparse-Matrizen vorhanden sind, können sie mit folgender 
Funktion in Matrizen umgewandelt werden:

::

   def FullMatrix(mSparse)
   {
       dims = mSparse.dims;
       ir = mSparse.ir;
       jc = mSparse.jc;
       p = mSparse.p;
       m = zeros(dims); 
       for (i in 1:len(p)) {
           m[ir[i]; jc[i]] = p[i];
       }
       return m;
   }

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2013.3
     - Unterstützung von mxINT64_CLASS, mxUINT64_CLASS und mxFUNCTION_CLASS.
   * - 5.10.2
     - Es können nun auch MAT-4-Dateien und Dateien mit big-endian byte order
       gelesen werden.
   * - 5.10.0
     - Neu.

.. seealso::
   :ref:`uberblick-matlab-dateien`,
   :ref:`matlab_save`,
   :ref:`import-of-matlab-data-files`

:sub:`id-1988090`