exponenta event banner

slmetric.Класс двигателя

Пакет: slmetric
Суперклассы:

Сбор метрических данных о моделях или компонентах модели

Описание

Использовать slmetric.Engine объект для сбора метрических данных о моделях путем вызова execute. Использовать getMetrics для доступа к данным метрики и возврата массива slmetric.metric.ResultCollection объекты. Эти метрические данные сохраняются в папке кэша моделирования. Будущие экземпляры slmetric.Engine объект для той же модели может обращаться к кэшированным данным метрики без регенерации данных метрики.

Строительство

metric_engine = slmetric.Engine() создает метрический объект механизма.

Свойства

развернуть все

Имя корневой модели или подсистемы для сбора метрических данных, как указано в slmetric.Engine.setAnalysisRoot способ. Это свойство доступно только для чтения.

Укажите, анализирует ли механизм метрики связанные с библиотекой подсистемы в корневой модели, включая библиотеки внутри ссылочных моделей под корнем. Метрический анализ не включает связанные блоки со встроенными библиотеками Simulink. Задайте для этого параметра значение false или 0 не включать библиотеки в метрический анализ.

Типы данных: logical

Укажите, анализирует ли механизм метрики ссылочные модели в корневой модели. Выберите из следующих значений:

СтоимостьОписание
NoneМеханизм Metric не собирает метрические данные для ссылочных моделей.
NormalModeOnlyMetric Engine собирает метрические данные только для ссылочных моделей, работающих в обычном режиме моделирования.
AllModesMetric Engine собирает метрические данные для ссылочных моделей, работающих в обычном и ускоренном режимах моделирования.

Типы данных: char

Методы

выполнитьСбор метрических данных
exportMetricsЭкспорт метрик модели
getAnalysisRootMetricПолучение метрических данных только для одной метрики для корня анализа
getErrorLogПолучить журнал ошибок
getMetricDistributionПолучить метрическое распределение
getMetricMetaInformation Получение метрических метаданных
getMetricsДоступ к данным метрики модели
getStatisticsПолучение статистики по метрическим данным
setAnalysisRootУкажите модель или подсистему для метрического анализа

Примеры

свернуть все

Сбор метрических данных модели и доступ к ним sldemo_mdlref_basic.

Создание slmetric.Engine и задайте корень в модели для анализа.

metric_engine = slmetric.Engine();

% Include referenced models and libraries in the analysis, 
%     these properties are on by default
metric_engine.ModelReferencesSimulationMode = 'AllModes';
metric_engine.AnalyzeLibraries = 1;

setAnalysisRoot(metric_engine, 'Root',  'sldemo_mdlref_basic');

Сбор данных метрики модели

execute(metric_engine, 'mathworks.metrics.ExplicitIOCount');

Получение данных метрики модели, возвращающих массив slmetric.metric.ResultCollection объекты, res_col.

res_col = getMetrics(metric_engine, 'mathworks.metrics.ExplicitIOCount');

Отображение результатов для mathworks.metrics.ExplicitIOCount метрика.

for n=1:length(res_col)
    if res_col(n).Status == 0
        result = res_col(n).Results;
        
        for m=1:length(result)
            disp(['MetricID: ',result(m).MetricID]);
            disp(['  ComponentPath: ', result(m).ComponentPath]);
            disp(['  Value: ', num2str(result(m).Value)]);
            disp(['  AggregatedValue: ', num2str(result(m).AggregatedValue)]);
            disp(['  Measures: ', num2str(result(m).Measures)]);
            disp(['  AggregatedMeasures: ', num2str(result(m).AggregatedMeasures)]);
        end
    else
        disp(['No results for:', result(n).MetricID]);
    end
    disp(' ');
end

Вот результаты:

MetricID: mathworks.metrics.ExplicitIOCount
  ComponentPath: sldemo_mdlref_basic
  Value: 3
  AggregatedValue: 4
  Measures: 0  3
  AggregatedMeasures: 3  3
MetricID: mathworks.metrics.ExplicitIOCount
  ComponentPath: sldemo_mdlref_basic/More Info
  Value: 0
  AggregatedValue: 0
  Measures: 0  0
  AggregatedMeasures: 0  0
MetricID: mathworks.metrics.ExplicitIOCount
  ComponentPath: sldemo_mdlref_counter
  Value: 4
  AggregatedValue: 4
  Measures: 3  1
  AggregatedMeasures: 3  1

Для ComponentPath: sldemo_mdlref_basic, значение равно 3 потому что есть 3 выходы. Три выхода находятся во втором элементе Measures массив. slmetric.metric.AggregationMode является Max, так что AggregatedValue является 4 количество входов и выходов в sldemo_mdlref_counter. AggregratedMeasures массив содержит максимальное количество входов и выходов для компонента или подкомпонента.

Представлен в R2016a