Main Content

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

getMetrics

메트릭 결과에 액세스

R2020b 이후

설명

results = getMetrics(metricEngine,metricIDs)metricIDs에 지정한 메트릭에 대해 지정된 metric.Engine 개체에 대한 메트릭 결과를 반환합니다. metric.Engine에 대한 지표 결과를 수집하려면 execute 함수를 사용하세요. 그런 다음 getMetrics를 사용하여 결과에 액세스합니다.

Fixed-Point Designer™ 문서에는 getMetrics (Fixed-Point Designer) 함수도 있습니다.

예제

results = getMetrics(metricEngine,metricIDs,'ArtifactScope',scope)는 지정한 scope의 아티팩트에 대한 메트릭 결과를 반환합니다. 예를 들어, scope를 프로젝트의 단위로 지정할 수 있습니다.

예제

예제

모두 축소

프로젝트의 요구 사항 기반 테스트 아티팩트에 대한 지표 결과를 수집합니다.

모델 및 테스트 아티팩트가 포함된 프로젝트를 엽니다. 이 예에서는 MATLAB® 명령 창에 다음을 입력합니다.

openExample("slcheck/ExploreTestingMetricDataInModelTestingDashboardExample");
openProject("cc_CruiseControl");

metric.Engine 객체를 생성합니다. metric.Engine 개체를 사용하여 현재 프로젝트에 대한 메트릭 결과를 수집할 수 있습니다.

metric_engine = metric.Engine();

metric_engine에 대한 추적 정보를 업데이트하여 아티팩트 정보가 최신인지 확인하십시오.

updateArtifacts(metric_engine)

metric.Engine 개체에서 execute 함수를 사용하여 'RequirementsPerTestCase' 지표에 대한 결과를 수집합니다.

execute(metric_engine,'RequirementsPerTestCase');

결과에 액세스하려면 getMetrics 함수를 사용하십시오. 결과 개체 배열을 results 변수에 할당합니다.

results = getMetrics(metric_engine,'RequirementsPerTestCase');

배열에 있는 metric.Result 개체의 속성을 사용하여 메트릭 결과 데이터에 액세스합니다.

for n = 1:length(results)
    disp(['Test Case: ',results(n).Artifacts(1).Name])
    disp(['  Number of Requirements: ',num2str(results(n).Value)])
end

프로젝트의 한 단위에 대한 지표를 수집합니다. 단위를 지정하고 모델을 추적하는 아티팩트에 대해서만 메트릭을 수집합니다.

모델이 포함된 프로젝트를 엽니다. 이 예에서는 MATLAB 명령 창에 다음을 입력합니다.

openExample("slcheck/ExploreTestingMetricDataInModelTestingDashboardExample");
openProject("cc_CruiseControl");

프로젝트에 대한 metric.Engine 객체를 생성합니다.

metric_engine = metric.Engine();

metric_engine에 대한 추적 정보를 업데이트하여 아티팩트 정보가 최신인지 확인하십시오.

updateArtifacts(metric_engine)

단위 모델 db_DriverSwRequest에 대한 경로를 나타내는 변수를 만듭니다.

modelPath = fullfile(pwd, 'models', 'db_DriverSwRequest.slx');

엔진 개체에서 execute 함수를 사용하고 범위를 db_DriverSwRequest 모델로 제한하여 'RequirementsPerTestCase' 지표에 대한 결과를 수집합니다.

execute(metric_engine,'RequirementsPerTestCase',...
'ArtifactScope',{modelPath, 'db_DriverSwRequest'});

결과에 액세스하려면 getMetrics 함수를 사용하십시오.

results = getMetrics(metric_engine,'RequirementsPerTestCase');
for n = 1:length(results)
    disp(['Test Case: ',results(n).Artifacts(1).Name])
    disp(['  Number of Requirements: ',num2str(results(n).Value)])
end
Test Case: Set button
  Number of Requirements: 0
Test Case: Resume button
  Number of Requirements: 1
Test Case: Decrement button short
  Number of Requirements: 2
Test Case: Enable button
  Number of Requirements: 1
Test Case: Increment button hold
  Number of Requirements: 1
Test Case: Increment button short
  Number of Requirements: 2
Test Case: Cancel button
  Number of Requirements: 1
Test Case: Decrement button hold
  Number of Requirements: 1

입력 인수

모두 축소

메트릭 결과에 액세스하려는 메트릭 엔진 개체로, metric.Engine 개체로 지정됩니다.

수집하려는 지표에 대한 지표 식별자로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 또는 string형 배열로 지정됩니다.

getAvailableMetricIds 함수를 사용하여 사용 가능한 메트릭 식별자 목록을 반환할 수 있습니다.

메트릭 및 해당 식별자에 대한 자세한 내용은 다음을 참조하세요.

예: 'slcomp.OverallCyclomaticComplexity'

예: {'slcomp.OverallMATLABeLOC', 'slcomp.OverallSignalLines'}

예: 'TestCasesPerRequirementDistribution'

예: {'slcomp.mt.TestStatus', 'slcomp.mt.CoverageBreakdown'}

메트릭 결과를 수집하려는 프로젝트 파일의 경로와 식별자로, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. 첫 번째 항목은 프로젝트 파일의 전체 경로이고 두 번째 항목은 프로젝트 파일 내부 개체의 식별자입니다.

단위 모델의 경우 첫 번째 항목은 모델 파일의 전체 경로이고 두 번째 항목은 블록 다이어그램의 이름입니다. 이 인수를 사용하면 메트릭 엔진이 지정된 프로젝트 파일을 추적하는 아티팩트에 대한 결과를 수집합니다.

예: {'C:\work\MyModel.slx', 'MyModel'}

출력 인수

모두 축소

metric.Result 객체의 배열로 반환된 지표 결과입니다.

대체 기능

대시보드 사용자 인터페이스를 사용하여 지표 결과를 볼 수도 있습니다.

버전 내역

R2020b에 개발됨