Home

As the name suggest, matOut consists a set of functions created to write Matlab's .mat files.
Basically I had some code which relied heavily on Matlab's API for file output, and I needed to eliminate this code's dependency on Matlab without having to re-engineer large parts of my code.
There is at least one open-source library for writing Matlab files: matio. Unfortunately, using matio is very different from using the Matlab API, so i decided to write a drop-in replacement for the file output API.
This set of functions is used on a day-to-day basis as part of a research model for underwater acoustics/communications developed at SiPLAB, Universidade do Algarve, Portugal and which is maintaned by me.

Features

I've only implemented the functionality I need, so the following is currently supported:

• writing strings (arrays of chars);
• writing arrays of doubles;
• writing arrays of complex doubles;
• writing structures;
• writing arrays of structures;
• structure nesting;
• appending data to previously created .mat files;

Implemented Functions

All implemented functions have the same name and accept the same parameters as their equivalent in the Matlab API.
Functions currently implemented:

• matOpen()
• matClose()
• mxCreateString()
• mxCreateDoubleMatrix()
• mxCreateStructMatrix()
• mxSetFieldByNumber()
• mxGetImagData()
• mxGetPr()
• mxGetData()
• mxGetPi()
• mxCalcSingleSubscript()
• matPutVariable()
• mxDestroyArray()

Notes:

• Matlab V6 files are written.
• Currently, only two-dimensional arrays are supported.
• Writing of "compressed" arrays is not implemented (this feature only benefits arrays made up entirely of integers anyway).
• A special method for saving short array names has not been implemented (neglected as this only saves 4 bytes).
• MatOut is written in C99. I consider this to be a feature, not a limitation.
• The Matfile format documentation can be found at: http://www.mathworks.com/access/helpdesk/help/pdf_doc/matlab/matfile_format.pdf