MATLAB编程与应用系列-第16章 外部接口技术(3)

本章教程共分为7篇进行阐述:
MATLAB编程与应用系列-第16章 外部接口技术(1)
MATLAB编程与应用系列-第16章 外部接口技术(2)
MATLAB编程与应用系列-第16章 外部接口技术(3)
MATLAB编程与应用系列-第16章 外部接口技术(4)
MATLAB编程与应用系列-第16章 外部接口技术(5)
MATLAB编程与应用系列-第16章 外部接口技术(6)
MATLAB编程与应用系列-第16章 外部接口技术(7)

本系列教程来源于出版书籍《基于MATLAB编程基础与典型应用书籍》,如涉及版权问题,请联系:156204968@qq.com。 出版社:人民邮电出版社, 页数:525。

本系列教程目前基于MATLABR2006a,可能对于更高级版本的功能和函数有差异,教程中如有问题,请联系:156204968@qq.com

16.3 MAT文件应用

MAT文件是MATLAB开发环境存储数据的一种特殊的数据格式,使用MAT数据文件可以在不同的开发平台下进行数据交换和通信,可以在独立MATLAB应用程序中导出和读入数据文件。MATLAB应用程序接口(API)函数库提供了使用C,C++和FORTRAN等语言编写的MAT函数库,通过调用MAT函数库,MEX函数库以及MX函数库相关函数,可以非常轻松地编写MEX文件读入和导出MAT格式的数据文件。

�###16.3.1 MATLAB数据导入导出方式
在MATLAB开发环境下,可以通过多种不同的手段向MATLAB开发环境中导入数据或者从MATLAB开发环境中向其他开发平台导出数据。

1. 向MATLAB开发环境中导入数据

可以通过以下不同的方式向MATLAB开发环境中导入数据,但是对于不同的情况,比如数据规模的大小,开发平台的外部需求等,读者可以选择其中最方便的某一种导入数据方式:

  • 使用命令行导入数据
    这种方法适合与当导入的数据规模比较小,那么可以直接在MATLAB命令行窗口中导入数据。例如:
>> a = rand(3)
a =

    0.9501    0.4860    0.4565
    0.2311    0.8913    0.0185
    0.6068    0.7621    0.8214
>> assignin('base','T',a)   //在应用程序中将a变量赋值给变量T
  • 创建数据输入的M文件
    很明显,这种数据导入方式仅仅适合与当数据文件还不存在与工作环境下,需要人工输入数据文件时,采用这种方式比较方便。或者从其他环境比如TEXT文件,EXCEL文件中导入数据文件。

  • 使用load命令导入数据文件
    同save命令相对,当数据变量存在与MATLAB工作环境下时,可以使用save命令将数据变量存储为MAT数据文件格式。那么使用load命令就可以直接向Workspace中导入数据文件。

  • 使用MATLAB的I/O函数读取数据文件
    使用MATLAB的I/O函数fopen, fread以及其他的一些I/O读写函数读入其他平台下的数据文件格式。

  • 编写MEX文件读入MAT数据
    通过MATLAB应用程序接口(API)的MEX函数库,MX函数库和MAT函数库,编写MEX文件读入MAT数据文件。在本节的实例演示中将提供一个标准的MEX文件读入MAT数据的程序代码。

2. 从MATLAB环境中导出数据

同向MATLAB环境导入数据相仿,从MATLAB环境中导出数据也有相对应的一些方式可以供读者进行选择参考。

  • 创建DIARY文件
    通过使用MATLAB命令行diary来创建当前工作窗口中输入和输出结果文本,可以通过文本编辑器或者使用MATLAB函数open命令打开diary文件查看当前输入的数据和输出结果。使用diary on和diary off命令来启动和关闭记录。当在命令行窗口中输入diary on命令后,那么从该条命令开始,将在diary文件中进行记录,直到输入diary off命令结束输入输出的记录。
  • 使用save命令存储数据文件
    MATLAB使用save命令存储数据文件,可以使用save file.dat variableName –ascii命令将数据文件以ASCII文件存储威为.dat文件。例如:
>> a = rand(3);
>> save fileName.dat a -ascii
>> load fileName.dat
  5.2515250e-001  8.3811845e-001  3.7948102e-001
  2.0264736e-001  1.9639514e-002  8.3179602e-001
  6.7213747e-001  6.8127716e-001  5.0281288e-001
  • 使用MATLAB的I/O函数写入数据
    使用MATLAB的I/O函数fopen, fwrite等函数可以将MATLAB环境下的数据存储为其他开发平台所需要的数据文件格式。

  • 创建MEX文件写MATLAB环境数据
    同读入数据一样,可以使用MATLAB应用程序接口(API)函数库MAT函数库,MEX函数库和MX函数库写出MATLAB环境数据。在本节中也提供了一个标准的创建MEX文件写数据的程序代码。

16.3.2 MAT函数库函数

使用MATLAB命令行save命令可以将MATLAB工作环境中的数据存储为MAT数据文件格式。在其他开发平台,需要使用MATLAB应用程序接口来读入和写出MAT数据文件中的数据变量。在MEX一节中,已经介绍了MATLAB应用程序接口(API)函数库的MEX函数库和MX函数库相关函数,在读写MAT文件时,同样需要使用到MEX函数库和MX函数库。本节中主要简单介绍MAT函数库相关函数的功能描述,在下一小节中,将通过实例演示如何使用MATLAB应用程序接口(API)进行MAT文件的读写。

表16.4所示为C语言常用MAT函数库函数

MAT函数功能描述
matOpen打开MAT文件
matClose关闭MAT文件
matGetDir从MAT文件中获取变量列表
matGetVariable从MAT文件中读入变量
matPutVariable向MAT文件中写入变量
matGetNextVariable从MAT文件中读入下一个变量
matDeleteVariable从MAT文件中删除变量

16.3.3 Mex文件读写MAT文件

在了解MAT文件基本概念和MATLAB应用程序接口(API)函数库常用MAT函数库函数后。在本小节,将通过两个实例matCDemo.c文件和matMexLoadDemo分别演示使用MATLAB应用程序接口(API)函数库函数读写MAT文件。编写以下matCDemo.c文件,可以实现写入MATLAB数据到MAT文件中的功能。

/*  
 *  matCDemo.c
*/
#include "mex.h"
#include "mat.h"

void mexFunction(int nlhs, mxArray *plhs[],
                                int nrhs, const mxArray *prhs[])
{
    //初始变量定义,包括数组和mxArray数据结构定义
    mxArray *pString, *pArray1, *pArray2;
    double a1[] = {0.0,1.0,2.0,3.0,4.0,5.0,6.0,7.0,8.0};
    double a2[] = {9.0, 4.0,5.4,6.4,3.2,1.5};
    //MATFile文件定义和文件名定义
    char *filename;
    MATFile *file;
    int flag, buflen;
    
    //输入个数检测数据
    if (nrhs != 1)
        mexErrMsgTxt("Error: One intput parameter is required to represent the file name!");
    if (nrhs > 1)
        mexErrMsgTxt("Error: No more than one input parameter.");
    
    //输入参数类型检测,输入必须为字符串类型。
    if ( mxIsChar(prhs[0]) != 1)
        mexErrMsgTxt("Error: Input must be string!");
    if ( mxGetM(prhs[0]) != 1)
        mexErrMsgTxt("Error: Input must be a row vector!");
    //创建字符串和错误检测
    pString = mxCreateString("This is the MAT demo in C lanuage! Enojy it~!");
    if (pString == NULL)
        mexErrMsgTxt("Error: Cannot create string!");
    //创建mxArray参数矩阵初始大小
    pArray1 = mxCreateDoubleMatrix(3,3,mxREAL);
    pArray2 = mxCreateDoubleMatrix(2,3,mxREAL);
    if( (pArray1 == NULL)||(pArray2 ==NULL) )
        mexErrMsgTxt("Error: Cannot create the double matrix!");
    //将定义的数组拷贝给mxArray变量
    memcpy( (void *)(mxGetPr(pArray1)), (void *)a1, sizeof(a1));
    memcpy( (void *)(mxGetPr(pArray2)), (void *)a2, sizeof(a2));
    
    //获取文件名称
    buflen = (mxGetM(prhs[0]) * mxGetN(prhs[0])) + 1;
    //申请建立字符串大小的内存空间
    filename = mxCalloc(buflen,sizeof(char));
    flag = mxGetString(prhs[0], filename, buflen);
    if( flag != 0)
        mexWarnMsgTxt("Not enough memory space!");
    
    //创建新的MAT文件
    file = matOpen(filename,"w");
    if ( file = NULL )
        mexWarnMsgTxt("Error: Cannot create the mat file!");

    //向MAT文件中写入数据
    matPutVariable(file, "variableString", pString);
    matPutVariable(file, "variableDoubleMatrix1", pArray1);
    matPutVariable(file, "variableDoubleMatrix2", pArray2);
    
    //关闭MAT文件
    matClose(file);
    
    //释放内存空间
    mxDestroyArray(pString);
    mxDestroyArray(pArray1);
    mxDestroyArray(pArray2);
    
    mxFree(filename);
    
}

使用mex命令编译该文件,在Matlab命令行窗口中调用该函数:

>> matcDemo('matfile.mat')

通过which命令查看matfile文件是否已经建立:

>> which matfile.mat
C:\Program Files\MATLAB\R2006a\work\matfile.mat
在命令行窗口中使用load命令可以查看matfile.mat数据文件的内容:
>> load matfile.mat
>> whos
  Name                        Size                    Bytes  Class

  variableDoubleMatrix1       3x3                        72  double array
  variableDoubleMatrix2       2x3                        48  double array
  variableString              1x45                       90  char array

Grand total is 60 elements using 210 bytes

在该实例中,演示了使用MEX文件写MAT数据文件,基本的编写程序步骤包括:首先定义mxArray数据结构变量,进行输入输出参数个数和类型的检测,使用mxCreate前缀函数创建mxArray数据结构变量的初始值,将定义的数组拷贝给mxArray变量,然后matOpen函数打开MAT文件,使用matPutVariable函数向MAT文件写入数据,matClose函数关闭MAT文件,释放定义存储mxArray数据变量的内存空间。以下matMexLoadDemo.c程序则实现读入MAT文件数据的功能,编写程序的步骤和写入MAT文件数据刚好相反,程序代码如下:

/*
 *  matMexLoadDemo.c
 */

#include <string.h>
#include "mex.h"
#include "mat.h"
const int MAXSIZE = 100;
void mexFunction(int nlhs, mxArray *plhs[],
                                int nrhs, const mxArray *prhs[])
{
    //MATFile文件定义和相关变量定义
    MATFile *file;
    char *fileName;
    char *variableName[MAXSIZE];
    int counter,buf_len,index;
    mxArray *variableValue = NULL;
    // 给函数文件名分配内存空间并获取文件名
    buf_len = mxGetN(prhs[0]) + 1;
    fileName = (char *) mxCalloc(buf_len, sizeof (char));
    mxGetString(prhs[0], fileName, buf_len);
    //读取MAT文件函数名
    counter = 0;
    for( index = 1; index < nrhs; index ++ )
    {
        int variableLength = mxGetN(prhs[index]) + 1;
        variableName[ counter ] = (char *)mxCalloc(variableLength, sizeof (char));
        mxGetString(prhs[index], variableName[counter],variableLength);
        counter ++;
    }
    // 打开MAT文件
    file = matOpen(fileName, "r");
    if ( file < (MATFile *) 3 )
    {
        mexErrMsgTxt("Error: Cannot open the mat file!");
    }
    //读取MAT文件变量
    if (counter > 0)
    {
        for ( index = 0; index < counter; index ++)
        {
            variableValue = matGetVariable(file, variableName[index]);
            mexPutVariable("Caller",variableName[index], variableValue);
            
            mxFree(variableName[index]);
        }
    }
    else
    {
        const char *var_name;
        while((variableValue=matGetNextVariable(file, &var_name))!=NULL) 
        {
            mexPutVariable("caller", var_name, variableValue);
        }
    }
    //关闭MAT文件
    matClose(file);
    mxFree(fileName);
}

使用mex命令编译matMexLoadDemo.c文件,在MATLAB命令行窗口中输入:

>> mex matMexLoadDemo.c

通过调用matMexLoadDemo编译文件,就可以读入mat数据文件的数据:

>> matMexLoadDemo('matfile.mat')
>> whos
  Name                        Size                    Bytes  Class

  variableDoubleMatrix1       3x3                        72  double array
  variableDoubleMatrix2       2x3                        48  double array
  variableString              1x45                       90  char array

Grand total is 60 elements using 210 bytes

以上通过两个实例分别演示了使用MATLAB应用程序接口(API)函数库函数,编写MEX文件以实现MAT数据文件的写入和读出。16.4节将介绍MATLAB引擎技术实现在其他语言环境下后台调用MATLAB命令的功能,但这种调用方法要求工作环境必须安装MATLAB应用程序,否则无法启动MATLAB引擎。

作者:德特数据
联系方式:156204968@qq.com

    原文作者:德特数据
    原文地址: https://www.jianshu.com/p/f871906580cd
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞