使用注释和注解描述模型
您可以使用注释和注释来描述您的模型,以帮助其他人理解它。您可以通过输入文本、显示网站内容或从父系统继承注释内容,向模型层次结构中的任何系统添加注释。对于每个系统,您还可以选择不显示任何注释。
注释是可用于向模型添加描述性注释和标注的可视化元素。还可以添加在单击它们时执行操作的注释。
文本注释可以包含以下任意组合:
文本
图片
使用LaTeX和MathML命令的方程
超链接,打开一个网站或执行MATLAB®功能
此外,还可以创建图像注释。
创建、编辑和阅读笔记
在Simuli金宝appnk中®工具条上的建模选项卡上,单击笔记.的笔记窗格中打开。在浏览层次结构时,会出现每个系统的注释。如果模型没有注释,窗格将包含入门说明。
添加注释:
在笔记窗格中,单击创建一个笔记文件.
注释存储在具有扩展名的文件中
.mldatx
.如果您希望您的模型具有注释,首先创建注释文件。创建文件后,您添加的注释将自动保存。的
.mldatx
文件与模型分开保存。如果将模型移动到另一个文件夹,则.mldatx
文件也不会移动,但如果文件在MATLAB路径上,关联仍然存在。输入notes文件的名称,或使用默认名称,然后单击保存.
例如,对于具有不同角色的用户,可以有多个与同一模型关联的notes文件。然后,使用模型的人可以在笔记文件中进行选择。Notes文件包含模型名称和版本信息,以确保Notes文件和模型匹配。
的笔记窗格处于编辑模式。您可以通过以下方式添加注释:
在文本编辑器中输入文本。
从菜单中选择使用URL注释并输入一个URL,其内容将用作当前系统的注释。
导航到模型中的另一个系统,并使用菜单选择是否输入文本、使用URL或显示父注释。
选择没有笔记.
完成添加和编辑后,单击阅读笔记按钮将笔记切换到阅读模式。
使用阅读笔记或编辑笔记按钮在阅读和编辑模式之间切换。当你点击编辑笔记时,已启用编辑功能。当你点击阅读笔记,编辑功能不可用,笔记以只读格式显示。当您浏览模型时,笔记窗格更新为当前系统的内容。
创建文本注释
要创建文本注释,请使用以下选项之一:
双击要在其中创建注释的画布并选择创建注释菜单上的。
单击注释框在Simuli金宝appnk Editor调色板上,然后单击画布。
拖动注释框在Simuli金宝appnk Editor调色板上移到画布上。
将文本从另一个应用程序拖到画布上。
从剪贴板粘贴文本。右键单击画布并选择粘贴.
编辑文本注释时,您可以:
使用格式工具栏将格式更改应用于文本或插入图像、表格或方程式。
通过右键单击注释并选择应用其他格式段从上下文菜单。例如,您可以从这个菜单创建项目符号和编号的列表。
使用上下文菜单添加超链接。您可以使用超链接打开网站或使用MATLAB命令使注释具有交互性。
使用属性检查器应用属性。中查看属性检查器建模选项卡,在设计,点击属性检查器.
在注释中添加方程式
控件,可以将方程添加到注释中插入公式按钮。
在Edit Equation对话框中,输入LaTeX或MathML代码来生成方程。有关受支金宝app持的LaTeX命令,请参见插入LaTeX方程.
若要编辑方程代码,请双击注释中的方程。可以使用格式化工具栏对注释中的方程进行格式化。您可以更改字体颜色、文本突出显示颜色、字体大小和方程式在注释中的位置。
还可以直接在数学符号和其他符号以及希腊字母注释的文本中键入TeX格式命令。
将支持的金宝appTeX命令添加到注释中。例如,添加以下文本:
\sigma \kappa \mu
下的属性检查器中,使用所选注释,或使用注释中的文本光标外观中,选择启用TeX命令.
单击注释之外时,TeX命令将以符号的形式出现在注释中。
该表显示了可以直接在Simulink注释的文本中输入的TeX字符。金宝app
金宝app支持的TeX字符 | ||
---|---|---|
|
|
|
创建图像注释
当您希望调整图像大小或独立于文本移动图像时,请创建图像注释。例如,您可以在模型中的特定位置设置公司标识的大小和位置。若要添加包含图像的注释,请将图像从本地文件系统拖到Simulink Editor画布中。金宝app
提示
若要在每个新模型中包含一个图像(如徽标),请将该图像添加到默认模板中。看到从模型创建模板.
或者,您可以拖动图像盒子从调色板到画布。那么你可以:
双击图像框并浏览到一个图像。
粘贴剪贴板中的图像。右键单击图像框并选择粘贴图片.
提示
如果您调整图像的大小,则可以将其重置为原始大小。右键单击图像并选择格式>恢复大小.
调整注释
当您输入内容时,注释会调整大小。还可以通过拖动边角来调整注释的大小。按比例调整大小转变当你拖动的时候。
在调整注释的大小之后,无论内容大小如何,注释都将保持该大小,直到再次调整它。要恢复到注释的原始高度或宽度,请在属性检查器中外观,清除固定的高度或固定宽度复选框。
将注释与块和区域关联
您可以在注释和模型中的块或区域之间添加一条线。这些注释连接器动态地连接在两端,因此它们可以根据需要移动和调整大小以维护连接。
将光标放在注释大纲上,您希望该行开始的位置。
当光标为十字准星时,将该线拖动到希望该线结束的块或区域。
提示
要指定注释连接器的颜色或宽度,请右键单击该连接器并使用格式菜单。
隐藏的注释
默认情况下,所有注释都出现在模型中。要隐藏注释,首先通过将其转换为标记来对其进行隐藏配置。然后,在格式选项卡上,单击显示标记.
您可以配置注释,以便隐藏或显示它。
右键单击注释。
从上下文菜单中选择转换为标记.
无论您设置的背景颜色是什么,标记注释的背景都是浅蓝色。如果将标记注释更改为常规注释,则该注释将返回您设置的背景色。
若要将标记注释更改为常规注释(无法隐藏的注释),请右键单击注释并选择转换为注释.
控件中隐藏所有标记注释格式选项卡中,禁用显示标记.
控件中显示隐藏的标记注释格式选项卡中,使显示标记.
请注意
在模型引用层次结构中,显示标记而且隐藏的标记仅应用于当前模型引用级别。
使注释具有互动性
要使注释具有交互性,请对文本注释中的任何内容使用超链接。
在注释中,选择要使其具有交互性的内容。
右键单击并选择超链接从上下文菜单。
在“超链接”对话框中,选择:
选择URL地址并在。中输入网址代码盒子。
选择MATLAB代码,输入MATLAB函数代码盒子。
点击好吧.
或者,您可以将这些回调函数与文本或图像注释关联起来。
Annotation回调函数 | 描述 |
---|---|
点击函数 | 单击函数是一个MATLAB函数,当您单击注释时,Simulink将调用该函数。金宝app 将单击函数与注释关联:
与单击函数关联的注释文本显示为蓝色。 如果将注释与单击函数关联,则单击将调用该函数,而不是选择注释。要选择它,请在其周围拖动一个选择框。要编辑它,右键单击并选择编辑文本或属性. |
加载函数 | 加载函数是一个MATLAB函数,当您加载包含相关注释的模型时,Simulink将调用金宝app该函数。 要将加载函数与注释关联,请以编程方式设置 |
删除函数 | 删除函数是Simulink在删除注释之前调用的MATLAB函数。金宝app 要将删除函数与注释关联,请以编程方式设置 |