Соберите и исследуйте метрические данные при помощи метрической инструментальной панели
Метрическая Инструментальная панель собирает и интегрирует данные о метрике качества из нескольких инструментов Model-Based Design, чтобы предоставить вам оценку вашего качественного состояния проекта. Открыть инструментальную панель:
Из окна редактора моделей выберите Analysis > Metrics Dashboard.
В командной строке введите
metricsdashboard(system)systemможет быть или именем модели или блоком path к подсистеме. Система не может быть Конфигурируемым блоком Subsystem.
Можно собрать метрические данные при помощи инструментальной панели или программно при помощи API slmetric.Engine. Когда вы открываете инструментальную панель, если вы ранее собрали метрические данные для конкретной модели, инструментальная панель заполняет от существующих данных в базе данных.
Если вы хотите использовать инструментальную панель, чтобы собраться (или вспомнить) метрические данные на панели инструментов:
Используйте меню Options, чтобы задать, включать ли модели - ссылки и библиотеки в сборе данных.
Нажмите All Metrics. Если вы не хотите собирать метрики, которые требуют компиляции модели, нажимают Non-Compile Metrics.
Метрическая Инструментальная панель обеспечивает имя системы и метку времени сбора данных. Если были проблемы во время сбора данных, кликните по значку предупреждения, чтобы видеть предупреждения.
Метрические виджеты инструментальной панели
Метрическая Инструментальная панель содержит виджеты, которые обеспечивают визуализацию метрических данных в этих категориях: размер, соответствие руководства по моделированию и архитектура. Чтобы исследовать данные более подробно, кликните по отдельному метрическому виджету. Для вашей выбранной метрики таблица показывает значение, агрегированное значение, и измеряется (если применимо) на уровне компонента модели. Из таблицы инструментальная панель обеспечивает трассируемость и гиперссылки на источник данных так, чтобы можно было получить подробные результаты и рекомендуемые действия для поиска и устранения неисправностей проблем. При исследовании развертки - в данных, обратите внимание что:
Метрическая Инструментальная панель вычисляет метрические данные на компонент. Компонент может быть моделью, подсистемой, графиком или блоком MATLAB function.
Для всех виджетов можно просмотреть результаты в любом представление Tree или Table. Для High Integrity и виджетов соответствия MAAB, можно также выбрать представление Grid. Чтобы просмотреть подсвеченные результаты, в представлении сетки, кликают по соответствующей ячейке.
Чтобы отсортировать результаты по значению или агрегированному значению, кликните по соответствующему заголовку столбца значений.
Для всех метрик кроме High Integrity и виджетов соответствия MAAB, можно отфильтровать результаты. Чтобы отфильтровать результаты, в представлении Table, выбирают контекстное меню на правой стороне TYPE, COMPONENT и заголовков столбцов PATH. Из меню TYPE выберите применимые компоненты. Из меню COMPONENT и PATH введите имя компонента или путь в панели поиска. Метрическая Инструментальная панель сохраняет фильтры для виджета, таким образом, можно посмотреть метрические детали для других виджетов и возвратиться к отфильтрованным результатам.
В представлении Table и Tree, значении или агрегированном значении n/a не указывает ни на какие доступные результаты для того компонента. Если значение и агрегированное значение являются n/a, представление Table не перечисляет компонент. Представление Tree действительно перечисляет такой компонент. Для виджета Stateflow LOC изображение показывает сравнение.
Метрические данные, которые собраны, определяют количество полной системы, включая экземпляры той же модели. Для агрегированных значений метрический механизм агрегировал данные из каждого экземпляра модели в иерархии ссылки. Например, если на ту же модель ссылаются дважды в системной иерархии, ее количество блока способствует дважды полному системному количеству блока.
Если подсистема, график или блок MATLAB function используют параметр или отмечаются для проблемы, то количество параметра или количество проблемы увеличены для родительского компонента.
Метрическая Инструментальная панель анализирует варианты.
Для пользовательских метрик можно задать виджеты, чтобы добавить к инструментальной панели. Можно также удалить виджеты. Чтобы узнать больше о настройке Метрической Инструментальной панели, смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.
Размер
Эта таблица приводит Метрические виджеты Инструментальной панели, которые обеспечивают общую картину размера вашей системы. Когда вы развертываете в виджет, эта таблица также приводит доступную подробную информацию.
| Виджет | Метрика | Развертка - в данных |
|---|---|---|
| Blocks | Simulink block count (mathworks.metrics.SimulinkBlockCount) | Количество блоков компонентом |
| Models | Model file count (mathworks.metrics.ModelFileCount) | Количество образцовых файлов компонентом |
| Files | File count (mathworks.metrics.FileCount) | Количество модели и файлов библиотеки компонентом |
| MATLAB LOC | Effective lines of MATLAB code (mathworks.metrics.MatlabLOCCount) | Эффективные строки кода, в блоке MATLAB function и функциях MATLAB в Stateflow, компонентом |
| Stateflow LOC | Effective lines of code for Stateflow blocks (mathworks.metrics.StateflowLOCCount) | Эффективные строки кода для Stateflow блокируются компонентом |
| System Interface |
|
|
Соответствие руководства по моделированию
Для этой конкретной системы образцовые виджеты соответствия указывают на уровень соответствия с промышленными стандартами и инструкциями. Эта таблица приводит Метрические виджеты Инструментальной панели, связанные с соответствием руководства по моделированию и подробной информацией, доступной, когда вы развертываете в виджет.
| Виджет | Метрика | Развертка - в данных |
|---|---|---|
| Соответствие High Integrity | Model Advisor standards check compliance - High Integrity (mathworks.metrics.ModelAdvisorCheckCompliance.hisl_do178) | Для каждого компонента:
Интеграция с Model Advisor для более подробных результатов. |
| Соответствие MAAB | Model Advisor standards check compliance - MAAB (mathworks.metrics.ModelAdvisorCheckCompliance.maab) | Для каждого компонента:
Интеграция с Model Advisor для более подробных результатов. |
| Проблемы проверки High Integrity | Model Advisor standards issues - High Integrity (mathworks.metrics.ModelAdvisorCheckIssues.hisl_do178) |
|
| Проблемы проверки MAAB | Model Advisor standards issues - MAAB (mathworks.metrics.ModelAdvisorCheckIssues.maab) |
|
| Code Analyzer Warnings | Warnings from MATLAB Code Analyzer (mathworks.metrics.MatlabCodeAnalyzerWarnings) | Количество предупреждений Анализатора кода компонентом. |
| Diagnostic Warnings | Simulink diagnostic warning count (mathworks.metrics.DiagnosticWarningsCount) |
|
Примечание
Проблема с проверкой соответствия, которая анализирует параметры конфигурации, добавляет к проблеме, значат модель, которая приводит проверку к сбою.
Можно использовать Метрическую Инструментальную панель, чтобы выполнить соответствие и проблемы, проверяющие собственную группу проверок Model Advisor. Для получения дополнительной информации смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.
Архитектура
Эти виджеты обеспечивают представление вашей архитектуры системы:
Виджет Potential Reuse/Actual Reuse показывает процент общего количества субкомпонентов, которые являются клонами и процентом общего количества компонентов, которые являются соединенными блоками библиотеки. Оранжевый указывает на потенциальное повторное использование. Синий указывает на фактическое повторное использование.
Другие виджеты архитектуры системы используют шкалу значения. Для каждого диапазона значений для метрики цветная панель указывает на количество компонентов, которые находятся в пределах той области значений. Более темные цвета указывают на большее количество компонентов.
Эта таблица приводит Метрические виджеты Инструментальной панели, связанные с архитектурой и подробной информацией, доступной, когда вы выбираете виджет.
| Виджет | Метрика | Развертка - в данных |
|---|---|---|
Potential Reuse/Actual Reuse | Potential Reuse ( | Часть общего количества субкомпонентов, которые являются клонами как процентом Часть общего количества компонентов, которые являются соединенными блоками библиотеки как процентом Объединяйтесь с инструментом Identify Modeling Clones путем нажатия кнопки Open Conversion Tool. |
| Model Complexity | Cyclomatic complexity (mathworks.metrics.CyclomaticComplexity) | Сложность модели компонентом |
| Blocks | Simulink block count (mathworks.metrics.SimulinkBlockCount) | Количество блоков компонентом |
| Stateflow LOC | Effective lines of code for Stateflow blocks (mathworks.metrics.StateflowLOCCount) | Эффективные строки кода для Stateflow блокируются компонентом |
| MATLAB LOC | Effective lines of MATLAB code (mathworks.metrics.MatlabLOCCount) | Эффективные строки кода, в блоке MATLAB function и функциях MATLAB в Stateflow, компонентом |
Метрические пороги
Для Сложности Модели, Соответствия Руководства по моделированию и виджетов Повторного использования, Метрическая Инструментальная панель содержит пороговые значения по умолчанию. Эти значения указывают, совместимы ли ваши данные или требуют анализа (Предупреждение). Для Совместимых данных виджет содержит зеленый. Для предупреждения данных виджет содержит желтый. Виджеты, которые не имеют Метрических пороговых значений, содержат синий.
Для метрик Соответствия Руководства по моделированию метрическое пороговое значение является нулевыми проблемами Model Advisor. Если вы моделируете, имеет проблемы, виджеты содержат желтый. Если нет никаких проблем, виджеты содержат зеленый.
Если ваша модель имеет предупреждения, Code Analyzer и виджеты Diagnostic являются желтыми. Если нет никаких предупреждений, виджеты содержат зеленый.
Для виджетов повторного использования метрическое пороговое значение является нулем. Если ваша модель имеет потенциальные клоны, виджет содержит желтый. Если нет никаких потенциальных клонов, виджет содержит зеленый.
Для виджета Model Complexity метрическое пороговое значение равняется 30. Если ваша модель имеет цикломатическую сложность, больше, чем 30, виджет содержит желтый. Если значение меньше чем или равно 30, виджет содержит зеленый.
Можно задать собственные метрические пороговые значения для всех виджетов в Метрической Инструментальной панели. Можно также задать значения, соответствующие несовместимой области значений. Для получения дополнительной информации смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.
Ограничения инструментальной панели
При использовании Метрической Инструментальной панели отметьте эти факторы:
Анализ поддерживает Метрическую Инструментальную панель, не может быть Конфигурируемый блок Subsystem.
Model Advisor, инструмент, что Метрическое использование Инструментальной панели для сбора данных, не может иметь больше чем одного открытого заседания на модель. Поэтому, когда инструментальная панель собирает данные, она закрыла существующий сеанс Model Advisor.
Если вы используете файл
sl_customization.m, чтобы настроить проверки Model Advisor, эти индивидуальные настройки могут изменить ваши результаты инструментальной панели. Например, если вы скрываете проверки Model Advisor, что использование инструментальной панели, чтобы собрать метрики, инструментальная панель не собирает результаты для тех метрик.Когда инструментальная панель собирает метрики, которые требуют образцовой компиляции, изменений программного обеспечения во временной папке. Из-за этого изменения папки зависимости от относительного пути в вашей модели могут стать недопустимыми.
Метрическая Инструментальная панель не поддерживает замаскированные блоки библиотеки самоизменения. Анализ этих компонентов может быть неполным.
Метрическая Инструментальная панель не считает проверки MAAB, которые не являются о блоках как проблемы. Примеры включают проверки, которые предупреждают о форматировании шрифта или именах файлов. В виджете Проблем Проверки Model Advisor инструмент может сообщить о нулевых проблемах MAAB, но все еще сообщить о проблемах в виджете Соответствия Руководства по моделированию MAAB. Для получения дополнительной информации об этих проблемах, кликните по виджету Соответствия Руководства по моделированию MAAB.