主要内容

使用注释和注解描述模型

您可以使用注释和注释来描述您的模型,以帮助其他人理解它。您可以通过输入文本、显示网站内容或从父系统继承注释内容,向模型层次结构中的任何系统添加注释。对于每个系统,您还可以选择不显示任何注释。

注释是可用于向模型添加描述性注释和标注的可视化元素。还可以添加在单击它们时执行操作的注释。

文本注释可以包含以下任意组合:

  • 文本

  • 图片

  • 使用LaTeX和MathML命令的方程

  • 超链接,打开一个网站或执行MATLAB®功能

此外,还可以创建图像注释。

创建、编辑和阅读笔记

在Simuli金宝appnk中®工具条上的建模选项卡上,单击笔记.的笔记窗格中打开。在浏览层次结构时,会出现每个系统的注释。如果模型没有注释,窗格将包含入门说明。

添加注释:

  1. 笔记窗格中,单击创建一个笔记文件

    注释存储在具有扩展名的文件中.mldatx.如果您希望您的模型具有注释,首先创建注释文件。创建文件后,您添加的注释将自动保存。

    .mldatx文件与模型分开保存。如果将模型移动到另一个文件夹,则.mldatx文件也不会移动,但如果文件在MATLAB路径上,关联仍然存在。

  2. 输入notes文件的名称,或使用默认名称,然后单击保存

    例如,对于具有不同角色的用户,可以有多个与同一模型关联的notes文件。然后,使用模型的人可以在笔记文件中进行选择。Notes文件包含模型名称和版本信息,以确保Notes文件和模型匹配。

  3. 笔记窗格处于编辑模式。您可以通过以下方式添加注释:

    • 在文本编辑器中输入文本。

    • 从菜单中选择使用URL注释并输入一个URL,其内容将用作当前系统的注释。

    • 导航到模型中的另一个系统,并使用菜单选择是否输入文本、使用URL或显示父注释。

    • 选择没有笔记

  4. 完成添加和编辑后,单击阅读笔记按钮将笔记切换到阅读模式。

使用阅读笔记编辑笔记按钮在阅读和编辑模式之间切换。当你点击编辑笔记时,已启用编辑功能。当你点击阅读笔记,编辑功能不可用,笔记以只读格式显示。当您浏览模型时,笔记窗格更新为当前系统的内容。

创建文本注释

要创建文本注释,请使用以下选项之一:

  • 双击要在其中创建注释的画布并选择创建注释菜单上的。

  • 单击注释框在Simuli金宝appnk Editor调色板上,然后单击画布。

  • 拖动注释框在Simuli金宝appnk Editor调色板上移到画布上。

  • 将文本从另一个应用程序拖到画布上。

  • 从剪贴板粘贴文本。右键单击画布并选择粘贴

编辑文本注释时,您可以:

  • 使用格式工具栏将格式更改应用于文本或插入图像、表格或方程式。

  • 通过右键单击注释并选择应用其他格式从上下文菜单。例如,您可以从这个菜单创建项目符号和编号的列表。

  • 使用上下文菜单添加超链接。您可以使用超链接打开网站或使用MATLAB命令使注释具有交互性。

  • 使用属性检查器应用属性。中查看属性检查器建模选项卡,在设计,点击属性检查器

在注释中添加方程式

控件,可以将方程添加到注释中插入公式按钮。

在Edit Equation对话框中,输入LaTeX或MathML代码来生成方程。有关受支金宝app持的LaTeX命令,请参见插入LaTeX方程

若要编辑方程代码,请双击注释中的方程。可以使用格式化工具栏对注释中的方程进行格式化。您可以更改字体颜色、文本突出显示颜色、字体大小和方程式在注释中的位置。

还可以直接在数学符号和其他符号以及希腊字母注释的文本中键入TeX格式命令。

  1. 将支持的金宝appTeX命令添加到注释中。例如,添加以下文本:

    \sigma \kappa \mu
  2. 下的属性检查器中,使用所选注释,或使用注释中的文本光标外观中,选择启用TeX命令

    单击注释之外时,TeX命令将以符号的形式出现在注释中。

该表显示了可以直接在Simulink注释的文本中输入的TeX字符。金宝app

金宝app支持的TeX字符

α

β

γ

δ

ε

ζ

埃塔

θ

vartheta

极微小

卡巴

λ

μ

ν

西

π

ρ

σ

varsigma

τ

upsilon

φ

ψ

ω

γ

δ

θ

λ

西

π

σ

Upsilon

φ

ψ

ω

原则,

存在

ast

sim卡

leq

infty

clubsuit

diamondsuit

heartsuit

spadesuit

leftarrow

向上光标键

rightarrow

downarrow

中国保监会

组的

propto

部分

子弹

div

neq

阿莱

即时通讯

再保险

otimes

oplus

参赛者

supseteq

supset

subseteq

子集

int

o

版权

0

ldots

varpi

cdot

三角

中期

Leftarrow

Rightarrow

向上光标键

Downarrow

主要的

微分算符

无道理的

负的

lceil

rceil

lfloor

rfloor

langle

纠正

创建图像注释

当您希望调整图像大小或独立于文本移动图像时,请创建图像注释。例如,您可以在模型中的特定位置设置公司标识的大小和位置。若要添加包含图像的注释,请将图像从本地文件系统拖到Simulink Editor画布中。金宝app

提示

若要在每个新模型中包含一个图像(如徽标),请将该图像添加到默认模板中。看到从模型创建模板

或者,您可以拖动图像盒子从调色板到画布。那么你可以:

  • 双击图像框并浏览到一个图像。

  • 粘贴剪贴板中的图像。右键单击图像框并选择粘贴图片

提示

如果您调整图像的大小,则可以将其重置为原始大小。右键单击图像并选择格式>恢复大小

调整注释

当您输入内容时,注释会调整大小。还可以通过拖动边角来调整注释的大小。按比例调整大小转变当你拖动的时候。

在调整注释的大小之后,无论内容大小如何,注释都将保持该大小,直到再次调整它。要恢复到注释的原始高度或宽度,请在属性检查器中外观,清除固定的高度固定宽度复选框。

将注释与块和区域关联

您可以在注释和模型中的块或区域之间添加一条线。这些注释连接器动态地连接在两端,因此它们可以根据需要移动和调整大小以维护连接。

  1. 将光标放在注释大纲上,您希望该行开始的位置。

  2. 当光标为十字准星时,将该线拖动到希望该线结束的块或区域。

提示

要指定注释连接器的颜色或宽度,请右键单击该连接器并使用格式菜单。

隐藏的注释

默认情况下,所有注释都出现在模型中。要隐藏注释,首先通过将其转换为标记来对其进行隐藏配置。然后,在格式选项卡上,单击显示标记

您可以配置注释,以便隐藏或显示它。

  1. 右键单击注释。

  2. 从上下文菜单中选择转换为标记

无论您设置的背景颜色是什么,标记注释的背景都是浅蓝色。如果将标记注释更改为常规注释,则该注释将返回您设置的背景色。

若要将标记注释更改为常规注释(无法隐藏的注释),请右键单击注释并选择转换为注释

控件中隐藏所有标记注释格式选项卡中,禁用显示标记

控件中显示隐藏的标记注释格式选项卡中,使显示标记

请注意

在模型引用层次结构中,显示标记而且隐藏的标记仅应用于当前模型引用级别。

使注释具有互动性

要使注释具有交互性,请对文本注释中的任何内容使用超链接。

  1. 在注释中,选择要使其具有交互性的内容。

  2. 右键单击并选择超链接从上下文菜单。

  3. 在“超链接”对话框中,选择:

    • 选择URL地址并在。中输入网址代码盒子。

    • 选择MATLAB代码,输入MATLAB函数代码盒子。

  4. 点击好吧

或者,您可以将这些回调函数与文本或图像注释关联起来。

Annotation回调函数 描述
点击函数

单击函数是一个MATLAB函数,当您单击注释时,Simulink将调用该函数。金宝app

将单击函数与注释关联:

  1. 打开“Annotation属性”对话框。右键单击注释并选择属性

  2. ClickFcn选项卡,使用以下选项之一:

    • 在下面的文本框中ClickFcn,输入定义点击函数的MATLAB代码。

    • 使用注释文本作为点击功能。选择使用注释文本作为单击回调复选框。

  3. 点击好吧

与单击函数关联的注释文本显示为蓝色。

如果将注释与单击函数关联,则单击将调用该函数,而不是选择注释。要选择它,请在其周围拖动一个选择框。要编辑它,右键单击并选择编辑文本属性

加载函数

加载函数是一个MATLAB函数,当您加载包含相关注释的模型时,Simulink将调用金宝app该函数。

要将加载函数与注释关联,请以编程方式设置LoadFcn的属性金宝app仿真软件。注释对象指定为所需函数。

删除函数

删除函数是Simulink在删除注释之前调用的MATLAB函数。金宝app

要将删除函数与注释关联,请以编程方式设置DeleteFcn的属性金宝app仿真软件。注释对象指定为所需函数。

另请参阅

相关的话题