1.3 MATLAB的帮助文档

随着MATLAB版本的不断更新,MATLAB的帮助文档也在逐步改进。用户不仅可以在“命令行窗口”中使用help命令和lookfor命令查看帮助,还可以通过Internet查找所需资源。

1.3.1 “命令行窗口”中的帮助

在MATLAB的图形用户接口出现之前,只能使用help命令和lookfor命令在“命令行窗口”中查看帮助,这两个命令至今仍在使用。如下所示的代码可以用于查看sqrt()函数的帮助文本:

img

如果不知道具体的函数名,但知道与该函数相关的某个关键字,则可以使用lookfor命令进行查找。例如,如果想使用某个与关键字inverse有关的函数,则可以使用如下所示的代码进行查找:

img
img

lookfor命令在执行时将打开MATLAB搜索路径中的所有M函数文件,然后在文件中的第1行注释(即H1帮助行)中寻找给定的关键字,最后返回所有匹配的H1帮助行。

常用的MATLAB帮助命令如表1-1所示。

表1-1 常用的MATLAB帮助命令

img

1.3.2 帮助浏览器

除了help命令和lookfor命令,MATLAB还提供了相对分离的帮助浏览器或“帮助”窗口。要打开MATLAB“帮助”窗口,用户可以选择MATLAB主界面中“帮助”菜单下的“示例”命令,或者在MATLAB的“命令行窗口”中直接输入helpwin、helpdesk或doc。

“帮助”窗口不仅可以显示帮助文本,还可以提供帮助导航功能。帮助导航提供了4个选项卡,即contents、index、search和demo。其中,contents选项卡中提供了MATLAB和所有工具箱的在线文档的内容列表;index选项卡提供了所有在线帮助条目的索引;search选项卡允许用户在在线文档中进行搜索;demo选项卡则提供了MATLAB演示函数命令的接口。

help命令和helpwin命令在显示帮助内容上是等效的,只不过helpwin命令将帮助内容显示在一个“帮助”窗口中,而不是在“命令行窗口”中直接显示。例如,下面的代码将打开一个“帮助”窗口用于显示sqrt命令的帮助文本:

img

实际上,MATLAB在执行上述代码时,首先打开sqrt.m文件,读取帮助文本,然后将文件转换成HTML格式,并在“帮助”窗口中显示该HTML文本。在该过程中,大写字母的函数命令都将被转换成小写格式,列在See also后面的参考函数命令都被转换成能够链接到相应的HTML链接。

doc命令会绕过M文件的帮助文本,直接链接在线帮助文档。例如,下面的代码将显示print命令的在线帮助文档:

img

在线帮助文档包含了比帮助文本更多、更详细的信息。

whatsnew命令和whatsnew toolbox语句用于在“帮助”窗口中显示MATLAB或某个选定工具箱的发布信息和最后修改时间。实际上,whatsnew toolbox语句在后台打开了工具箱的Readme.m文件,并在“帮助”窗口中显示出来。

1.3.3 Internet资源

MathWorks公司(MATLAB的制造商)的网站是互联网上排名在前100名的商业网站,其网址是http://www.mathworks.com,该网站提供了涵盖MATLAB各个方面的信息。

由于该网站的内容繁多,并且经常更新,时常添加新内容、删除旧链接。因此,本书无法且没有必要对网站上的具体内容进行讲解,有兴趣的读者可以到该网站上查阅相关内容。

但是,MathWorks 公司的网站上有两个非常有用的工具需要特别注意:一个是解决方案搜索引擎(Solution Search Engine),另一个是MATLAB中心(MATLAB Central)。