Панель управления Metrics собирает и интегрирует данные показателей качества из нескольких инструментов конструирования на основе модели, чтобы обеспечить оценку состояния качества проекта. Чтобы открыть панель мониторинга:
В галерее Приложения щелкните Панель мониторинга метрик.
В командной строке введите metricsdashboard(. system)system может быть либо именем модели, либо путем блока к подсистеме. Система не может быть блоком конфигурируемой подсистемы.
Можно собирать метрические данные с помощью инструментальной панели или программным способом с помощью slmetric.Engine API. При открытии инструментальной панели, если ранее были собраны метрические данные для определенной модели, инструментальная панель заполняется существующими данными в базе данных.
Если вы хотите использовать инструментальную панель для сбора (или повторного сбора) метрических данных, на панели инструментов:
Используйте меню Опции (Options), чтобы указать, следует ли включать ссылки на модель и библиотеки в коллекцию данных.
Щелкните Все метрики (All Metrics). Если не требуется собирать метрики, требующие компиляции модели, щелкните Не компилировать метрики (Non-Compile Metrics).
Панель мониторинга метрик предоставляет имя системы и метку времени сбора данных. Если во время сбора данных возникли проблемы, щелкните значок предупреждения, чтобы увидеть предупреждения.
Для каждой модели или подсистемы может быть открыта только одна панель мониторинга. Кроме того, если панель мониторинга открыта для модели или подсистемы и данные метрик для этой модели или подсистемы собираются программным способом, панель мониторинга автоматически закрывается.
Панель управления метриками содержит виджеты, которые обеспечивают визуализацию метрических данных в следующих категориях: размер, соответствие рекомендациям по моделированию и архитектура. Чтобы просмотреть данные более подробно, щелкните отдельный графический элемент метрики. Для выбранной метрики таблица отображает значение, агрегированное значение и измерения (если применимо) на уровне компонента модели. В таблице инструментальная панель предоставляет возможность отслеживания и гиперссылки на источник данных, что позволяет получить подробные результаты и рекомендуемые действия для устранения неполадок. При изучении данных сверления обратите внимание на то, что:
Панель управления метриками вычисляет метрические данные для каждого компонента. Компонентом может быть модель, подсистема, диаграмма или функциональный блок MATLAB.
Результаты можно просмотреть в виде дерева или таблицы. Для виджетов соответствия High Integrity и MAB можно также выбрать представление Grid. Для просмотра выделенных результатов щелкните ячейку на виде сетки.
Для сортировки результатов по значению или агрегированному значению щелкните по соответствующему заголовку столбца значений.
Для показателей, отличных от виджетов соответствия High Integrity и MAB, можно фильтровать результаты. Для фильтрации результатов в представлении «Таблица» выберите контекстное меню в правой части заголовков столбцов TYPE, COMPONENT и PATH. В меню ТИП (TYPE) выберите подходящие компоненты. В меню КОМПОНЕНТ и ПУТЬ введите имя компонента или путь на панели поиска. Панель управления метриками сохраняет фильтры для виджета, чтобы можно было просмотреть сведения о метриках для других виджетов и вернуться к отфильтрованным результатам.
В представлении Таблица (Table) и Дерево (Tree) значение или агрегированное значение n/a указывает, что результаты недоступны для этого компонента. Если значение и агрегированное значение равны n/a, в табличном представлении компонент не отображается. Древовидное представление перечисляет такой компонент. Для виджета Stateflow LOC на изображении показано сравнение.
Собираемые метрические данные количественно определяют общую систему, включая экземпляры одной и той же модели. Для агрегированных значений механизм метрики агрегирует данные из каждого экземпляра модели в ссылочной иерархии. Например, если на одну и ту же модель ссылаются дважды в системной иерархии, ее подсчет блоков дважды вносит вклад в общий подсчет системных блоков.
Если подсистема, диаграмма или функциональный блок MATLAB используют параметр или отмечены для проблемы, то количество параметров или количество проблем увеличивается для родительского компонента.
Панель мониторинга метрик анализирует варианты.
Для пользовательских метрик можно указать виджеты для добавления на панель мониторинга. Можно также удалить виджеты. Дополнительные сведения о настройке панели мониторинга показателей см. в разделе Настройка компоновки и функциональности панели мониторинга показателей.
В этой таблице перечислены виджеты панели управления метриками, которые предоставляют общую картину размера системы. При развертке графического элемента в этой таблице также содержится подробная информация.
| Виджет | Метрика | Данные развертки |
|---|---|---|
| Блоки | Число блоков симулятора (mathworks.metrics.SimulinkBlockCount) | Количество блоков по компонентам |
| Модели | Количество файлов модели (mathworks.metrics.ModelFileCount) | Количество файлов модели по компонентам |
| Файлы | Число файлов (mathworks.metrics.FileCount) | Количество файлов модели и библиотеки по компонентам |
| MATLAB LOC | Действующие строки кода MATLAB (mathworks.metrics.MatlabLOCCount) | Эффективные строки кода в функциональном блоке MATLAB и функции MATLAB в модуле Stateflow по компонентам |
| LOC потока состояний | Действующие строки кода для блоков Stateflow (mathworks.metrics.StateflowLOCCount) | Эффективные строки кода для блоков Stateflow по компонентам |
| Системный интерфейс |
|
|
Для этой конкретной системы виджеты соответствия модели указывают уровень соответствия отраслевым стандартам и руководящим принципам. В этой таблице перечислены виджеты панели мониторинга метрик, связанные с соответствием рекомендациям по моделированию, и подробные сведения, доступные при развертке виджета.
| Виджет | Метрика | Данные развертки |
|---|---|---|
| Высокий уровень соответствия требованиям безопасности | Стандарты Model Advisor проверяют соответствие - Высокая целостность (mathworks.metrics.ModelAdvisorCheckCompliance.hisl_do178) | Для каждого компонента:
Интеграция с Model Advisor для получения более подробных результатов. |
| Соответствие требованиям MAB | Проверка соответствия стандартам Model Advisor - MAB (mathworks.metrics.ModelAdvisorCheckCompliance.maab) | Для каждого компонента:
Интеграция с Model Advisor для получения более подробных результатов. |
| Проблемы с проверкой целостности | Проблемы стандартов Model Advisor - высокая целостность (mathworks.metrics.ModelAdvisorCheckIssues.hisl_do178) |
|
| Проблемы с проверкой MAB | Проблемы стандартов Model Advisor - MAB (mathworks.metrics.ModelAdvisorCheckIssues.maab) |
|
| Предупреждения анализатора кода | Предупреждения анализатора кода MATLAB (mathworks.metrics.MatlabCodeAnalyzerWarnings) | Количество предупреждений анализатора кода по компонентам. |
| Диагностические предупреждения | Счетчик диагностических предупреждений Simulink (mathworks.metrics.DiagnosticWarningsCount) |
|
Примечание
Проблема с проверкой соответствия, которая анализирует параметры конфигурации, добавляет число проблем для модели, которая не выполняет проверку.
Панель мониторинга Metrics можно использовать для проверки соответствия и проблем в собственной группе проверок Model Advisor. Дополнительные сведения см. в разделе Настройка компоновки и функциональности панели мониторинга метрик.
Эти виджеты обеспечивают представление архитектуры системы:
Графический элемент «Потенциальное повторное использование/фактическое повторное использование» показывает процент от общего числа клонов подкомпонентов и процент от общего числа компонентов, являющихся связанными блоками библиотеки. Оранжевый указывает на возможное повторное использование. Синий цвет указывает на фактическое повторное использование.
Другие виджеты архитектуры системы используют шкалу значений. Для каждого диапазона значений метрики цветная полоса указывает количество компонентов, попадающих в этот диапазон. Более темные цвета указывают на большее количество компонентов.
В этой таблице перечислены виджеты панели управления метриками, связанные с архитектурой, и подробная информация, доступная при выборе виджета.
| Виджет | Метрика | Данные развертки |
|---|---|---|
Потенциальное/фактическое повторное использование | Потенциальное повторное использование ( | Доля общего количества подкомпонентов, которые являются клонами в процентах Доля общего количества компонентов, которые являются связанными блоками библиотеки, в процентах Выполните интеграцию с инструментом «Идентификация клонов моделирования», нажав кнопку «Открыть инструмент преобразования». |
| Сложность модели | Цикломатическая сложность (mathworks.metrics.CyclomaticComplexity) | Сложность модели по компонентам |
| Блоки | Число блоков симулятора (mathworks.metrics.SimulinkBlockCount) | Количество блоков по компонентам |
| LOC потока состояний | Действующие строки кода для блоков Stateflow (mathworks.metrics.StateflowLOCCount) | Эффективные строки кода для блоков Stateflow по компонентам |
| MATLAB LOC | Действующие строки кода MATLAB (mathworks.metrics.MatlabLOCCount) | Эффективные строки кода в функциональном блоке MATLAB и функции MATLAB в модуле Stateflow по компонентам |
Для виджетов Сложность модели (Model Complexity), Соответствие рекомендациям моделирования (Modeling Guideline Compliance) и Повторное использование (Reuse) панель мониторинга метрик содержит пороговые значения по умолчанию. Эти значения указывают на соответствие данных требованиям или необходимость проверки (предупреждение). Для совместимых данных виджет содержит зеленый цвет. Для предупреждающих данных виджет содержит желтый цвет. Виджеты, не имеющие пороговых значений Metric, содержат синий цвет.
Для метрик соответствия рекомендации по моделированию пороговое значение метрики равно нулю проблем, связанных с Model Advisor. При наличии проблем в модели виджеты содержат желтый цвет. Если проблем нет, виджеты содержат зеленый цвет.
Если в модели имеются предупреждения, виджеты Code Analyzer и Diagnostic будут желтыми. Если предупреждения отсутствуют, виджеты содержат зеленый цвет.
Для виджетов повторного использования пороговое значение метрики равно нулю. Если модель имеет потенциальные клоны, виджет содержит желтый цвет. Если потенциальные клоны отсутствуют, виджет содержит зеленый цвет.
Для графического элемента «Сложность модели» пороговое значение метрики равно 30. Если в модели цикломатическая сложность превышает 30, виджет содержит желтый цвет. Если значение меньше или равно 30, виджет содержит зеленый цвет.
Можно указать собственные пороговые значения метрик для всех виджетов на панели управления метриками. Можно также указать значения, соответствующие несоответствующему диапазону. Дополнительные сведения см. в разделе Настройка компоновки и функциональности панели мониторинга метрик.
При использовании панели мониторинга показателей обратите внимание на следующие соображения.
Корень анализа для панели мониторинга метрик не может быть блоком конфигурируемой подсистемы.
Инструмент Model Advisor, используемый панелью мониторинга метрик для сбора данных, не может иметь более одного открытого сеанса на модель. Поэтому, когда инструментальная панель собирает данные, она закрывает существующую сессию Model Advisor.
Если используется sl_customization.m чтобы настроить проверки Model Advisor, эти настройки могут изменить результаты панели мониторинга. Например, при скрытии проверки, которую использует инструментальная панель для сбора метрик, инструментальная панель не собирает результаты для этих метрик.
Когда панель мониторинга собирает метрики, требующие компиляции модели, программа переходит во временную папку. Из-за этого изменения папки зависимости относительного пути в модели могут стать недопустимыми.
Панель мониторинга метрик не считает проверки MAB, которые не относятся к блокам, как проблемы. Примеры включают проверки, предупреждающие о форматировании шрифтов или именах файлов. В виджете проверки проблем Model Advisor средство может сообщать об отсутствии проблем MAB, но при этом сообщать о проблемах в виджете соответствия руководству по моделированию MAB. Для получения дополнительных сведений об этих проблемах щелкните графический элемент «Соответствие рекомендаций по моделированию MAB».