Соберите и исследуйте метрические данные при помощи метрической инструментальной панели

Метрическая Инструментальная панель собирает и интегрирует данные о метрике качества из нескольких инструментов Model-Based Design, чтобы предоставить вам оценку вашего качественного состояния проекта. Открыть инструментальную панель:

  • В галерее Apps нажмите Metrics Dashboard.

  • В командной строке введите metricsdashboard (system). system может быть или имя модели или блок path к подсистеме. Система не может быть блоком Configurable Subsystem.

Можно собрать метрические данные при помощи инструментальной панели или программно при помощи slmetric.Engine API. Когда вы открываете инструментальную панель, если вы ранее собрали метрические данные для конкретной модели, инструментальная панель заполняет из существующих данных в базе данных.

Если вы хотите использовать инструментальную панель, чтобы собраться (или вспомнить) метрические данные на панели инструментов:

  • Используйте меню 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 используют параметр или отмечаются для проблемы, то количество параметра или количество проблемы увеличены для родительского компонента.

  • Метрическая Инструментальная панель анализирует варианты.

Для пользовательских метрик можно задать виджеты, чтобы добавить к инструментальной панели. Можно также удалить виджеты. Чтобы узнать больше о настройке Метрической Инструментальной панели, смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.

Размер

Эта таблица приводит Метрические виджеты Инструментальной панели, которые обеспечивают общую картину размера вашей системы. Когда вы развертываете в виджет, эта таблица также приводит доступную подробную информацию.

ВиджетМетрикаРазвертка - в данных
BlocksSimulink block count (mathworks.metrics.SimulinkBlockCount)Количество блоков компонентом
ModelsModel file count (mathworks.metrics.ModelFileCount)Количество файлов модели компонентом
FilesFile count (mathworks.metrics.FileCount)Количество модели и файлов библиотеки компонентом
MATLAB LOCEffective lines of MATLAB code (mathworks.metrics.MatlabLOCCount)Эффективные строки кода, в блоке MATLAB Function и функциях MATLAB в Stateflow, компонентом
Stateflow LOCEffective lines of code for Stateflow blocks (mathworks.metrics.StateflowLOCCount)Эффективные строки кода для Stateflow блокируются компонентом
System Interface
  • Input and Output count (mathworks.metrics.ExplicitIOCount)

  • Parameter count (mathworks.metrics.ParameterCount)

  • Количество вводов и выводов компонентом (включает триггерные порты),

  • Количество параметров компонентом

Податливость руководства по моделированию

Для этой конкретной системы виджеты податливости модели указывают на уровень податливости с промышленными стандартами и инструкциями. Эта таблица приводит Метрические виджеты Инструментальной панели, связанные с податливостью руководства по моделированию и подробной информацией, доступной, когда вы развертываете в виджет.

ВиджетМетрикаРазвертка - в данных
Податливость High IntegrityModel Advisor standards check compliance - High Integrity (mathworks.metrics.ModelAdvisorCheckCompliance.hisl_do178)

Для каждого компонента:

  • Процент проверок передается

  • Состояние каждой проверки

Интеграция с Model Advisor для более подробных результатов.

Податливость MAABModel Advisor standards check compliance - MAAB (mathworks.metrics.ModelAdvisorCheckCompliance.maab)

Для каждого компонента:

  • Процент проверок передается

  • Состояние каждой проверки

Интеграция с Model Advisor для более подробных результатов.

Проблемы проверки High IntegrityModel Advisor standards issues - High Integrity (mathworks.metrics.ModelAdvisorCheckIssues.hisl_do178)
  • Количество выпусков проверки податливости компонентом (см. следующее Примечание ниже).

  • Компоненты без проблем или агрегированных проблем не перечислены.

Проблемы проверки MAABModel Advisor standards issues - MAAB (mathworks.metrics.ModelAdvisorCheckIssues.maab)
  • Количество выпусков проверки податливости компонентом (см. следующее Примечание ниже).

  • Компоненты без проблем или агрегированных проблем не перечислены.

Code Analyzer WarningsWarnings from MATLAB Code Analyzer (mathworks.metrics.MatlabCodeAnalyzerWarnings)Количество предупреждений Анализатора кода компонентом.
Diagnostic WarningsSimulink diagnostic warning count (mathworks.metrics.DiagnosticWarningsCount)
  • Количество предупреждений диагностики Simulink компонентом.

  • Если существуют предупреждения наверху инструментальной панели, существует гиперссылка, которая открывает Диагностическое Средство просмотра.

Примечание

Проблема с проверкой податливости, которая анализирует параметры конфигурации, добавляет к проблеме, значат модель, которая приводит проверку к сбою.

Можно использовать Метрическую Инструментальную панель, чтобы выполнить податливость и проблемы, проверяющие собственную группу проверок Model Advisor. Для получения дополнительной информации смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.

Архитектура

Эти виджеты обеспечивают представление вашей архитектуры системы:

  • Виджет Potential Reuse/Actual Reuse показывает процент общего количества субкомпонентов, которые являются клонами и процентом общего количества компонентов, которые являются соединенными библиотечными блоками. Оранжевый указывает на потенциальное повторное использование. Синий указывает на фактическое повторное использование.

  • Другие виджеты архитектуры системы используют шкалу значения. Для каждого диапазона значений для метрики цветная панель указывает на количество компонентов, которые находятся в пределах той области значений. Более темные цвета указывают на большее количество компонентов.

Эта таблица приводит Метрические виджеты Инструментальной панели, связанные с архитектурой и подробной информацией, доступной, когда вы выбираете виджет.

ВиджетМетрикаРазвертка - в данных

Potential Reuse/Actual Reuse

Potential Reuse (mathworks.metrics.CloneContent) и Actual Reuse (mathworks.metrics.LibraryContent)

Часть общего количества субкомпонентов, которые являются клонами как процентом

Часть общего количества компонентов, которые являются соединенными библиотечными блоками как процентом

Объединяйтесь с инструментом Identify Modeling Clones путем нажатия кнопки Open Conversion Tool.

Model ComplexityCyclomatic complexity (mathworks.metrics.CyclomaticComplexity)Сложность модели компонентом
BlocksSimulink block count (mathworks.metrics.SimulinkBlockCount)Количество блоков компонентом
Stateflow LOCEffective lines of code for Stateflow blocks (mathworks.metrics.StateflowLOCCount)Эффективные строки кода для Stateflow блокируются компонентом
MATLAB LOCEffective lines of MATLAB code (mathworks.metrics.MatlabLOCCount)Эффективные строки кода, в блоке MATLAB Function и функциях MATLAB в Stateflow, компонентом

Метрические пороги

Для Сложности Модели, Податливости Руководства по моделированию и виджетов Повторного использования, Метрическая Инструментальная панель содержит пороговые значения по умолчанию. Эти значения указывают, совместимы ли ваши данные или требуют анализа (Предупреждение). Для Совместимых данных виджет содержит зеленый. Для предупреждения данных виджет содержит желтый. Виджеты, которые не имеют Метрических пороговых значений, содержат синий.

  • Для метрик Податливости Руководства по моделированию метрическое пороговое значение является нулевыми проблемами Model Advisor. Если вы моделируете, имеет проблемы, виджеты содержат желтый. Если нет никаких проблем, виджеты содержат зеленый.

  • Если ваша модель имеет предупреждения, Code Analyzer и виджеты Diagnostic являются желтыми. Если нет никаких предупреждений, виджеты содержат зеленый.

  • Для виджетов повторного использования метрическое пороговое значение является нулем. Если ваша модель имеет потенциальные клоны, виджет содержит желтый. Если нет никаких потенциальных клонов, виджет содержит зеленый.

  • Для виджета Model Complexity метрическое пороговое значение равняется 30. Если ваша модель имеет цикломатическую сложность, больше, чем 30, виджет содержит желтый. Если значение меньше чем или равно 30, виджет содержит зеленый.

Можно задать собственные метрические пороговые значения для всех виджетов в Метрической Инструментальной панели. Можно также задать значения, соответствующие несовместимой области значений. Для получения дополнительной информации смотрите, Настраивают Метрическое Размещение Инструментальной панели и Функциональность.

Ограничения инструментальной панели

При использовании Метрической Инструментальной панели отметьте эти факторы:

  • Анализ поддерживает Метрическую Инструментальную панель, не может быть блок Configurable Subsystem.

  • Model Advisor, инструмент, что Метрическое использование Инструментальной панели для сбора данных, не может иметь больше чем одного открытого заседания на модель. Поэтому, когда инструментальная панель собирает данные, она закрыла существующий сеанс Model Advisor.

  • Если вы используете sl_customization.m файл, чтобы настроить проверки Model Advisor, эти индивидуальные настройки могут изменить ваши результаты инструментальной панели. Например, если вы скрываете проверки Model Advisor, что использование инструментальной панели, чтобы собрать метрики, инструментальная панель не собирает результаты для тех метрик.

  • Когда инструментальная панель собирает метрики, которые требуют компиляции модели, изменений программного обеспечения во временной папке. Из-за этого изменения папки зависимости от относительного пути в вашей модели могут стать недопустимыми.

  • Метрическая Инструментальная панель не считает проверки MAAB, которые не являются о блоках как проблемы. Примеры включают проверки, которые предупреждают о форматировании шрифта или именах файлов. В виджете Проблем Проверки Model Advisor инструмент может сообщить о нулевых проблемах MAAB, но все еще сообщить о проблемах в виджете Податливости Руководства по моделированию MAAB. Для получения дополнительной информации об этих проблемах, кликните по виджету Податливости Руководства по моделированию MAAB.

Похожие темы