生物数学matlab中mcc和mex等编译命令Word格式.docx
《生物数学matlab中mcc和mex等编译命令Word格式.docx》由会员分享,可在线阅读,更多相关《生物数学matlab中mcc和mex等编译命令Word格式.docx(11页珍藏版)》请在冰豆网上搜索。
mathworks/help/matlab/matlab_external/upgrading-mex-files-to-use-64-bit-api.html。
要选择不同的C编译器,请从以下选项中选择一种命令:
MicrosoftVisualC++2012(C)mex-setup:
'
C:
\ProgramFiles\MATLAB\R2015b\bin\win64\mexopts\msvc2012.xml'
C
MicrosoftWindowsSDK7.1(C)mex-setup:
\ProgramFiles\MATLAB\R2015b\bin\win64\mexopts\winsdk-7.1_c.xml'
要选择不同的语言,请从以下选项中选择一种命令:
mex-setupC++
mex-setupFORTRAN
mbuild-setup
MBUILD配置为使用'
C-clientMBUILD
mex-setupC++-clientMBUILD
mex-setupFORTRAN-clientMBUILD
注释:
API(ApplicationProgrammingInterface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。
mex和mbuild编译的C/C++文件的差别:
使用mbuild命令编译的C/C++源文件中,必须包含main()函数,它能独立于Matlab运行。
而mex命令编译的C/C++源文件中不含main()函数,它是以mexfunction()函数作为入口的,编译后生成的是mex文件,被Matlab调用。
一、mcc命令
配置MATLAB的C/C++语言编译器后,可以使用如下命令将.m程序编译成exe文件或C/C++语言源程序。
mcc-mmfilename%编译生成exe文件,允许弹出MS-DOS命令窗口
mcc-emfilename%编译生成静默运行的exe文件,不显示运行结果
mcc-lmfilename%使用'
MicrosoftWindowsSDK7.1(C)'
编译。
mcc-Wcpplib:
component_name-Tlink:
libmfilename%使用'
MicrosoftWindowsSDK7.1(C++)'
这里主要介绍如何在matlab环境下,通过mcc命令,把m文件转换为exe文件。
无论是程序文件还是函数文件,都可以通过mcc命令将其转换为exe文件。
程序文件转换成的exe文件可以在直接运行,函数文件转换的exe文件则需要通过commandline输入参数,但输入的参数为char型,因此在程序里必须予以考虑。
举例如下:
1.建立一个m文件
建立的m文件可以是程序文件,也可以是函数文件。
例如,在matlab中建立一个m文件,命名为testadd.m,内容如下:
functionresult=testadd(v1,v2)
%函数程序使用mcc生成独立的可执行程序举例
if(ischar(v1))
v1=str2num(v1);
end
if(ischar(v2))
v2=str2num(v2);
result=v1+v2;
disp('
输入的两个参数之和为:
);
disp(result);
reply=input('
Pressanykeytoleave...'
'
s'
fprintf('
Thanksforusing!
\n'
2.生成exe文件
在commandwindow输入“mcc-mtestadd.m”,等待生成testadd.exe文件。
3.运行exe文件
对于程序文件生成的exe文件,双击运行即可。
对于函数文件生成的exe文件,通常需要在命令行对参数进行赋值。
由于前面生成的testadd.exe程序是由Matlab的函数文件编译而成,故需要在运行时给输入参数赋值,赋值方法是将参数列表附在程序名的后面用空格分开。
1).通过批处理文件运行
在该程序所在的文件夹中建立一个批处理文件testadd.cmd(用记事本或其他文本编辑器建立),例如输入testadd.exe1015并保存,双击运行testadd.cmd。
2).通过windows控制台运行
打开开始→运行窗口,输入cmd进入dos窗口,然后进入包含testadd.exe的文件夹,例如输入“testadd.exe1629”运行该程序。
值得注意的是,testadd.m函数有两个参数,而testadd.exe的输入参数只能通过commandline参数输入,但输入的参数为char型,所以程序里必须对此考虑。
对于一个不需要运行中输入参数的Matlab程序,编译后使用方便快捷,但要现实计算结果的话,会弹出黑色的MS-DOS命令窗口。
请看如下程序:
%%%请将如下程序存入testexe.m
clear;
t1=[111213141516171];
t2=[1.34.48.319.628.630.732.933.4]'
;
t1='
)
disp(t1)
t2='
disp(t2)
plot(t1,t2'
'
*r-'
t3=factor(5)
t4=magic(5)
t5='
谢谢同学们能够认真学习数学软件!
pause(5)
在Matlab的命令窗口输入命令mcc-mtestexe,得到可在windows下独立运行的程序testexe.exe,所绘图形与在Matlab环境下的效果一样。
二、mex命令
用户可以在Matlab中按简单的M文件语法规则设计出来完成特定计算的算法。
然后用Matlab编译器调用mex命令创建C共享库函数(DLL)或C++静态函数库,最后将它们整合到C/C++应用程序中,编译完这些C/C++应用程序,就可以用这些算法来实现特定的计算功能。
当然这过程中也隐藏了算法和加快了代码的执行效率。
由于mex文件执行效率高,故如果有文件重名的话,Matlab将优先调用mex文件。
Matlab的mex命令只能编译不含main()的C/C++文件,生成的mex函数供Matlab调用。
mexmfilename%编译不含main()的C/C++文件生成mex函数
mbuildmfilename%编译含有main()的C/C++文件生成mex函数
通过把耗时长的函数用c语言实现,并编译成mex函数可以加快执行速度。
Matlab本身是不带c语言编译器的,所以要求你的机器上安装VC,Dev-C++或Watcom
C等编译器之一。
如果你在安装Matlab时已经设置过编译器,那么现在你应该就可以使用mex命令来编译c语言的程序了。
如果当时没有设置,就在Matlab里键入mex
-setup,并根据提示一步步设置就可以了。
需要注意的是,较低版本的Matlab在设置编译器路径时,只能使用路径名称的8字符形式。
比如我用的VC装在路径C:
\PROGRAM
FILES\DEVSTUDIO下,那在设置路径时就要写成:
“C:
\PROGRA~1”这样设置完之后,mex就可以执行了。
为了测试你的路径设置正确与否,把下面的程序存为hello.c。
/*hello.c*/
#include"
mex.h"
voidmexFunction(intnlhs,mxArray*plhs[],intnrhs,constmxArray*prhs[])
{mexPrintf("
hello,world!
\n"
}
假设你把hello.c放在了C:
\test下,在Matlab里用CD
\test
将当前目录改为C:
\test。
(注意,仅将C:
\test加入搜索路径是没有用的)在命令窗口执行:
mex
hello.c
如果一切顺利,编译应该在出现编译器提示信息后正常退出。
如果你已将C:
\test加入了搜索路径,现在键入hello,程序会在屏幕上打出一行:
分析hello.c,可以看到程序的结构是十分简单的,整个程序由一个接口子过程
mexFunction构成:
void
mexFunction(int
nlhs,
mxArray
*plhs[],
int
nrhs,
const
*prhs[])
Matlab的mex函数有一定的接口规范,期中
nlhs:
输出参数数目
plhs:
指向输出参数的指针
nrhs:
输入参数数目
prhs:
指向输入参数的指针
例如,使用[a,b]=test(c,d,e)调用mex函数test时,传给test的这5个参数分别是plhs—2,prhs—3,其中:
prhs[0]=c
prhs[1]=d
prhs[2]=e
当函数返回时,将会把你放在plhs[0],plhs[1]里的地址赋给a和b,达到返回数据的目的。
也许你已经注意到,prhs[i]和plhs[i]都是指向类型mxArray类型数据的指针。
这个类型是在mex.h中定义的,事实上,在Matlab里大多数数据都是以这种类型存在。
当然还有其他的数据类型,可以参考Apiguide.pdf里的介绍。
为了让大家能更直观地了解参数传递的过程,我们把hello.c改写一下,使它能根据输
入参数的变化给出不同的屏幕输出:
hello1.c
#include
"
{
i;
i=mxGetScalar(prhs[0]);
if(i==1)
mexPrintf("
else
大家好!
将这个程序编译通过后,执行hello
(1),屏幕上会打出:
而hello(0)将会得到:
现在,程序hello已经可以根据输入参数来给出相应的屏幕输出。
在这个程序里,除了用到了屏幕输出函数mexPrintf(用法跟c里的printf函数几乎完全一样)外,还用到了一个函数:
mxGetScalar,调用方式如下:
Scalar"
就是标量的意思。
在Matlab里数据都是以数组的形式存在的,mxGetScalar的作用就是把通过prhs[0]传递进来的mxArray类型的指针指向的数据(标量)赋给C程序里的变量。
这个变量本来应该是double类型的,通过强制类型转换赋给了整形变量i。
既然有标量,显然还应该有矢量,否则矩阵就没法传了。
看下面的程序:
hello2.c
{
*i;
i=mxGetPr(prhs[0]);
if(i[0]==1)
}
这样,就通过mxGetPr函数从指向mxArray类型数据的prhs[0]获得了指向double类型的指针。
但是,还有个问题,如果输入的不是单个的数据,而是向量或矩阵,那该怎么处理呢
?
通过mxGetPr只能得到指向这个矩阵的指针,如果我们不知道这个矩阵的确切大小,就
没法对它进行计算。
为了解决这个问题,Matlab提供了两个函数mxGetM和mxGetN来获得传进来参数的行数
和列数。
下面例程的功能很简单,就是获得输入的矩阵,把它在屏幕上显示出来:
show.c1.0
{
double*data;
intM,N;
inti,j;
data=mxGetPr(prhs[0]);
获得指向矩阵的指针
M=mxGetM(prhs[0]);
获得矩阵的行数
N=mxGetN(prhs[0]);
获得矩阵的列数
for(i=0;
i<
M;
i++)
{for(j=0;
j<
N;
j++)
mexPrintf("
%4.3f"
data[j*M+i]);
}
编译完成后,用下面的命令测试一下:
a=1:
10;
b=[a;
a+1];
show(a)
show(b)
需要注意的是,在Matlab里,矩阵第一行是从1开始的,而在C语言中,第一行的序数为零,Matlab里的矩阵元素b(i,j)在传递到C中的一维数组data后对应于data[j*M+i]
。
输入数据是在函数调用之前已经在Matlab里申请了内存的,由于mex函数与Matlab共用同一个地址空间,因而在prhs[]里传递指针就可以达到参数传递的目的。
但是,输出参数却需要在mex函数内申请到内存空间,才能将指针放在plhs[]中传递出去。
由于返回指针类型必须是mxArray,所以Matlab专门提供了一个函数:
mxCreateDoubleMatrix来实现内存的申请,函数原型如下:
*mxCreateDoubleMatrix(int
m,
n,
mxComplexity
ComplexFlag)
m:
待申请矩阵的行数
n:
待申请矩阵的列数
为矩阵申请内存后,得到的是mxArray类型的指针,就可以放在plhs[]里传递回去了。
但是对这个新矩阵的处理,却要在函数内完成,这时就需要用到前面介绍的mxGetPr。
使用
mxGetPr获得指向这个矩阵中数据区的指针(double类型)后,就可以对这个矩阵进行各种操作和运算了。
下面的程序是在上面的show.c的基础上稍作改变得到的,功能是将输入数据加10后输出
reverse.c1.0
voidmexFunction(intnlhs,mxArray*plhs[],intnrhs,constmxArray*prhs[])
double*inData;
double*outData;
intM,N;
inti,j;
inData=mxGetPr(prhs[0]);
M=mxGetM(prhs[0]);
N=mxGetN(prhs[0]);
plhs[0]=mxCreateDoubleMatrix(M,N,mxREAL);
outData=mxGetPr(plhs[0]);
for(i=0;
i++)
for(j=0;
j++)
outData[j*M+i]=inData[j*M+i]+10;
当然,Matlab里使用到的并不是只有double类型这一种矩阵,还有字符串类型、稀疏矩阵、结构类型矩阵等等,并提供了相应的处理函数。
本文用到编制mex程序中最经常遇到的一些函数,其余的详细情况清参考Apiref.pdf。
通过前面两部分的介绍,大家对参数的输入和输出方法应该有了基本的了解。
具备了这些知识,就能够满足一般的编程需要了。
但这些程序还有些小的缺陷,以前面介绍的reverse.c由于前面的例程中没有对输入、输出参数的数目及类型进行检查,导致程序的容错性很差,以下程序则容错性较好
reverse1.c1.0
异常处理
if(nrhs!
=1)
mexErrMsgTxt("
USAGE:
b=reverse(a)/n"
if(!
mxIsDouble(prhs[0]))
theInputMatrixmustbedouble!
/n"
在上面的异常处理中,使用了两个新的函数:
mexErrMsgTxt和mxIsDouble。
MexErrMsgTxt在给出出错提示的同时退出当前程序的运行。
MxIsDouble则用于判断mxArray中的数据是否double类型。
当然Matlab还提供了许多用于判断其他数据类型的函数,这里不加详述。
需要说明的是,Matlab提供的API中,函数前缀有mex-和mx-两种。
带mx-前缀的大多是对mxArray数据进行操作的函数,如mxIsDouble,mxCreateDoubleMatrix等等。
而带mex前缀的则大多是与Matlab环境进行交互的函数,如mexPrintf,mxErrMsgTxt等等。
了解了这一点,对在Apiref.pdf中查找所需的函数很有帮助。
三、mbuild命令
要建立独立运行的C应用程序,系统中需要安装Matlab、Matlab编译器、C/C++编译器以及MatlabC/C++数学库函数和图形库函数。
Matlab编译器使用mbuild命令可以直接将C/C++源代码编译为独立运行程序,在这些源代码中可以使用Matlab提供的接口来调用Matlab数学库函数。
虽然生成的可执行程序可以脱离Matlab环境运行,但是它需要MatlabC/C++数学库文件或者图形库文件的支持才能运行。
但如果C/C++源代码完全是按传统C/C++源代码语法规则编写,没有包含Matlab数学库和图形库的调用,则不仅可以独立于Matlab环境,也不需要那两个库函数的支持。