Main Content

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

slmetric.metric.Result

(제거 예정) 지정된 모델 구성 요소 및 메트릭 알고리즘에 대한 메트릭 데이터

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

설명

slmetric.metric.Result 개체에는 지정된 모델 구성 요소 및 메트릭 알고리즘에 대한 메트릭 데이터가 포함되어 있습니다.

생성

설명

metric_result = slmetric.metric.Result는 메트릭 결과 개체에 대한 핸들을 생성합니다.

또는 slmetric.metric.ResultCollection 개체에서 결과를 수집하는 경우 컬렉션 개체의 Results 속성은 수집된 slmetric.metric.Result 개체를 배열로 반환합니다.

예제

속성

모두 확장

읽기 전용 속성입니다.

메트릭 결과 개체의 고유 숫자 식별자로, 정수로 반환됩니다.

데이터형: uint64

메트릭이 계산되는 구성요소 객체의 고유 식별자로, 문자형 벡터로 지정됩니다. ComponentID을 사용하여 생성된 결과 개체를 분석된 구성 요소로 추적합니다. algorithm 방법을 사용하여 ComponentID 또는 ComponentPath 속성을 설정합니다.

예: 'sldemo_mdlref_basic'

데이터형: char

메트릭이 계산되는 구성요소 경로로, 문자형 벡터로 지정됩니다. ComponentID 속성을 설정하는 대신 ComponentPath를 사용합니다. 메트릭 엔진은 ComponentPathComponentID로 변환합니다. algorithm 방법을 사용하여 ComponentID 또는 ComponentPath 속성을 설정합니다.

예: 'vdp/More Info/Model Info/EmptySubsystem'

데이터형: char

모델 지표 또는 생성한 사용자 지정 모델 메트릭에 대한 메트릭 식별자로, 문자형 벡터로 지정됩니다. slmetric.metric.getAvailableMetrics를 호출하여 메트릭 식별자를 얻을 수 있습니다.

예: 'mathworks.metrics.SimulinkBlockCount'

데이터형: char

MetricID로 지정된 메트릭과 ComponentID로 지정된 구성요소에 대해 알고리즘에 의해 생성된 메트릭 스칼라 값(double로 지정됨).

알고리즘이 메트릭 스칼라 값을 지정하지 않는 경우 Value의 값은 NaN입니다. 예를 들어 Stateflow 차트가 포함된 모델에 대한 지표 데이터를 수집한다고 가정해 보겠습니다. StateflowChartObjectCount 지표의 경우 모델 slmetric.metric.Result 객체의 Value 속성은 NaN입니다. 모델 자체가 Stateflow 객체를 가질 수 없기 때문입니다. 모델 slmetric.metric.Result 개체의 AggregatedValue 속성에는 차트에 있는 Stateflow 개체의 총 수가 포함되어 있습니다.

데이터형: double

읽기 전용 속성입니다.

모델 계층 전체에 걸쳐 집계된 메트릭 값으로, double로 반환됩니다. 메트릭 엔진은 AggregationMode를 기반으로 메트릭 값을 암시적으로 집계합니다. 모든 구성 요소에 대해 Value 속성이 NaN인 경우 AggregatedValue은 0입니다.

데이터형: double

메트릭 알고리즘으로 지정되는 메트릭 측정값으로, double형 배열로 지정됩니다. 메트릭 측정값에는 메트릭 값에 대한 자세한 정보가 포함되어 있습니다. 예를 들어, 하위 시스템당 블록 수를 계산하는 지표의 경우 가상 및 비가상 블록 수를 포함하는 측정값을 지정할 수 있습니다. 지표 값은 가상 블록 수와 비가상 블록 수의 합계입니다.

slmetric.metric.Metric.algorithm 방법을 사용하여 이 속성을 설정합니다.

데이터형: double

읽기 전용 속성입니다.

모델 계층 전체에 걸쳐 집계된 메트릭 값으로, double형 배열로 반환됩니다. 메트릭 엔진은 AggregationMode를 기반으로 메트릭 측정값을 암시적으로 집계합니다.

데이터형: double

slmetric.metric.ResultDetail 개체의 배열로 지정된 Value 속성에 대해 메트릭 엔진이 계산하는 내용에 대한 세부 정보입니다.

읽기 전용 속성입니다.

메트릭 데이터 카테고리로, 다음 네 가지 카테고리 중 하나로 반환됩니다.

  • 준수 — 허용 가능한 범위에 있는 지표 데이터입니다.

  • 경고 — 검토가 필요한 지표 데이터입니다.

  • NonCompliant — 모델 수정이 필요한 지표 데이터입니다.

  • 분류되지 않음 — 임계값이 설정되지 않은 지표 데이터입니다.

slmetric.config.ResultClassification 개체로 지정되는 지표 데이터 범주 및 각 범주에 해당하는 범위입니다. 임계값이 설정되지 않은 경우 이 속성은 비어 있습니다.

메트릭 알고리즘에서 선택적으로 제공하는 사용자 데이터로, 문자형 벡터로 지정됩니다.

데이터형: char

예제

모두 축소

이 예에서는 sldemo_mdlref_basic 모델에 대한 지표 데이터를 수집하고 액세스하는 방법을 보여줍니다.

sldemo_mdlref_basic 모델을 엽니다.

open_system('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

ComponentPath: sldemo_mdlref_basic의 경우 출력이 3개이므로 값은 3입니다. 세 개의 출력은 Measures 배열의 두 번째 요소에 있습니다. slmetric.metric.AggregationModeMax이므로 AggregatedValue4이며, 이는 sldemo_mdlref_counter에 대한 입출력 개수입니다. AggregatedMeasures 배열에는 구성 요소 또는 하위 구성 요소에 대한 최대 입력 및 출력 수가 포함됩니다.

버전 내역

R2016a에 개발됨

모두 축소

R2022a: Metrics Dashboard이 제거됩니다

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