您是否有過(guò)這樣的經(jīng)歷：當(dāng)打開(kāi)舊版本的 Simulink 模型或某個(gè)同事開(kāi)發(fā)的模型時(shí)完全搞不清如何使用？在這種情況下，添加恰當(dāng)?shù)淖⒔鈺?huì)非常有幫助。

本文將使用圖 1 所示的 Simulink 汽車模型來(lái)演示 5 種為Simulink模型添加注解的方法（分為上下兩篇），包括：

指定和顯示模型信息

為模型添加注釋

為模塊和信號(hào)加注解

向模型層添加備注

為總線、信號(hào)和參數(shù)添加注解

圖1. Simulink 中完整的汽車模型。

學(xué)習(xí)資源

指定和顯示模型信息

第一步是創(chuàng)建高級(jí)描述。您可以在 Property Inspector（屬性查看）中或者右鍵單擊畫(huà)布并選擇 Model Properties（模型屬性）查看和編輯模型的 Description （描述）屬性。若要查看模型描述，請(qǐng)?jiān)?a href="http://www.makelele.cn/tags/matlab/" target="_blank">MATLAB命令提示中（圖2，左上角）輸入help，然后再輸入模型名稱。

圖 2. Model Properties 對(duì)話框，顯示模型描述（左）和歷史信息（右）。

Property Inspector（屬性查看）中的 Info（信息）選項(xiàng)卡和 Model Properties（模型屬性）對(duì)話框（圖2，右側(cè)）中的 History（歷史）選項(xiàng)卡還匯總了模型歷史信息，包括變動(dòng)、版本和上次保存的日期。

模型描述和模型屬性也可以從模型中查看。使用 Model Info（模型信息）模模塊指定要顯示的屬性（圖3）。

圖 3. 顯示模型屬性的 Model Info（模型信息）模塊。

為模型添加注釋

添加注釋是另一種提升設(shè)計(jì)可讀性和清晰度的方式。注釋是快速添加描述性備注和標(biāo)注的視覺(jué)元素。使用選項(xiàng)板或者雙擊畫(huà)布并選擇 Create Annotation（創(chuàng)建注釋），可創(chuàng)建文本、圖像、方程、網(wǎng)站鏈接或 MATLAB 函數(shù)鏈接的組合。您可以修改注釋的類型和外觀；例如，您可以在 LaTeX 或 MathML 中添加數(shù)學(xué)方程式。

通過(guò)將光標(biāo)放在注釋輪廓上并將連接線拖動(dòng)到目標(biāo)模塊上，可以在注釋和模塊之間添加連接線。通過(guò)使用選項(xiàng)板或在感興趣的區(qū)域周圍拖動(dòng)一個(gè)框并從操作欄中選擇 Create Area(創(chuàng)建區(qū)域)，可以將模型中的各區(qū)域框起來(lái)，以直觀地對(duì)相關(guān)模模塊進(jìn)行分組并提高模型的可讀性。可以標(biāo)記區(qū)域以指示模模塊之間的關(guān)系。

圖 4 說(shuō)明了這些注釋技術(shù)。

圖 4. 添加了注釋的模型。

為模塊和信號(hào)加注解

隨著設(shè)計(jì)的進(jìn)展，您可能會(huì)發(fā)現(xiàn)自己要處理數(shù)百甚至數(shù)千個(gè)模塊和信號(hào)，這使得模型更加不易閱讀。

通過(guò)命名信號(hào)和模塊，可以立即提高設(shè)計(jì)的清晰度（圖 5）。右鍵單擊該信號(hào)并選擇 Properties（屬性），或者只需雙擊該信號(hào)即可輸入或編輯信號(hào)名稱。單擊模塊正下方的默認(rèn)名稱即可命名該模塊。

圖 5. 添加注釋的模塊和信號(hào)。

使用模塊或信號(hào)屬性中的相應(yīng)字段輸入模塊或信號(hào)的描述。隨后，您可以在模塊圖標(biāo)下方或在模塊上方懸停時(shí)顯示描述和其他模塊屬性。帶注釋的模塊和信號(hào)如圖5所示。您還可以將模塊描述作為注釋包含在從模型生成的 C/C++ 代碼中。

如果使用封裝技術(shù)創(chuàng)建模塊的自定義接口，用戶仍然可以在 Mask Editor 的 Documentation（文檔）窗格中提供描述（圖 6）。同一窗格中的 Help（幫助）字段可以讓您輸入所需信息，該信息會(huì)在用戶單擊封裝模塊對(duì)話框的 Help（幫助）按鈕時(shí)顯示。

圖6. 屏蔽模塊的注解。

將在下篇中介紹向模型層添加備注以及為總線、信號(hào)和參數(shù)添加注解的方法。