Click here to Skip to main content
Click here to Skip to main content

Exporting/Importing Data To/From MATLAB

, 20 Jan 2004
Rate this:
Please Sign up or sign in to vote.
Exporting/Importing Variables Data To/From MATLAB Using C MAT-File API
<!-- Add the rest of your HTML here -->

Introduction

Sometimes it is required that you export calculated data from one environment to another. The same thing occurred when you are working with C/C++ and also MATLAB environment. In this case, some tools must already exist to act as a bridge for both environments. MATLAB C MAT-File APIs are a group of functions for reading/writing a MAT compatible file from C/C++ environments that can be read by MATLAB. This means that if you save your variables data (result of some calculation) from MATLAB, you can read them from a C program and continue your calculation and if you compute something in your program and want to save them in a file that MATLAB can read them without any problem, you can use these APIs.

C MAT-File APIs

MATLAB C MAT-File APIs are those functions for opening a file and saving data in a compatible format for using them in MATLAB. The first step to use these functions is including mat.h header file. Notice that if you want to use MATLAB built-in functions, you must include matlab.h header file too. The second step is adding MATLAB libraries to your project. The required library is libmat.lib. If you use another MATLAB APIs, add their libraries too. For example, if you use mlfPrintMatrix function to print matrix elements, you must add libmx.lib, libmatlb.lib and libmmfile.lib.

Below are some of basic C MAT-File APIs with their description and syntax:

MATFile *matOpen(const char *filename, const char *mode);

Arguments: filename is name of file to open, mfp is a pointer to MAT-file information and mode is file opening mode.

Legal values for mode listed in Table 1:

r Opens file for reading only; determines the current version of the MAT-file by inspecting the files and preserves the current version.
u Opens file for update, both reading and writing, but does not create the file if the file does not exist (equivalent to the r+ mode of fopen); determines the current version of the MAT-file by inspecting the files and preserves the current version.
w Opens file for writing only; deletes previous contents, if any.
w4 Creates a MATLAB 4 compatible MAT-file.

Description: This function allows you to open MAT-files for reading and writing. matOpen opens the named file and returns a file handle, or NULL if the open fails. You must close the file by using matClose function.

char **matGetDir(MATFile *mfp, int *num);

Arguments: mfp is a pointer to MAT-file information. num is address of the variable to contain the number of mxArray variables in the MAT-file.

Description: This function allows you to get a list of the names of the mxArray variables contained within a MAT-file. matGetDir returns a pointer to an internal array containing pointers to the NULL-terminated names of the mxArrays in the MAT-file pointed to by mfp. The length of the internal array (number of mxArrays in the MAT-file) is placed into num. The internal array is allocated using a single mxCalloc and must be freed using mxFree when you are finished with it. matGetDir returns NULL and sets num to a negative number if it fails. If num is zero, mfp contains no arrays. MATLAB variable names can be up to length mxMAXNAM, where mxMAXNAM is defined in the file matrix.h.

mxArray *matGetVariable(MATFile *mfp, const char *name);
mxArray *matGetNextVariable(MATFile *mfp, const char *name);

Arguments: mfp is a pointer to MAT-file information and name is name of mxArray to get from MAT-file.

Description: matGetVariable allows you to copy an mxArray out of a MAT-file.
matGetVariable reads the named mxArray from the MAT-file pointed to by mfp and returns a pointer to a newly allocated mxArray structure, or NULL if the attempt fails.
matGetNextVariable allows you to step sequentially through a MAT-file and read all the mxArrays in a single pass. The function reads the next mxArray from the MAT-file pointed to by mfp and returns a pointer to a newly allocated mxArray structure. MATLAB returns the name of the mxArray in name.

Use matGetNextVariable immediately after opening the MAT-file with matOpen and not in conjunction with other MAT-file functions. Otherwise, the concept of the next mxArray is undefined.

matGetNextVariable returns NULL when the end-of-file is reached or if there is an error condition.

In both functions, be careful in your code to free the mxArray created by this routine when you are finished with it.

int matPutVariable(MATFile *mfp, const char *name, const mxArray *mp);

Arguments: mfp is a pointer to MAT-file information. name is name of mxArray to put into MAT-file. mp is an mxArray pointer.

Description: This function allows you to put an mxArray into a MAT-file. matPutVariable writes mxArray mp to the MAT-file mfp. If the mxArray does not exist in the MAT-file, it is appended to the end. If an mxArray with the same name already exists in the file, the existing mxArray is replaced with the new mxArray by rewriting the file. The size of the new mxArray can be different than the existing mxArray. matPutVariable returns 0 if successful and nonzero if an error occurs.

Importing Variables Data From MATLAB

For saving variables in MATLAB, just use save command. for example:

save myFile

By entering the above command, MATLAB will save all of variables in its workspace in a file named myFile.mat. For saving only some variable, use save command like:

save myFile X Y Z

with above command, MATLAB saves only X, Y and Z variables. Now we want to use C MAT-File APIs to read myFile.mat and extract all of saved variables. Below is our C code to doing this:

#include <span class="code-string">"stdafx.h"
</span>
#include <span class="code-string">"mat.h"
</span>
#include <span class="code-string">"matlab.h"
</span>

#pragma comment(lib, "libmat.lib")
#pragma comment(lib, "libmx.lib")
#pragma comment(lib, "libmatlb.lib")
#pragma comment(lib, "libmmfile.lib")

void main(int argc, char **argv)
{
    MATFile *pmat;
    const char* name=NULL;
    mxArray *pa;
    
    /* open mat file and read it's content */
    pmat = matOpen("myFile.mat", "r");
    if (pmat == NULL) 
    {
        printf("Error Opening File: \"%s\"\n", argv[1]);
        return;
    }
    
    /* Read in each array. */
    pa = matGetNextVariable(pmat, &name);
    while (pa!=NULL)
    {
        /*
        * Diagnose array pa
        */
        printf("\nArray %s has %d dimensions.", name, 
               mxGetNumberOfDimensions(pa));
        
        //print matrix elements
        mlfPrintMatrix(pa);
        
        //get next variable
        pa = matGetNextVariable(pmat,&name);
                
        //destroy allocated matrix
        mxDestroyArray(pa);
    }
    
    matClose(pmat);
}

Exporting Variables Data To MATLAB

It's time to do reverse task. In other hand we want to calculate something and save data to a file that MATLAB can read it. To import data from a MAT-File to MATLAB environment, one must use load command:

load myFile

Load command, load workspace variables from a file located on your disk. Following source code, define some mxArray varialbe and then save them in a file. This file can be called from MATLAB environment.

#include <span class="code-string">"stdafx.h"
</span>
#include <span class="code-string">"mat.h"
</span>
#include <span class="code-string">"matlab.h"
</span>

#pragma comment(lib, "libmat.lib")
#pragma comment(lib, "libmx.lib")
#pragma comment(lib, "libmatlb.lib")
#pragma comment(lib, "libmmfile.lib")

void main(int argc, char **argv)
{
    MATFile *pmat;
    
    //now create a new mat-file and save some variable/matrix in it
    double dbl1[]={1.1, 4.3, -1.6, -4, -2.75};
    double dbl2[]={-4.9, 2.3, -5};
    mxArray *AA, *BB, *CC;

    A=mxCreateDoubleMatrix(1, 5, mxREAL);
    B=mxCreateDoubleMatrix(1, 3, mxREAL);

    //copy an array to matrix A and B
    memcpy(mxGetPr(A), dbl1, 5 * sizeof(double));
    memcpy(mxGetPr(B), dbl2, 3 * sizeof(double));

    C=mlfConv(A, B);        //convolution
    
    //opening TestVar.mat for writing new data
    pmat=matOpen("TestVar.mat", "w");
    matPutVariable(pmat, "A", A);
    matPutVariable(pmat, "B", B);
    matPutVariable(pmat, "C", C);
    matClose(pmat);
    
    mxDestroyArray(AA);
    mxDestroyArray(BB);
    mxDestroyArray(CC);
}

Enjoy!

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

A. Riazi
CEO Misbah3Com
Iran (Islamic Republic Of) Iran (Islamic Republic Of)
I was born in Shiraz, a very beautiful famous city in Iran. I started programming when I was 12 years old with GWBASIC. Since now, I worked with various programming languages from Basic, Foxpro, C/C++, Visual Basic, Pascal to MATLAB and now Visual C++.
I graduated from Iran University of Science & Technology in Communication Eng., and now work as a system programmer for a telecommunication industry.
I wrote several programs and drivers for Synthesizers, Power Amplifiers, GPIB, GPS devices, Radio cards, Data Acqusition cards and so many related devices.
I'm author of several books like Learning C (primary and advanced), Learning Visual Basic, API application for VB, Teach Yourself Object Oriented Programming (OOP) and etc.
I'm winner of January, May, August 2003 and April 2005 best article of month competetion, my articles are:

You can see list of my articles, by clicking here


Comments and Discussions

 
GeneralMy vote of 5 Pinmembermanoj kumar choubey26-Feb-12 20:52 
Generalreal-time analysis Pinmembersudhakardevaraya8-Feb-09 7:16 
GeneralMatlab.h is not included in the extern-&gt;include PinmemberjunYoungSon19-Jan-09 21:04 
Questionsalam doosteman PinmemberRF_HAKIMI20-Nov-08 10:50 
QuestionHow to send a matlab stucture from one PC to another PC? Pinmembernarayana_12345615-Jul-07 23:14 
Questionlibmatlb.lib Pinmembercukycuks20-Apr-07 7:53 
GeneralC++ reading mat-file PinmemberWambecq15-Apr-07 23:00 
QuestionHow does one do this in C#? PinmemberGarth W10-Feb-07 0:53 
Generalhamvatane shirazi alie Pinmemberhooshang Karami10-Dec-06 0:39 
GeneralBug in reader Pinmemberrvangaal4-Dec-06 3:51 
GeneralRealtime writing of vars Pinmemberrvangaal23-Nov-06 4:59 
GeneralRe: Realtime writing of vars Pinmemberrvangaal1-Dec-06 6:13 
Questionmat file creating Pinmemberemresel9-Sep-06 8:42 
General#include "matlab.h" Pinmembersugi49521-Feb-06 0:29 
General: #include "matlab.h" Pinmemberabhinavp198614-Feb-10 23:36 
GeneralRe: : #include "matlab.h" PinmemberMember 858127419-Sep-13 19:08 
Generalquestion PinmemberGabriyel10-Jan-06 21:46 
GeneralRe: question PinmemberA. Riazi10-Jan-06 22:30 
GeneralGood example above PinmemberTAN THIAM HUAT22-Nov-05 20:11 
GeneralEXE from m.file PinmemberRafid97420-Nov-05 2:34 
GeneralRe: EXE from m.file Pinmemberjsnpg28-Oct-08 17:31 
QuestionHow can I create a mat-file in linux? PinmemberTa Xuan Hung29-Sep-05 21:05 
GeneralUndeclared identifier Pinmemberhailconan18-Sep-05 19:36 
GeneralRe: Undeclared identifier Pinmemberrvangaal1-Dec-06 4:16 
Generalinclude DLLs in commercial software PinmemberTriac28-Feb-05 3:22 
Hi,
I'd like to know if it is possible to include Mathworks' DLLs (libeng.dll, libmat.dll, ...) in a commercial product and distribute them with it. Should I pay for some license?
 
Thanks
QuestionWhy &quot;Entry Point Not Found&quot;? PinsussBenjamin shi22-Feb-05 5:49 
AnswerRe: Why &quot;Entry Point Not Found&quot;? Pinmemberprat7825-Jan-06 9:25 
Generali need libmatlb.dll Pinmemberjulis16-Feb-05 8:30 
GeneralRe: i need libmatlb.dll PinmemberA. Riazi16-Feb-05 21:48 
GeneralRe: i need libmatlb.dll Pinmemberjulis21-Feb-05 8:05 
GeneralRe: i need libmatlb.dll PinsussBenjamin shi22-Feb-05 5:55 
GeneralLinking problem and.... Pinmemberciline12-Feb-05 6:12 
GeneralRe: Linking problem and.... PinmemberA. Riazi14-Feb-05 2:29 
Questionlibmat.lib without Matlab installed? Pinsussmarcimatz24-Jan-05 15:20 
AnswerRe: libmat.lib without Matlab installed? PinmemberA. Riazi25-Jan-05 0:28 
GeneralRe: libmat.lib without Matlab installed? Pinsussmarcimatz25-Jan-05 0:31 
AnswerRe: libmat.lib without Matlab installed? Pinmemberrvangaal4-Dec-06 7:48 
Questionwhere is libmmfile.lib? Pinmembermsh_9714-Oct-04 23:26 
AnswerRe: where is libmmfile.lib? PinmemberA. Riazi15-Oct-04 0:09 
GeneralRe: where is libmmfile.lib? Pinmembermsh_9718-Oct-04 9:54 
GeneralRe: where is libmmfile.lib? PinmemberA. Riazi18-Oct-04 10:09 
Generalproperties PinmemberDanilo Godo13-Oct-04 11:54 
GeneralRe: properties PinmemberA. Riazi13-Oct-04 12:27 
GeneralRe: properties PinmemberDanilo Godo14-Oct-04 7:59 
GeneralRe: properties PinmemberA. Riazi14-Oct-04 11:23 
Questionhow can i extract data from a .txt file? Pinmemberfabryce_pj00716-Jul-04 5:51 
AnswerRe: how can i extract data from a .txt file? PinmemberA. Riazi16-Jul-04 21:01 
Questionhow can i implement Quick sort in MAt Lab Pinmemberchaudhry saud14-Jul-04 21:00 
AnswerRe: how can i implement Quick sort in MAt Lab PinmemberA. Riazi14-Jul-04 21:11 
GeneralRe: how can i implement Quick sort in MAt Lab Pinmemberchaudhry saud14-Jul-04 23:19 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.141223.1 | Last Updated 21 Jan 2004
Article Copyright 2004 by A. Riazi
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid