Main Content

이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

getMetrics

클래스: slmetric.Engine
네임스페이스: slmetric

(삭제 예정) 모델 메트릭 데이터에 액세스

Metrics Dashboard 사용자 인터페이스, metricdashboard 기능, slmetric 패키지 API 및 해당 사용자 정의는 향후 릴리스에서 제거될 예정입니다. 자세한 내용은 Migrating from Metrics Dashboard to Model Maintainability Dashboard를 참조하세요.

설명

지정된 모델 메트릭 엔진에서 모델 메트릭 데이터에 액세스합니다. execute을 호출하면 메트릭 엔진이 메트릭 데이터를 수집합니다. 반환된 메트릭 데이터는 정의된 아키텍처 구성 요소를 기반으로 합니다. 구성요소는 다음 Simulink 객체입니다.

  • 모델

  • 하위 시스템 블록

  • 차트

  • MATLAB 함수 블록

  • 보호된 모델

Results = getMetrics(metric_engine)는 메트릭 엔진이 실행한 모든 메트릭에 대한 메트릭 데이터를 반환합니다.

예제

Results = getMetrics(metric_engine,MetricIDs)는 지정된 지표 식별자에 대한 지표 데이터를 반환합니다.

Results = getMetrics(metric_engine,MetricIDs,'AggregationDepth',ad)는 지정된 지표 식별자에 대한 지표 데이터를 반환하고 데이터 집계 방법을 지정합니다.

입력 인수

모두 확장

execute을 호출하면 metric_engine는 사용 가능한 모든 MathWorks 메트릭 또는 지정된 MetricIDs에 대한 메트릭 데이터를 수집합니다. getMetrics을 호출하면 metric_engine에서 수집된 메트릭 데이터에 액세스합니다.

모델 지표 또는 생성한 사용자 정의 모델 지표에 대한 지표 식별자입니다. 하나 이상의 지표 식별자를 지정할 수 있습니다. slmetric.metric.getAvailableMetrics를 호출하여 메트릭 식별자를 얻을 수 있습니다.

예: 'mathworks.metrics.DescriptiveBlockNames'

getMetrics이 지표 데이터를 집계하는 구성 요소의 깊이 또는 수준으로, 이름-값 쌍 인수로 지정됩니다. 값은 다음 중 하나입니다.

  • All - getMetrics는 세부 결과를 구성 요소 수준으로 집계합니다. 그런 다음 구성요소 수준 결과를 사용하여 구성요소 계층 구조를 순회하여 집계된 값을 계산합니다. getMetrics는 구성 요소 수준 결과만 반환합니다.

  • None — 측정값과 값을 집계하지 않습니다. 이 옵션을 지정하면 getMetrics는 메트릭 알고리즘에 의해 수집된 메트릭 값을 반환합니다. 예를 들어 지표 알고리즘이 세부 결과를 반환하는 경우 세부 결과는 집계 없이 반환됩니다. 반환된 slmetric.metric.Result 개체의 AggregatedValueAggregatedMeasures 속성이 비어 있습니다.

예: 'AggregationDepth','None'

데이터형: char

출력 인수

모두 확장

메트릭 엔진의 메트릭 데이터입니다.

예제

모두 확장

sldemo_mdlref_basic 모델에 대한 모델 지표 데이터를 수집하고 액세스합니다.

모델 열기

openExample('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.SimulinkBlockCount');

slmetric.metric.ResultCollection 객체 배열, res_col를 반환하는 모델 메트릭 데이터를 가져옵니다.

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

mathworks.metrics.SimulinkBlockCount 메트릭에 대한 결과를 표시합니다.

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)]);
        end
    else
        disp(['No results for:', result(n).MetricID]);
    end
    disp(' ');
end

버전 내역

R2016a에 개발됨

모두 축소

R2022a: Metrics Dashboard이 제거됩니다

Metrics Dashboard 사용자 인터페이스, metricdashboard 기능, slmetric 패키지 API 및 해당 사용자 정의는 향후 릴리스에서 제거될 예정입니다. 자세한 내용은 Migrating from Metrics Dashboard to Model Maintainability Dashboard를 참조하세요.