|config||2016-05-25||tbeu||[d59ed9] Add support for HDF5 v1.10|
|documentation||2016-06-30||tbeu||[f39fc4] Fix short description of Mat_GetVersion|
|getopt||2016-01-28||tbeu||[07728a] Fix C++ compilation|
|patches||2006-07-29||Christopher Hulbert||[f08ac6] Import matio.|
|share||2006-07-29||Christopher Hulbert||[f08ac6] Import matio.|
|src||2016-06-30||tbeu||[8e434f] Update order of field initialization|
|test||2016-04-29||tbeu||[f088bd] Cosmetics in test description|
|tools||2016-04-06||tbeu||[f56d69] Read field data in read_selected_data|
|visual_studio||2016-06-30||tbeu||[85dfee] Bump version and NEWS for v1.5.8|
|.gitignore||2014-08-07||Herbert Gsenger||[fa45de] Add Visual Studio specific files to list of ign...|
|.gitmodules||2013-07-10||Christopher Hulbert||[dab377] Update submodule for test datasets|
|.travis.yml||2016-06-02||tbeu||[9841d6] Update HDF5 to v1.8.17 for Travis CI|
|COPYING||2016-01-10||tbeu||[bcdefe] Bump year 2016 for v1.5.3|
|Makefile.am||2016-02-02||tbeu||[54114e] Add MSVC specific resource file to distribution|
|NEWS||2016-06-30||tbeu||[85dfee] Bump version and NEWS for v1.5.8|
|README.md||2016-06-21||tbeu||[c5e96f] Fix format of section 2.1.2 HDF5|
|autogen.sh||2016-01-13||Greg Sjaardema||[53d38e] Let autogen.sh work on Darwin and Linux|
|configure.ac||2016-06-30||tbeu||[85dfee] Bump version and NEWS for v1.5.8|
|coverity_model.c||2016-02-01||tbeu||[8109b1] Add license header to coverity_model.c|
|matio.pc.in||2009-10-13||Christopher Hulbert||[ca35d9] Merge branch 'matio_1_5_0_branch'|
MATLAB MAT file I/O library
Matio is an open-source C library for reading and writing MATLAB MAT files.
This library is designed for use by programs/libraries that do not have access or do not want to rely on MATLAB's shared libraries.
You can contact Christopher Hulbert through email at firstname.lastname@example.org and Thomas Beutlich through email at email@example.com.
The following people/organizations have helped in the development of matio through patches, bug reports, and/or testing:
If you are interested in collaborations, contact us via email (see Section 1.1).
Questions can be asked using the forums on the sourceforge site hosting matio (http://sourceforge.net/projects/matio/forums).
Bugs, enhancements, etc. should be submitted using one of the trackers on the sourceforge page (http://sourceforge.net/p/matio/_list/tickets).
Matio has two optional dependencies. These are not required for the software to work, but without them some files may be unreadable. Zlib is required to read/write level 5 MAT files that use compression. HDF5 is required to work with newer MAT files that use the HDF5-format files.
To support compressed MAT files, zlib 1.2.3 or greater is required. The zlib software can be downloaded from http://zlib.net/.
Support for MAT file version 7.3 requires the HDF5 library. This library can be downloaded from https://www.hdfgroup.org/. Matio requires HDF5 version ≥ 1.8.x. Neither deprecated HDF5 1.6.x API functions nor HDF5 higher-level functions are called.
--with-default-api-version=v110) and enabled legacy API functions (i.e.
--enable-deprecated-symbols=yes) or configuration of HDF5 with deprecated API version 1.8 (i.e.
For Windows, the pre-compiled binaries can be used which also include a DLL of zlib to satisfy the zlib dependency.
The primary method for building the software is using
configure followed by
make. After building, the testsuite can be executed to test the software using
make check. The software can be installed using
make install. For example,
$ tar zxf matio-X.Y.Z.tar.gz $ cd matio-X.Y.Z $ ./configure $ make $ make check $ make install
If any of the tests in the testsuite fail, you should report the failure using the tracker (see Section 1.4). You should attach the generated testsuite.log file to the bug report.
The configure script used to build the software takes a number of options. This section describes the key options.
Visual Studio solutions are provided as matio_vs2008.sln for VS2008 and as matio.sln for VS2010 (and newer). The solutions are set up to build a DLL of the matio library (libmatio.dll) and matdump tool and assume HDF5 is available in the directory specified by the HDF5_DIR environment variable. It is assumed that the shared libraries of HDF5 (and zlib) are available. If the static libraries of HDF5 (and zlib) are installed/built the macro
H5_BUILT_AS_STATIC_LIB needs to be defined (instead of
A testsuite is available when building with the GNU autotools. To run the testsuite, first configure and build matio. After building run
make check to run the testsuite. If matio was built without zlib, the compressed variable tests will be skipped. If built without HDF5, the tests for version 7.3 MAT files will be skipped. If the path to the MATLAB application was not specified (
--with-matlab), the write tests will fail if matio cannot read the file and skip if matio can read the file. The write tests will pass if MATLAB is available and can also read the file.
To report matio testsuite failures, compress the testsuite.log file in the test sub-directory of the build directory. Upload the compressed log file along with a bug report (see Section 1.4 for information on reporting bugs).
The library has been tested/used on Linux, Windows, OS X, and AIX including both little-endian and big-endian architecture.
This software is provided under a Simplified BSD license. See the COPYING file for details on the license.
MATLAB is a registered trademark of The MathWorks, Inc.