作者:lm_nudt MATLAB中的帮助指令 MALTAB的各个函数,不管是内建函数、M文件函数、还是MEX文件函数等,一般它们都有M文件的使用帮助和函数功能说明,各个工具箱通常情况下也具有一个与工具箱名相同的M文件用来说明工具箱的构成内容等。在MATLAB命令窗口中,可以通过指令来获取这些纯文本的帮助信息。 通常能够起到帮助作用、获取帮助信息的指令有help、lookfor、which、doc、get、type等。 help指令 可以说help指令是MATLAB中最有用的指令之一;也可以说,如果一个MATLAB编程人员不能够熟练的使用help指令,那么他(她)就不能够称之为一个熟练的MATLAB使用者。下面介绍一下help的几种常见使用情况。 1)直接使用help指令,可以获取当前电脑上MATLAB的分类列表,即当前安装的工具箱名称以及其简要描述。例如,在命令窗口种输入help,可以得到如下信息: help HELP topics matlab\general - General purpose commands. matlab\ops - Operators and special characters. matlab\lang - Programming language constructs. matlab\elmat - Elementary matrices and matrix manipulation. matlab\graphics - Handle Graphics. matlab\uitools - Graphical user interface tools. matlab\codetools - Commands for creating and debugging code. matlab\helptools - Help commands. simulink\simulink - Simulink simulink\blocks - Simulink block library. simulink\components - Simulink components. ... ... xpc\xpcdemos - xPC Target -- demos and sample script files. xpc\xpcmngr - (No table of contents file) kernel\embedded - xPC Target Embedded Option MATLAB7\work - (No table of contents file) (上面的省略号为笔者所加) 2)使用 help 工具箱名,可以获取该工具箱的相关的函数、图形用户工具以及演示文件名等。由前面的help的使用方法1),我们可以在毫不知道我们要查找的函数具体名称,也不清除它所在工具箱的具体名称,仅仅知道其大概所属类别的情况下,查找出其所在工具箱的具体名称。然后,再用help 工具箱名就可以得到该工具箱的函数列表,每个函数后面有简要的说明,可以根据其说明来确定可能需要的是哪个函数。例如,在命令窗口中,输入 help optim 就可以获得该工具箱基本信息和分类函数列表: help optim Optimization Toolbox Version 3.0 (R14) 05-May-2004 Nonlinear minimization of functions. fminbnd - Scalar bounded nonlinear function minimization. ... ... Nonlinear minimization of multi-objective functions. fgoalattain - Multidimensional goal attainment optimization ... ... Linear least squares (of matrix problems). lsqlin - Linear least squares with linear constraints. ... ... Demonstrations of medium-scale methods. tutdemo - Tutorial walk-through. goaldemo - Goal attainment. datdemo - Fitting data to a curve. ... ... Medium-scale examples from User's Guide objfun - nonlinear objective confun - nonlinear constraints ... ... Large-scale examples from User's Guide nlsf1 - nonlinear equations objective with Jacobian ... ... densecolumns - MAT-file of linear programming example (上面的省略号为笔者所加) 3)使用help 函数名可以获得该函数的纯文本的帮助信息,通常也带有少量的例子。通过上面的使用方法2),应该已经找到了需要的函数的具体名称,然后就可以在MATLAB命令窗口中用help指令获取该函数的具体信息了。例如,help fminbnd可以得到如下信息: help fminbnd FMINBND Scalar bounded nonlinear function minimization. X = FMINBND(FUN,x1,x2) attempts to find a local minimizer X of the function. FUN in the interval x1 <= X <= x2. FUN accepts scalar input X and returns a scalar function value F evaluated at X. X = FMINBND(FUN,x1,x2,OPTIONS) ... ... %通常这里都是该函数的使用的语法及其各个输入输出参数意义描述<笔者注> Examples ... ... % 这里是一些该函数的使用举例<笔者注> See also OPTIMSET, FMINSEARCH, FZERO, FUNCTION_HANDLE.% 给出一些相关命令 Reference page in Help browser doc fminbnd 在采用这种方法得到该函数帮助信息的时候,一个值得注意的是最后面的See also给出了该函数有相关的一些指令,有时候通过这些相关指令,可以查找到更广泛的有用信息。 lookfor指令 lookfor 指令是在MATLAB的搜索路径所有M文件的第一个注释行搜索特定关键字。通常在我们不确定需要搜索的函数,知道该函数的功能的时候,也可以通过 lookfor 搜索该功能的关键字。例如,想查找一个画椭圆的命令,我们可以lookfor ellipse(如果不知道椭圆怎么写,可以先用汉英字典查找),得到如下信息,然后再选取函数查找具体的信息: lookfor ellipse ELLIPSEDRAW can draw an arbitrary ellipse with given parameters. ELLIPSE Ellipse Grapics Object Using Line or Patch. RECTANGLE Create rectangle, rounded-rectangle, or ellipse. ECC2FLAT Computes the flattening of an ellipse given an eccentricity ECC2N Computes the parameter n of an ellipse given an eccentricity FLAT2ECC Computes the eccentricity of an ellipse given a flattening N2ECC Computes the eccentricity of an ellipse given the parameter n PDEELLIP Draw ellipse, update Geometry Description matrix. FITMODEL Fit an ellipse to data. which 指令 which 指令可以用来定位该函数的位置,通过这个位置信息,可以获取该函数所属的类别。通常,编程人家再自己创建一个M文件或者保存一个M文件的时候,为了避免与系统函数等同名,就应该先用which 文件(函数)名 –all 搜索查找是否存在你想要保存的文件名或者函数名。 另外,很好的利用得到的位置信息可以进行一些相关联的文件的帮助信息。例如,在编程过程中,需要一个保存文件对话框,但想不起该函数名,也不确定是否确实有此函数,但是我们很清楚的是有个与此类似打开文件对话框,函数名为 uigetfile,因此,采用which定位uigetfile: which uigetfile -all d:\programs\matlab7\toolbox\matlab\uitools\uigetfile.bi d:\programs\matlab7\toolbox\matlab\uitools\uigetfile.m % Shadowed 从给出的地址可以看出,该函数属于uitools类,于是用help uitools查找该类别信息,在该类别的Dialog boxes子类别中找到这么一条: uiputfile - Standard save file dialog box. 然后,在通过用 help uiputfile获取该函数的详细的帮助信息和使用方法。 set/get 指令 set 指令可以获取图形对象的属性列表和被选属性值。在GUI编程和数据可视化的时候,有时想改变某些对象的属性,让它按照自己的想法实现,但是又想不起这些对象的属性名,更不知道如何设置它们。这时,可以用 get(objecthandles)得到此对象的所有的属性及其当前值,用set(handles)可以得到对象所有可以设置的属性及其可能的取值。找到需要的属性名和可能的取值之后,就用set(handles,propertyname,values)设置此对象此属性的值。 其他帮助指令 doc 函数名可以在MATLAB的帮助文档浏览器中调出该函数的文档;type M文件函数名或者edit M文件函数名可以分别在命令窗口中打印出该M文件源代码 和 在M文件编辑器中打开该M文件函数源代码,以便查看该函数源文件;helpwin 函数名与 help 函数名获得的帮助信息一样,只是将其在帮助文件浏览器中打开。 |
欢迎光临 智能车制作 (http://dns.znczz.com/) | Powered by Discuz! X3.2 |