Есть несколько способов ввода комментариев.
Если комментарий относится к «целой» модели и содержит хороший фрагмент текста (например, документирование функции или отслеживание программных функций в требованиях) - включите Блок документов .
Блок Doc позволит вам добавить много материала, и текст может быть извлечен позже с помощью инструмента отчетности, или просто дважды щелкнете для просмотра. Вариант RTF также позволяет форматировать.
Для небольших аннотаций к модели, которые не связаны с конкретным блоком; двойной щелчок, и вы получите блок аннотации модели . После того, как вы заполнили это текстом, вы можете отформатировать его (цвет, тень) и переместить его.
Для получения важных комментариев и информации о конкретном блоке я рекомендую открыть свойства блока и заполнить вкладку Документация . Если это относительно короткий комментарий, вы также можете отобразить этот текст рядом с блоком, перейдя на вкладку «Аннотация блока» и добавив%. (В этом списке вы также найдете тонны других полезных вещей, например, начальные значения и другие важные параметры). Эти комментарии перемещаются вместе с блоком, который уменьшает вероятность неуместных комментариев.
Еще одна приятная особенность заполнения блочной документации заключается в том, что эти комментарии можно сделать так, чтобы они появлялись в сгенерированном коде рядом с тем, где реализован блок.
Наконец, один из самых мощных способов комментирования в Simulink: Тщательно выбирайте названия своих блоков !!!
Имя блока часто появляется в сгенерированном коде в виде комментариев или даже в виде имен переменных, оно также появляется в большинстве распечаток ошибок / отладок. Таким образом, вы можете сэкономить себе и другим кучу времени, если название блока носит описательный характер. По этой причине даже для блоков, где вы обычно скрываете имя, я бы порекомендовал назвать их в Model Explorer.