2024-09-04 |欢迎您，第位读者！|

Documentation in Matlab最好的老师

前言

学习Matlab,最好的老师就是Matlab帮助文档, 最好的办法就是敲一敲命令,看一看文档,自己探索.

Matlab对技术和工程领域最大贡献中,帮助文档可以说是最大的一部分.这个帮助文档不仅仅是一个软件文档,而是一个完整的学习系统,包括了语言基础,函数/工具箱使用,编程技巧,甚至是一些工程实践经验.

Matlab的帮助与文档

Matlab的帮助安装

Matlab的最新版帮助文档有一个在线版本，可以在MathWorks的网站上查看。以前有段时间Mathworks还搞点必须注册登录才能看之类的，现在好像又没有了。Matlab能够得到这么广泛使用，其中一个原因就是Matlab的帮助文档写得很好。在Matlab之前，代数计算的openblas一直是存在的，GNU还有一个C版本的科学计算库，GSL（其实文档也不错）。Matlab最好的就是提供了一个比较直观的DSL（M语言，虽然简陋，但是有用），并且提供了一个很好的帮助文档。

Matlab的帮助文档也可以安装在本地，这样可以在没有网络的情况下查看帮助文档。旧版本的我已经忘记是怎么装的了，最新版的Matlab可以直接在菜单里选择把文档安装到本地。如果是下载的DVD版本的Matlab 文档，把那个ISO挂在到虚拟光驱上，在虚拟光驱里的bin/win64目录下有一个命令行程序mpm，可以用这个程序安装Matlab的帮助文档。

1mpm install-doc --matlabroot="C:\Program Files\MATLAB\R2023b"

在这里插入图片描述

Matlab的帮助文档查看

Matlab帮助文档可以通过菜单的帮助按钮来访问，然后就是一个跟电子书差不多的东西，左边可以选不同的内容，右上角的搜索框可以全文搜索。

不过我们一般也可以采用命令行的方式来查看文档。

跟文档相关的命令行函数有以下几个。

help：查看函数的帮助
doc：打开帮助文档
docsearch：搜索帮助文档

还有一个可以搜索所有的函数文件的全文内容的命令lookfor，以及查找命令对应函数文件的which命令。

下面我们应该干的第一件事情，就是查看一下help命令的帮助。

`help`命令

help命令是Matlab中最常用的命令之一，它可以查看函数的帮助文档。

1help help

这里其实有一个很好玩的约定，就是help help命令到底是什么？

约定：当采用不带括号的方式调用函数时，Matlab会把后面的内容当做字符串处理。

也就是help help实际上就是调用help('help')函数。

那么还有第二个问题，help('help')函数返回的到底是什么？

关于这个问题，请运行以下代码。

1edit help

这个等效于

1edit('help')

或者

1open('help')

请一定要自己试试看。

这个命令会打开help函数的源代码，这个源代码是一个M文件，可以看到这个文件里面有一些%开头的注释，这些注释就是help函数的帮助文档。

约定：Matlab的帮助文档是通过在函数文件的开头添加注释来实现的。

这部分的内容包括从函数定义function语句之后第一个注释开始，到下一个注释之间的内容。也就是接下来所有连续的%开头的行。

自己编写自己的函数式，也最好能够遵循这个约定，当然，首先应该是多打开你感兴趣的函数，看看到底是怎么写的注释，如果你愿意仔细去看函数是怎么写的，那么你就已经是一个超有好奇心的天才Matlab程序员了。

当然我们可以看到，有些函数的源文件，就只有注释，没有实际的代码，这就是一个纯粹的文档文件。函数可能是一个MEX文件，或者是一个内置函数，这些函数的源代码是不可见的。

作为报错的帮助

另外，Matlab中的报错信息也是一个很好的帮助文档。当你在Matlab中输入一个错误的命令时，Matlab会返回一个错误信息，这个错误信息是一个很好的帮助文档。

1a = 1;
2a(1,2)

>> a(1,2)
位置 2 处的索引超出数组边界(不能超出 1)。

不过Matlab没有那种直接返回错误信息和Exception的功能。一般只能

1try
2    a(1,2)
3catch ME
4    disp(ME)
5end

MException - 属性:

  identifier: 'MATLAB:badsubscript'
     message: '位置 2 处的索引超出数组边界(不能超出 1)。'
       cause: {}
       stack: [0×1 struct]
  Correction: []

可以看到，这个错误是一个MATLAB:badsubscript错误，这个错误的信息是位置 2 处的索引超出数组边界(不能超出 1)。。

结论

Matlab的帮助文档是一个很好的学习工具；
可以通过help命令查看函数的内置帮助文档；
Matlab的内置帮助文档是通过在函数文件的开头添加注释来实现的；
Matlab的报错信息也是一个很好的帮助文档。