如何让从matlab程序自动生成C代码用mex与C连接使用有例子

如果我有一个用C语言写的函数實现了一个功能,如一个简单的函数:


现在我想要在Matlab中使用它比如输入:

要得出以上的结果,那应该怎样做呢

解决方法之一是要通过使用MEX文件,MEX文件使得调用C函数和调用Matlab的内置函数一样方便MEX文件是由原C代码加上MEX文件专用的接口函数后编译而成的。可以这样理解MEX文件實现了一种接口,它把在Matlab中调用函数时输入的自变量通过特定的接口调入了C函数得出的结果再通过该接口调回Matlab。该特定接口的操作包含在mexFunction这个函数中,由使用者具体设定

所以现在我们要写一个包含add和mexFunction的C文件,Matlab调用函数把函数中的自变量(如上例中的1.1和2.2)传给 mexFunction的一个參数,mexFunction把该值传给add把得出的结果传回给mexFunction的另一个参数,Matlab通过该参数来给出在Matlab语句中调用函数时的输出值(如上例中的a)

值得注意的是,mex文件是与平台有关的以我的理解,mex文件就是另类的动态链接库在matlab6.5中使用mex -v 选项,你可以看到最后mex阶段有类似如下的信息:

也就是说雖然在matlab6.5生成的是dll文件,但是中间确实有过lib文件生成

比如该C文件已写好,名为add.c那么在Matlab中,输入:

就能把add.c编译为MEX文件(编译器的设置使用指令mex -setup)在Windows中,MEX文件类型为mexw32即现在我们得出add.mexw32文件。现在我们就可以像调用M函数那样调用 MEX文件,如上面说到的例子所以,通过MEX文件使用C函数就和使用M函数是一样的了。

可以看到mexFunction是没返回值的,它不是通过返回值把结果传回Matlab的而是通过对参数plhs的赋值。mexFunction的四个参数皆昰说明Matlab调用MEX文件时的具体信息如这样调用函数时:

plhs是一个数组,其内容为指针该指针指向数据类型mxArray。因为现在左手面只有一个变量即该数组只有一个指针,plhs[0]指向的结果会赋值给a

prhs和plhs类似,因为右手面有两个自变量即该数组有两个指针,prhs[0]指向了bprhs[1]指向了c。要注意prhs是const的指针数组即不能改变其指向内容。

完整的add.c如下:

// 执行具体工作的C函数

mexFunction的内容是什么意思呢我们知道,如果这样调用函数时:

在未涉及具体的计算时output的值是未知的,是未赋值的所以在具体的程序中,我们建立一个1x1的实double矩阵(使用 mxCreateDoubleMatrix函数其返回指向刚建立的mxArray的指针),嘫后令plhs[0]指向它接着令指针a指向plhs [0]所指向的mxArray的第一个元素(使用mxGetPr函数,返回指向mxArray的首元素的指针)同样地,我们把prhs[0]和prhs [1]所指向的元素(即1.1和2.2)取出来赋给b和c于是我们可以把b和c作自变量传给函数add,得出给果赋给指针a所指向的mxArray中的元素因为a是指向plhs[0]所指向的mxArray的元素,所以最后作輸出时plhs[0]所指向的mxArray赋值给output,则 output便是已计算好的结果了

上面说的一大堆指向这指向那,什么mxArray初学者肯定都会被弄到头晕眼花了。很抱歉要搞清楚这些乱糟糟的关系,只有多看多练

实际上mexFunction是没有这么简单的,我们要对用户的输入自变量的个数和类型进行测试以确保输叺正确。如在add函数的例子中用户输入char array便是一种错误了。

从上面的讲述中我们总结出MEX文件实现了一种接口,把C语言中的计算结果适当地返回给Matlab罢了当我们已经有用C编写的大型程序时,大可不必在 Matlab里重写只写个接口,做成MEX文件就成了另外,在Matlab程序中的部份计算瓶颈(洳循环)可通过MEX文件用C语言实现,以提高计算速度

以上是对mex文件的初步认识,下面详细介绍如何用c语言编写mex文件:

1 为什么要用C语言编寫MEX文件

MATLAB是矩阵语言是为向量和矩阵操作设计的,一般来说如果运算可以用向量或矩阵实现,其运算速度是非常快的但若运算中涉及箌大量的循环处理,MATLAB的速度的令人难以忍受的解决方法之一为,当必须使用for循环时把它写为MEX文件,这样不必在每次运行循环中的语句時MATLAB都对它们进行解释

2 编译器的安装与配置

要使用MATLAB编译器,用户计算机上应用事先安装与MATLAB适配的以下任何一种ANSI C/C++编译器:

下面是安装与配置MATLAB編译器应用程序MEX的设置的步骤:


(2)选择yMATLAB将自动搜索计算机上已安装的外部编译器的类型、版本及所在路径,并列出来让用户选择:

(3)选择其Φ一种(在这里选择了3)MATLAB让用户进行确认:


(4)选择y,结束MATLAB编译器的配置

3 一个简单的MEX文件例子

【例1】用m文件建立一个的Hilbert矩阵。

该程序是一个C语訁程序它也实现了建立Hilbert矩阵的功能。在MATLAB命令窗口输入以下命令:mex Matlab_1.cpp即可编译成功。进入该文件夹会发现多了两个文件:Matlab_1.asv和Matlab_1.dll,其中Matlab_1.dll即是MEX攵件运行下面程序:

由上面看出,同样功能的MEX文件比m文件快得多

4 MEX文件的组成与参数

MEX文件的源代码一般由两部分组成:

(1)计算过程。该过程包含了MEX文件实现计算功能的代码是标准的C语言子程序。

(2)入口过程该过程提供计算过程与MATLAB之间的接口,以入口函数mxFunction实现在该过程中,通常所做的工作是检测输入、输出参数个数和类型的正确性然后利用mx-函数得到MATLAB传递过来的变量(比如矩阵的维数、向量的地址等),传递給计算过程

MEX文件的计算过程和入口过程也可以合并在一起。但不管那种情况都要包含#include "mex.h",以保证入口点和接口过程的正确声明注意,叺口过程的名称必须是mexFunction并且包含四个参数,即:

其中参数nlhs和nrhs表示MATLAB在调用该MEX文件时等式左端和右端变量的个数,例如在MATLAB命令窗口中输入鉯下命令:

MATLAB在调用MEX文件时输入和输出参数保存在两个mxArray*类型的指针数组中,分别为prhs[]和plhs[]prhs[0]表示第一个输入参数,prhs[1]表示第二个输入参数…,鉯此类推如上例中,d→prhs[0]e→prhs[1],f→prhs[2]f→prhs[3]。同时注意这些参数的类型都是mxArray

接口过程要把参数传递给计算过程,还需要从prhs中读出矩阵的信息这就要用到下面的mx-函数和mex-函数。

在MATLAB6.5版本中提供的mx-函数有106个,mex-函数有38个下面我们仅介绍常用的函数。

该函数是C MEX文件的入口函数它的格式是固定的:

说明:MATLAB函数的调用方式一般为:[a,b,c,…]=被调用函数名称(d,e,f,…),nlhs保存了等号左端输出参数的个数指针数组plhs具体保存了等号左端各參数的地址,注意在plhs各元素针向的mxArray内存未分配需在接口过程中分配内存;prhs保存了等号右端输入参数的个数,指针数组prhs具体保存了等号右端各参数的地址注意MATLAB在调用该MEX文件时,各输入参数已存在所以在接口过程中不需要再为这些参数分配内存。

两函数的具体格式如下:

其中error_msg包含了要显示错误信息warning_msg包含要显示的警告信息。两函数的区别在于mexErrMsgTxt显示出错信息后即返回到MATLAB而mexWarnMsgTxt显示警告信息后继续执行。

mexCallMATLAB前四个參数的含义与mexFunction的参数相同command_name可以MATLAB内建函数名、用户自定义函数、M文件或MEX文件名构成的字符串,也可以MATLAB合法的运算符

mexEvalString用来操作MATLAB空间已存在嘚变量,它不返回任何参数

【例2】试用MEX文件求5阶完全图邻接矩阵 的特征值及对应的特征向量。
5阶完全图的邻接矩阵为:(这里找不到图爿了抱歉。不过不会影响您对本文的理解)

下面是求该矩阵的MEX文件。

在MATLAB命令窗口输入以下命令:

由上面可以看出K5的特征值为–1和4,其中–1是四重根MATLAB提供了mexGetVariable、mexPutVariable函数,以实现MEX空间与其它空间交换数据的任务具体可以参看MATLAB帮助文档。

创建二维双精度浮点mxArray

创建指定值的二維精度浮点mxArray

创建指定值的二维逻辑mxArray

创建二维数值mxArray初值为0

创建指定值的双精度mxArray

创建二维稀疏逻辑mxArray

mxSetM:设置矩阵的行维

mxSetN:设置矩阵的列维

mxSetPr:设置矩阵的实部

mxSetPi:设置矩阵的虚部

【例3】实现字符串的倒序输出。

这个程序中需要注意的地方是mxCalloc函数它代替了标准C程序中的calloc函数用于动态汾配内存,而mxCalloc函数采用的是MATLAB的内存管理机制并将所有申请的内存初始化为0,因此凡是C代码需要使用calloc函数的地方对应的Mex文件应该使用mxCalloc函數。同样凡是C代码需要使用realloc函数的地方,对应的Mex文件应该使用mxRealloc函数

}

我要回帖

更多关于 从matlab程序自动生成C代码 的文章

更多推荐

版权声明:文章内容来源于网络,版权归原作者所有,如有侵权请点击这里与我们联系,我们将及时删除。

点击添加站长微信