Simulink.SimulationOutput

이 예제의 모델은 다양한 기록 방법을 사용하여 데이터를 기록합니다.

이 모델은 시간 데이터를 기록하도록 구성되어 있기도 합니다.

모델을 엽니다.

mdl = "LoggingBlocks_NotSSO";
open_system(mdl)

sim(mdl)

recordout

recordout = 
Simulink.SimulationData.Dataset 'Run 1: LoggingBlocks_NotSSO' with 3 elements

                         Name         PropagatedName  BlockPath                   
                         ___________  ______________  ___________________________ 
    1  [1x1 Signal]      Big Sine     Big Sine        LoggingBlocks_NotSSO/Record
    2  [1x1 Signal]      Chirp        Chirp           LoggingBlocks_NotSSO/Record
    3  [1x1 Signal]      Square Wave  Square Wave     LoggingBlocks_NotSSO/Record

  - Use braces { } to access, modify, or add elements using index.

set_param(mdl,"ReturnWorkspaceOutputs","on")

clear

mdl = "LoggingBlocks_NotSSO";
out = sim(mdl);

out

out = 
  Simulink.SimulationOutput:
              ScopeData: [1x1 Simulink.SimulationData.Dataset] 
                logsout: [1x1 Simulink.SimulationData.Dataset] 
              recordout: [1x1 Simulink.SimulationData.Dataset] 
                 simout: [1x1 timeseries] 
                   tout: [51x1 double] 
                   yout: [1x1 Simulink.SimulationData.Dataset] 

     SimulationMetadata: [1x1 Simulink.SimulationMetadata] 
           ErrorMessage: [0x0 char] 

out.recordout

ans = 
Simulink.SimulationData.Dataset 'Run 2: LoggingBlocks_NotSSO' with 3 elements

                         Name         PropagatedName  BlockPath                   
                         ___________  ______________  ___________________________ 
    1  [1x1 Signal]      Big Sine     Big Sine        LoggingBlocks_NotSSO/Record
    2  [1x1 Signal]      Chirp        Chirp           LoggingBlocks_NotSSO/Record
    3  [1x1 Signal]      Square Wave  Square Wave     LoggingBlocks_NotSSO/Record

  - Use braces { } to access, modify, or add elements using index.

out.recordout{1}

ans = 
  Simulink.SimulationData.Signal
  Package: Simulink.SimulationData

  Properties:
              Name: 'Big Sine'
    PropagatedName: 'Big Sine'
         BlockPath: [1x1 Simulink.SimulationData.BlockPath]
          PortType: 'outport'
         PortIndex: 1
            Values: [1x1 timeseries]

out.recordout{1}.Values

  timeseries

  Common Properties:
            Name: 'Big Sine'
            Time: [51x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [51x1 double]
        DataInfo: tsdata.datametadata

out.recordout{1}.Values.Data

ans = 51×1

         0
    0.3973
    0.7788
    1.1293
    1.4347
    1.6829
    1.8641
    1.9709
    1.9991
    1.9477
      ⋮

시뮬레이션 결과를 단일 객체로 반환하는 방식으로 모델을 시뮬레이션하는 경우, Simulink.SimulationOutput 객체를 사용하여 모든 기록된 데이터와 시뮬레이션 메타데이터에 액세스합니다.

이 예제의 모델은 단일 시뮬레이션 출력 파라미터가 활성화되어 있고 여러 다양한 기록 방법을 사용하여 데이터를 기록합니다.

이 모델은 시간 데이터를 기록하도록 구성되어 있기도 합니다.

모델을 엽니다.

mdl = "LoggingBlocks";
open_system(mdl)

Simulink.SimulationInput 객체를 만들어 모델의 시뮬레이션을 구성합니다. setModelParameter 함수를 사용하여 StopTime 파라미터를 20으로 설정합니다.

simIn = Simulink.SimulationInput(mdl);
simIn = setModelParameter(simIn,'StopTime','20');

모델을 시뮬레이션합니다. sim 함수의 출력 out은 Simulink.SimulationOutput 객체로, 이 객체에는 시뮬레이션에서 기록된 모든 데이터가 포함됩니다. 각 블록의 데이터와 각 기록 유형은 속성으로 저장되며 이 속성은 블록이나 모델에 지정된 기록 변수 이름과 일치합니다.

out = sim(simIn);

점 표기법, get 함수 또는 find 함수를 사용하여 기록된 데이터에 액세스할 수 있습니다.

점 표기법을 사용하여 To Workspace 블록을 통해 기록된 Big Sine 신호에 액세스합니다.

simout = out.simout

  timeseries

  Common Properties:
            Name: 'Big Sine'
            Time: [51x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [51x1 double]
        DataInfo: tsdata.datametadata

get 함수를 사용하여 신호 기록으로 기록된 Sine 신호에 액세스합니다.

logsout = get(out,"logsout")

logsout = 
Simulink.SimulationData.Dataset 'logsout' with 1 element

                         Name  BlockPath               
                         ____  _______________________ 
    1  [1x1 Signal]      Sine  LoggingBlocks/Sine Wave

  - Use braces { } to access, modify, or add elements using index.

find 함수를 사용하여 출력 기록으로 기록된 Square Wave 신호에 액세스합니다.

yout = find(out,"yout")

yout = 
Simulink.SimulationData.Dataset 'yout' with 1 element

                         Name         BlockPath             
                         ___________  _____________________ 
    1  [1x1 Signal]      Square Wave  LoggingBlocks/Outport

  - Use braces { } to access, modify, or add elements using index.

점 표기법이나 getSimulationMetadata 함수를 사용하여 시뮬레이션 메타데이터에 액세스할 수 있습니다.

simMetadata = getSimulationMetadata(out)

simMetadata = 
  SimulationMetadata with properties:

        ModelInfo: [1x1 struct]
       TimingInfo: [1x1 struct]
    ExecutionInfo: [1x1 struct]
       UserString: ''
         UserData: []

시뮬레이션 메타데이터는 Simulink.SimulationMetadata 객체로 반환됩니다. SimulationMetadata 객체는 구조체 값을 갖는 속성으로 시뮬레이션 정보를 그룹화하고 문자열과 시뮬레이션에 관계된 추가 데이터를 지정할 수 있는 속성을 포함합니다.

SimulationMetadata 객체의 ExecutionInfo 속성에 액세스합니다. 실행 정보에는 경고나 오류 없이 중지 시간 20으로 실행되는 시뮬레이션이 표시됩니다.

simMetadata.ExecutionInfo

ans = struct with fields:
               StopEvent: 'ReachedStopTime'
         StopEventSource: []
    StopEventDescription: 'Reached stop time of 20'
         ErrorDiagnostic: []
      WarningDiagnostics: [0x1 struct]

Simulink.SimulationOutput 객체는 시뮬레이션 결과를 나타냅니다. SimulationOutput 객체에는 시뮬레이션 메타데이터와 시뮬레이션에서 기록된 모든 데이터가 포함됩니다. 데이터 기록 및 사용자 지정 속성을 추가하거나 제거하여 Simulink.SimulationOutput 객체의 내용을 수정할 수 있습니다.

모델 LoggingBlocks를 엽니다. 이 모델은 여러 기록 기법을 사용하여 몇 가지 입력 신호를 기록합니다.

이 모델은 시간 데이터를 기록하도록 구성되어 있기도 합니다.

mdl = "LoggingBlocks"

mdl = 
"LoggingBlocks"

open_system(mdl);

get_param 함수를 사용하여 Sine Wave 블록의 진폭 파라미터와 주파수 파라미터의 값을 저장합니다. 이 값을 sinConfig 구조체에 저장합니다.

sinConfig.sinAmp = get_param(strcat(mdl,"/Sine Wave"),"Amplitude");
sinConfig.sinFreq = get_param(strcat(mdl,"/Sine Wave"),"Frequency");

모델을 시뮬레이션합니다.

simOut = sim(mdl);

시뮬레이션 결과에는 시뮬레이션에서 생성된 모든 기록 변수가 포함됩니다. who 함수를 사용하여 수정할 수 있는 속성 목록을 가져옵니다.

props = who(simOut)

props = 5x1 cell
    {'logsout'  }
    {'recordout'}
    {'simout'   }
    {'tout'     }
    {'yout'     }

이 시뮬레이션의 경우 Sine Wave 블록과 관계된 신호 경로의 데이터만 저장하기를 원한다고 가정하겠습니다. removeProperty 함수를 사용하여 recordout 속성과 yout 속성을 제거합니다.

simOut = removeProperty(simOut,["recordout" "yout"]);
who(simOut)

This Simulink.SimulationOutput object contains these editable properties:

    logsout    simout    tout    

Simulink.SimulationOutput 객체에 자체 속성을 추가하거나 setUserData 함수를 사용하는 방식으로 객체에 데이터를 추가하여 Simulink.SimulationMetadata 객체에 UserData 속성 값을 지정할 수도 있습니다.

Sine Wave 블록의 파라미터 값을 Simulink.SimulationOutput 객체의 속성으로 저장하기를 원한다고 가정하겠습니다. 구조체에 필드를 추가하는 것과 같은 방법으로 점 표기법을 사용하여 SineWaveParameters 속성을 추가합니다.

simOut.SineWaveParameters = sinConfig;
who(simOut)

This Simulink.SimulationOutput object contains these editable properties:

    SineWaveParameters    logsout    simout    tout    

sldiagviewer.reportSimulationMetadataDiagnostics 함수를 사용하여 진단 뷰어로 Simulink.SimulationOutput 객체에 캡처된 오류 메시지와 경고 메시지를 표시할 수 있습니다.

모델 ex_sldemo_bounce를 엽니다.

model = "ex_sldemo_bounce";
open_system(model)

정의되지 않은 변수 z로 Initial Velocity 블록의 값 파라미터를 지정하여 모델에 오류를 저장합니다.

set_param("ex_sldemo_bounce/Initial Velocity","Value","z");

Simulink.SimulationInput 객체를 생성하여 시뮬레이션을 구성합니다.

simIn = Simulink.SimulationInput(model);

모델을 시뮬레이션합니다. StopOnError 옵션을 off로 지정하면 시뮬레이션 중에 발생하는 오류와 경고가 SimulationOutput 객체에 캡처되고 명령 창이나 스크립트에 보고되지 않으며 스크립트 처리가 중단되지 않습니다.

simOut = sim(simIn,"StopOnError","off","ShowProgress","off");

sldiagviewer.reportSimulationMetadataDiagnostics 함수를 사용하여 시뮬레이션에서 발생한 경고와 오류 메시지를 진단 뷰어에 표시합니다.

sldiagviewer.reportSimulationMetadataDiagnostics(simOut)