Simulink.sdi.constraints.MatchesSignal 클래스
패키지: Simulink.sdi.constraints
슈퍼클래스: matlab.unittest.constraints.Constraint
시뮬레이션 데이터 인스펙터를 사용하여 시계열 데이터를 허용오차와 비교하는 제약 조건
설명
테스트의 일환으로 시계열 데이터를 예상 값과 비교하려면 Simulink.sdi.constraints.MatchesSignal 제약 조건을 사용하십시오. 이 비교에 절대, 상대 및 시간 허용오차 값의 조합을 사용하도록 제약 조건을 구성할 수 있습니다. Simulink.sdi.constraints.MatchesSignalOptions 객체 또는 하나 이상의 이름-값 쌍 인수를 사용하여 비교 동작을 구성하기 위한 추가 옵션을 지정할 수도 있습니다. 허용오차 및 정렬 옵션이 비교에 미치는 영향에 대한 자세한 내용은 How the Simulation Data Inspector Compares Data 항목을 참조하십시오.
참고
MatchesSignal 제약 조건은 시뮬레이션 데이터 인스펙터를 사용하여 비교를 수행하며 다음 제품 중 하나에 대한 라이선스가 필요합니다.
Simulink®
Signal Processing Toolbox™
MATLAB® Coder™
Fixed-Point Designer™
속성
예제
시계열 비교를 위한 테스트 만들기
이 예제에서는 Simulink.sdi.constraints.MatchesSignal 제약 조건을 사용하여 작업 공간에서 생성된 데이터를 사용하는 시계열 데이터를 비교하는 방법을 보여줍니다. MatchesSignal 제약 조건을 사용하여 파일의 측정된 테스트 데이터와 기록된 시뮬레이션 출력값을 포함하여 여러 소스의 데이터를 비교할 수 있습니다.
MatchesSignal 제약 조건을 사용하면 비교에 사용할 절대, 상대 및 시간 허용오차를 지정할 수 있습니다. MatchesSignal 제약 조건은 정렬 및 동기화 단계를 포함하는 시뮬레이션 데이터 인스펙터 비교 알고리즘을 사용합니다. 알고리즘에 대한 자세한 내용은 How the Simulation Data Inspector Compares Data 항목을 참조하십시오.
MatchesSignal 제약 조건은 시계열 비교를 위해 시뮬레이션 데이터 인스펙터를 사용하며 다음 제품 중 하나가 필요합니다.
Simulink®
Signal Processing Toolbox™
MATLAB Coder™
Fixed-Point Designer™
시계열 데이터 만들기
이 예제에서는 설명을 도울 목적으로만 timeseries 형식의 작업 공간 데이터를 생성합니다. MatchesSignal 제약 조건을 사용하여 시뮬레이션 출력값 또는 테스트 데이터가 포함된 파일과 같은 다른 소스에서 온 데이터를 비교할 수 있으며, 제약 조건은 시뮬레이션 데이터 인스펙터에서 지원하는 모든 형식의 시계열 데이터를 비교할 수 있습니다.
이 예제에서, 첫 번째 신호는 이름이 Wave Data인 사인파에 대한 데이터를 포함하는 timeseries 객체입니다.
time = 0:0.1:20;
sig1vals = sin(2*pi/5*time);
sig1_ts = timeseries(sig1vals,time);
sig1_ts.Name = 'Wave Data';두 번째 신호도 동일한 주파수의 사인파이며, 약간의 감쇠가 있고 다른 레이트로 샘플링됩니다. MatchesSignal 제약 조건에 대한 비교 알고리즘에는 동기화 단계가 포함되어 있으므로 서로 다른 시간 벡터를 갖는 이 두 신호를 비교해도 항상 테스트 실패가 발생하는 것은 아닙니다. 두 번째 신호는 또한 정렬 알고리즘이 비교를 위해 신호를 짝지을 수 있도록 Wave Data로 이름이 지정됩니다.
time2 = 0:0.05:20;
sig2vals = 0.98*sin(2*pi/5*time2);
sig2_ts = timeseries(sig2vals,time2);
sig2_ts.Name = 'Wave Data';테스트 케이스 만들기 및 신호 비교하기
이 예제에서는 설명을 돕고자 대화형 방식 테스트를 사용합니다. MATLAB 테스트 프레임워크에서 다른 유형의 단위 테스트와 함께 MatchesSignal 제약 조건을 사용할 수 있습니다. 예를 들어, 클래스 기반 단위 테스트를 작성하려면 클래스를 사용하여 간단한 테스트 케이스 작성하기 항목을 참조하십시오.
대화형 방식 사용을 위해 TestCase 인스턴스를 만듭니다.
import matlab.unittest.TestCase
testCase = TestCase.forInteractiveUse;MatchesSignal 제약 조건을 사용하여 sig1_ts와 sig2_ts를 비교합니다. MatchesSignal 제약 조건의 인스턴스에서 예상 값으로 sig1_ts를 사용합니다.
import Simulink.sdi.constraints.MatchesSignal
testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts));Verification failed.
---------------------
Framework Diagnostic:
---------------------
MatchesSignal(<Value>) failed.
--> The following aligned signals did not match:
Name ActualSignals ExpectedSignals
_________ _____________ _______________
Wave Data <Actual>.Data <Expected>.Data
Comparison results have been saved to:
--> /tmp/Bdoc22b_2023970_1699775/comparisonResults_c19195b5-6ddb-4314-93fd-3507120c6415.mldatx
------------------
Stack Information:
------------------
In /tmp/Bdoc22b_2023970_1699775/tpf5d1f190/simulink-ex22803619/TestTimeSeriesDataWithTimeToleranceExample.mlx (TestTimeSeriesDataWithTimeToleranceExample) at 14
In /mathworks/devel/bat/Bdoc22b/build/matlab/toolbox/matlab/codetools/embeddedoutputs/+matlab/+internal/+editor/evaluateRegions.p (evaluateRegions) at 0
In /mathworks/devel/bat/Bdoc22b/build/matlab/toolbox/matlab/codetools/embeddedoutputs/+matlab/+internal/+editor/EvaluationOutputsService.p (EvaluationOutputsService.evalRegions) at 0
In /mathworks/devel/bat/Bdoc22b/build/matlab/toolbox/matlab/codetools/+matlab/+internal/+liveeditor/@LiveEditorUtilities/execute.m (execute) at 68
In /mathworks/devel/bat/Bdoc22b/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (doRun) at 402
In /mathworks/devel/bat/Bdoc22b/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (doRunConvert) at 343
In /mathworks/devel/bat/Bdoc22b/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (liveCodeToDocbook) at 165
In /mathworks/devel/bat/Bdoc22b/build/matlab/tools/build_using_matlab/BML.m (BML) at 13
진단 정보에 검증이 실패했다고 표시됩니다. 테스트가 실패하면 비교 결과와 원본 실행 데이터가 시뮬레이션 데이터 인스펙터 세션 파일에 저장됩니다. MLDATX 파일 링크를 클릭하여 시뮬레이션 데이터 인스펙터에서 세션을 엽니다. 여기서 테스트로 비교한 데이터와 비교 결과를 조사할 수 있습니다. 결과를 살펴보면 감쇠로 인해 차이가 발생하고 비교가 실패하는 것을 볼 수 있습니다.
비교에 사용할 MatchesSignal 제약 조건의 인스턴스에 대해 절대 허용오차를 0.02로 지정합니다.
testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02));Verification passed.
MatchesSignal 제약 조건 동작 구성하기
이 예제에서는 Simulink.sdi.constraints.MatchesSignalOptions 객체를 사용하여 Simulink.sdi.constraints.MatchesSignal 제약 조건의 비교 동작을 구성하는 방법을 보여줍니다. MatchesSignalOptions 객체를 사용하여 MatchesSignal 인스턴스를 생성할 때 단일 이름-값 쌍 입력으로 여러 비교 속성을 구성할 수 있습니다.
시계열 데이터 만들기
이 예제에서는 설명을 도울 목적으로만 사용할 작업 공간 데이터를 만듭니다. MatchesSignal 제약 조건을 사용하여 시뮬레이션 출력값 또는 테스트 데이터가 포함된 파일과 같은 다른 소스에서 온 데이터를 비교할 수 있으며, 제약 조건은 시뮬레이션 데이터 인스펙터에서 지원하는 모든 형식의 시계열 데이터를 비교할 수 있습니다.
이 예제에서, 첫 번째 신호는 사인파에 대한 데이터를 포함하며 이름이 Wave Data인 timeseries 객체입니다.
time = 0:0.1:20;
sig1vals = sin(2*pi/5*time);
sig1_ts = timeseries(sig1vals,time);
sig1_ts.Name = 'Wave Data';두 번째 신호도 동일한 주파수의 사인파이며, 약간의 감쇠가 있고 다른 레이트로 샘플링됩니다. MatchesSignal 제약 조건에 대한 비교 알고리즘에는 동기화 단계가 포함되어 있으므로 서로 다른 시간 벡터를 갖는 이 두 신호를 비교해도 반드시 테스트 실패가 발생하는 것은 아닙니다. 두 번째 신호는 single 데이터형으로 형변환되고 또한 정렬 알고리즘이 비교를 위해 신호를 짝지을 수 있도록 Wave Data로 이름이 지정됩니다.
time2 = 0:0.1:22;
sig2vals = single(0.98*sin(2*pi/5*time2));
sig2_ts = timeseries(sig2vals,time2);
sig2_ts.Name = 'Wave Data';MatchesSignal 인스턴스 구성하기 및 데이터 비교하기
MatchesSignalOptions 객체를 사용하여 MatchesSignal 제약 조건의 인스턴스가 일치하지 않는 데이터형과 같은 조건을 처리하는 방법과 실제 데이터 세트와 예상 데이터 세트 간에 신호가 정렬되는 방법을 지정할 수 있습니다. 작성하려는 테스트에 맞게 MatchesSignalOptions 객체의 속성을 지정할 수 있습니다. 예를 들어, 테스트에서 다양한 유형의 데이터를 비교하고 데이터형 일치가 기능적으로 관련이 없는 경우 IgnoreDataTypes 속성을 true로 설정할 수 있습니다.
MatchesSignalOptions 객체를 만들어 실제 신호와 예상 신호가 공유하는 시간 구간을 벗어난 데이터형 불일치 및 데이터 샘플을 무시하는 MatchesSignal 인스턴스를 만듭니다.
import Simulink.sdi.constraints.MatchesSignalOptions opts = MatchesSignalOptions('IgnoringDataTypes',true,'IgnoringExtraData',true);
대화형 방식 사용을 위한 TestCase 인스턴스를 만들고 MatchesSignal 제약 조건, MatchesSignalOptions 객체 및 0.02의 절대 허용오차를 사용하여 sig1_ts와 sig2_ts를 비교합니다.
import matlab.unittest.TestCase testCase = TestCase.forInteractiveUse; import Simulink.sdi.constraints.MatchesSignal testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02,'WithOptions',opts))
Verification passed.
테스트가 통과합니다. MatchesSignalOptions 객체로 정의된 옵션 없이 동일한 테스트를 다시 실행하면 데이터형 불일치로 인해 테스트가 실패합니다.
testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02))Verification failed.
---------------------
Framework Diagnostic:
---------------------
MatchesSignal(<Value>,'AbsTol',0.02) failed.
--> Data types do not match for the following aligned signals:
Name ActualSignals ActualDataType ExpectedSignals ExpectedDataType
___________ _______________ ______________ _________________ ________________
"Wave Data" "<Actual>.Data" {'single'} "<Expected>.Data" {'double'}
------------------
Stack Information:
------------------
In C:\Users\snadeau\AppData\Local\Temp\Editor_oxzoe\LiveEditorEvaluationHelperE1184446395.m (LiveEditorEvaluationHelperE1184446395) at 16
In E:\jobarchive\Bdoc20b\2020_06_06_h12m11s21_job1400967_pass\matlab\toolbox\matlab\codetools\embeddedoutputs\+matlab\+internal\+editor\evaluateRegions.p (evaluateRegions) at 0
In E:\jobarchive\Bdoc20b\2020_06_06_h12m11s21_job1400967_pass\matlab\toolbox\matlab\codetools\embeddedoutputs\+matlab\+internal\+editor\EvaluationOutputsService.p (EvaluationOutputsService.evalRegions) at 0
버전 내역
R2019a에 개발됨
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)