本节书摘来自华章出版社《信息物理融合系统（CPS）设计、建模与仿真——基于 Ptolemy II 平台》一书中的第2章，第2.4节，作者：［美］爱德华·阿什福德·李（Edward Ashford Lee），更多章节内容可以访问云栖社区“华章计算机”公众号查看

2.4　注释及参数设置

本节将从多个方面改进图2-20的模型。比如参数添加、修饰和注释文档的插入以及角色图标的定制等。
2.4.1　层次化模型中的参数
首先，注意图2-20中，噪声覆盖了正弦曲线，使其几乎不可见。对这个信道模型的一个有效的修改方法是：添加一个参数（parameter），用来设置噪声的强度。为了实现这种改变，右击信道角色打开信道模型，并选择Open Actor。在信道模型中加入参数的方法是，在Utilities→Parameters子库中选择一个参数并将它拖进模型，如图2-22所示。右击参数将它重命名为noisePower（为了在表达式中使用参数，在Parameter中其名字不能有空格）右击（或双击）参数，将它的值改为0.1。

图2-22　在信道模型中添加参数
现在，这个参数可以用于设置噪声的大小。Gaussian角色（高斯角色）有一个称为standardDeviation（标准差）的参数。因为噪声强度等于方差而不等于标准差，所以将standardDeviation的值改为sqrt （noisePower），如图2-23所示。（关于表达式语言，详见第13章）

图2-23　Gaussian 角色的标准差被改为噪声强度的平方根
为了观察参数造成的影响，返回到顶层模型，并编辑Channel角色的参数（双击或右击并选择[Customize→Configure]）。将noisePower从默认值0.1改为0.01。运行该模型。应能得到图2-24所示的相对清晰的正弦曲线。

图2-24　图2-20中的简单信号处理模型的输出，噪声强度 = 0.01
还可以为复合角色添加参数，方法是在复合角色的参数编辑对话框中单击Add按钮。该对话框可通过双击Channel图标来访问，或者通过右击并选择[Customize→Configure]，或者通过单击复合角色内的背景并选择[Customize→Configure]。这里需要注意的一个关键问题是，这种方式添加的参数在图中是不可见的，因此这种机制应该谨慎使用，并且仅当有充分理由对浏览者隐藏模型参数时使用。
最后，注意可以创建一个称为端口参数（port parameter）或者参数端口（parameterport）的对象，它既是一个参数也是一个端口。图2-5中的frequency和phase对象就是参数端口。它们像任何其他参数一样，可以在一个表达式中访问，但当一个输入在参数端口执行期间到达时，其参数值会被更新。若想在模型中创建一个端口参数对象，只需简单地从Utilities→Parameters库中拖出并为之命名即可。
2.4.2　修饰元素
也可以使用各种修饰元素（即，那些可以影响模型外表而不影响其功能的元素）来进行模型的修饰。这些元素可以增强模型的可读性和美感。例如，试着从“Utilities→Decorative”子库拖拽一个Annotation（注释）图表，并命名。这种注释非常值得推荐，它们相当于程序中的注释，可以极大地提高程序的可读性。其他修饰元素（如几何图形）可以从相同的库中拖拽。
2.4.3　创建自定义图标
Vergil提供了图标编辑器，它允许用户创建自定义角色图标。创建自定义角色图标的方法是：右击标准图标并选择[Appearance→Edit Custom Icon]，如图2-25所示。图标编辑器中间的方框显示默认图标的尺寸，以供参考。创建一个如图2-26所示的图标。提示：矩形的填充颜色设置为none，设置四边形的填充颜色时首先使用颜色选择器，然后再调整透明度alpha为0.5。最后，因为图标本身带有角色名，打开[Customize→Rename]对话框可选择不显示角色名。

图2-25　Channel 角色的自定义图标编辑器

图2-26　Channel 角色的自定义图标