Main Content

sim

Simulink 모델 시뮬레이션

설명

Simulink.SimulationInput 객체 구문

예제

simOut = sim(simIn)은 하나 이상의 Simulink.SimulationInput 객체에 정의된 속성에 따라 Simulink® 모델의 시뮬레이션을 한 번 또는 여러 번 실행합니다.

  • simIn이 스칼라 Simulink.SimulationInput 객체이면 simOut은 스칼라 Simulink.SimulationOutput 객체입니다.

  • simInSimulink.SimulationInput 객체로 구성된 배열이면 simOutSimulink.SimulationOutput 객체로 구성된 배열입니다.

SimulationInput 객체를 사용하여 다음과 같은 시뮬레이션의 옵션과 입력을 구성할 수 있습니다.

  • 시뮬레이션할 모델

  • 소스 변수 또는 외부 입력 데이터용 파일

  • 시뮬레이션에 사용할 블록 파라미터 값

  • 시뮬레이션에 사용할 모델 구성 파라미터 값

SimulationInput 객체의 속성이 모델이나 블록 파라미터 값을 수정하면 그 값은 시뮬레이션 중에 수정되고 시뮬레이션이 끝날 때 되돌려집니다.

SimulationInput 객체를 사용하여 프로그래밍 방식의 시뮬레이션을 구성하면 sim 함수에서 parsim 또는 batchsim과 같은 다른 함수로 쉽게 전환할 수 있습니다.

simOut = sim(simIn,Name,Value)Simulink.SimulationInput 객체인 simIn에 정의된 속성과 하나 이상의 이름-값 인수를 사용하여 지정된 추가 옵션에 따라 모델을 시뮬레이션합니다.

Simulink.SimulationInput 구문에 지원되는 이름-값 인수 목록은 Simulink.SimulationInput 객체 구문 항목을 참조하십시오.

모델 이름 구문

예제

simOut = sim(modelName)modelName에 지정된 모델을 모델의 현재 구성 파라미터 값과 블록 파라미터 값을 사용하여 시뮬레이션합니다.

simOut = sim(modelName,Name,Value)는 하나 이상의 이름-값 인수로 지정된 옵션을 사용하여 modelName이라는 모델을 시뮬레이션합니다. 예를 들어, 파라미터 이름과 값을 이름-값 인수로 지정하여 시뮬레이션의 모델 구성 파라미터 값을 수정할 수 있습니다.

sim 함수에 입력값을 제공하여 모델 구성 파라미터를 수정하면 변경 사항은 시뮬레이션 중에 적용되고 시뮬레이션이 끝날 때 되돌려집니다.

모델 이름 구문에 지원되는 이름-값 인수 목록은 모델 이름 구문 항목을 참조하십시오.

예제

simOut = sim(modelName,paramStruct)paramStruct 구조체로 지정한 모델 구성 파라미터 값을 사용하여 modelName이라는 모델을 시뮬레이션합니다.

예제

simOut = sim(modelName,configSet)configSet 구성 세트의 모델 구성 파라미터 값을 사용하는 modelName이라는 모델을 시뮬레이션합니다.

예제

모두 축소

SimulationInput 객체를 사용하여 모델의 블록 파라미터 값을 수정합니다.

모델을 엽니다.

openExample("simulink_general/sldemo_househeatExample")

이 모델의 SimulationInput 객체를 생성합니다.

mdl = "sldemo_househeat";
simIn = Simulink.SimulationInput(mdl);

Set Point 블록의 파라미터를 수정하여 온도 조절 장치의 설정점을 300으로 변경합니다.

simIn = setBlockParameter(simIn,"sldemo_househeat/Set Point",...
	"Value","300");

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

out = sim(simIn);

모델을 불러오지 않았든 혹은 모델을 불러왔는데 저장되지 않은 변경 사항이 있든 상관없이 모델 vdp를 현재 상태에서 시뮬레이션합니다.

simOut = sim("vdp");

구조체에 지정된 모델 구성 파라미터 값을 사용하여 모델 vdp를 시뮬레이션합니다.

paramStruct 구조체를 만듭니다. 모델을 구성하여 xoutNew라는 변수 이름으로 상태를 기록합니다.

paramStruct.SaveState      = 'on';
paramStruct.StateSaveName  = 'xoutNew';

모델을 구성하여 youtNew라는 변수 이름으로 출력을 기록할 수 있도록 구조체에 필드를 추가합니다.

paramStruct.SaveOutput     = 'on';
paramStruct.OutputSaveName = 'youtNew';

구조체에 지정된 옵션을 사용하여 모델을 시뮬레이션합니다.

simOut = sim('vdp',paramStruct)
simOut = 
  Simulink.SimulationOutput:

                xoutNew: [64x2 double] 
                youtNew: [64x2 double] 

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

모델 vdp를 열고 활성 구성을 위한 Simulink.ConfigSet 객체를 가져옵니다.

mdl = "vdp";
open_system(mdl)
cs = getActiveConfigSet(mdl);

Simulink.ConfigSet 객체의 복사본을 만듭니다. 그런 다음 set_param 함수를 사용하여 구성 세트의 파라미터 값을 수정합니다. ConfigSet 객체의 파라미터를 구성하여 다음과 같은 작업을 수행합니다.

  • 1e-5의 절대 허용오차 사용

  • xoutNew라는 변수 이름으로 상태 기록

  • youtNew라는 변수 이름으로 출력 기록

csNew = copy(cs);
set_param(csNew,"AbsTol","1e-5",...
         "SaveState","on","StateSaveName","xoutNew",...
         "SaveOutput","on","OutputSaveName","youtNew")

수정된 Simulink.ConfigSet 객체를 사용하여 모델을 시뮬레이션합니다.

simOut = sim(mdl,csNew)
simOut = 
  Simulink.SimulationOutput:

                xoutNew: [65x2 double] 
                youtNew: [65x2 double] 

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

입력 인수

모두 축소

시뮬레이션 구성으로, Simulink.SimulationInput 객체로 지정됩니다. SimulationInput 객체의 속성은 다음과 같은 옵션과 파라미터 값을 지정하여 시뮬레이션에서 사용합니다.

  • 시뮬레이션할 모델

  • 소스 변수 또는 외부 입력 데이터용 파일

  • 시뮬레이션에 사용할 블록 파라미터 값

  • 시뮬레이션에 사용할 모델 구성 파라미터 값

SimulationInput 객체의 속성에 정의된 값은 시뮬레이션을 위해 모델에 적용되고 시뮬레이션이 끝날 때 되돌려집니다.

시뮬레이션할 모델로, string형 또는 문자형 벡터로 지정됩니다.

예: simOut = sim("vdp")는 현재 모델에 구성된 파라미터 값을 사용하여 모델 vdp를 시뮬레이션합니다.

데이터형: char | string

시뮬레이션할 모델 구성으로, 구조체로 지정됩니다. 구조체의 필드는 모델 구성 파라미터의 이름입니다. 각 필드의 값은 시뮬레이션에서 사용할 파라미터 값을 나타냅니다. 예를 들어, 시작 시간 5에서 중지 시간 10까지 모델을 시뮬레이션하려면 다음과 같은 구조체를 만듭니다.

paramStruct.StartTime = "5";
paramStruct.StopTime = "10";

데이터형: struct

시뮬레이션할 모델 구성으로, Simulink.ConfigSet 객체로 지정됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: simOut = sim(simIn,"UseFastRestart","on")Simulink.SimulationInput 객체로 구성된 배열을 사용하는 시뮬레이션 세트를 빠른 재시작을 사용하여 실행합니다.

예: simOut = sim(modelName,"Solver","ode15s","StopTime","30")은 중지 시간이 30인 ode15s 솔버를 사용하도록 modelName이라는 모델의 시뮬레이션을 구성합니다.

sim 함수는 첫 번째 입력을 Simulink.SimulationInput 객체로 지정하든지 또는 시뮬레이션할 모델 이름으로 지정하든지에 따라 다른 이름-값 인수를 지원합니다. 이 페이지에 나열된 인수 외에도 sim 함수의 입력값을 사용하여 모델 구성 파라미터의 값을 지정할 수 있습니다.

  • 첫 번째 입력 인수가 Simulink.SimulationInput 객체이면 setModelParameter 함수를 사용하여 입력 객체에 시뮬레이션용 모델 파라미터 값을 구성합니다.

  • 첫 번째 입력 인수가 모델 이름이면 모델 구성 파라미터를 이름-값 인수로 지정합니다.

Simulink.SimulationInput 객체 구문

모두 축소

빠른 재시작 활성화 옵션으로, 'off' 또는 'on'으로 지정됩니다. 빠른 재시작은 가능한 경우 컴파일과 종료 단계를 건너뛰어 시뮬레이션 세트를 실행하는 데 드는 시간을 줄입니다. 동일한 모델에 대해 여러 시뮬레이션을 실행하는 경우 빠른 재시작을 사용해 보십시오.

자세한 내용은 How Fast Restart Improves Iterative Simulations 항목을 참조하십시오.

이 인수는 sim 함수의 첫 번째 입력 인수를 Simulink.SimulationInput 객체로 지정하는 경우에만 지원됩니다.

예: sim(simIn,"UseFastRestart","on")

데이터형: char | string

오류 발생 시 시뮬레이션을 시작했던 프로세스를 중지하는 옵션으로, 'off' 또는 'on'으로 지정됩니다.

  • 'off' — 시뮬레이션에서 오류가 발생하면 해당 시뮬레이션은 중지되고 시뮬레이션을 시작한 프로세스는 계속 진행됩니다. 예를 들어, Simulink.SimulationInput 객체로 구성된 배열을 사용하는 시뮬레이션 세트를 실행하는 경우 첫 번째 시뮬레이션에서 오류가 발생하면 해당 시뮬레이션은 중지되고 후속 시뮬레이션은 계속 실행됩니다.

  • 'on' — 시뮬레이션에서 오류가 발생하면 해당 시뮬레이션과 시뮬레이션을 시작한 프로세스가 모두 중지됩니다. 예를 들어, Simulink.SimulationInput 객체로 구성된 배열을 사용하는 시뮬레이션 세트를 실행하는 경우 첫 번째 시뮬레이션에서 오류가 발생하면 해당 시뮬레이션은 중지되고 후속 시뮬레이션은 실행되지 않습니다.

이 인수는 sim 함수의 첫 번째 입력 인수를 Simulink.SimulationInput 객체로 지정하는 경우에만 지원됩니다.

예: sim(simIn,"StopOnError","on")

  • sim 함수의 첫 번째 입력 인수로 모델 이름을 지정하면 CaptureErrors 이름-값 인수를 사용하여 이 동작을 구성합니다.

  • 오류가 발생해도 시뮬레이션을 시작한 프로세스를 중지하지 않도록 하면 Simulink.SimulationOutput 객체와 Simulink.SimulationMetadata 객체에 오류 메시지 정보가 캡처됩니다.

    • 이 메시지를 보려면 SimulationOutput 객체의 ErrorMessage 속성을 사용하십시오.

    • 오류에 관한 자세한 내용을 알아보려면 Simulink.SimulationMetadata 객체의 ExecutionInfo 속성을 사용하십시오. ErrorDiagnostic 필드에는 오류가 발생한 시뮬레이션 단계 등 오류에 관한 내용이 포함됩니다.

데이터형: char | string

시뮬레이션 진행률을 나타내는 옵션으로, 'off' 또는 'on'으로 지정됩니다.

  • 'off' — 진행률 메시지를 표시하지 않고 시뮬레이션이 실행됩니다.

  • 'on' — 시뮬레이션 진행률에 따라 진행률 업데이트가 표시됩니다.

    이 옵션은 Simulink.SimulationInput 객체로 구성된 배열을 사용하여 여러 시뮬레이션을 실행할 때 유용합니다.

    이 인수는 sim 함수의 첫 번째 입력 인수를 Simulink.SimulationInput 객체로 지정하는 경우에만 지원됩니다.

예: sim(simIn,"ShowProgress","on")

시뮬레이션 관리자를 여는 옵션으로, 'off' 또는 'on'으로 지정됩니다. 실행한 시뮬레이션의 진행률을 시뮬레이션 관리자를 사용하여 모니터링할 수 있습니다. Simulink.SimulationInput 객체로 구성된 배열을 사용하여 여러 시뮬레이션을 실행할 때 시뮬레이션 관리자를 사용해 보십시오.

이 인수는 sim 함수의 첫 번째 입력 인수를 Simulink.SimulationInput 객체로 지정하는 경우에만 지원됩니다.

예: sim(simIn,"ShowSimulationManager","on")

모델 이름 구문

모두 축소

오류 발생 시 시뮬레이션을 시작한 프로세스를 계속 진행하는 옵션으로, 'off' 또는 'on'으로 지정됩니다. 기본적으로 sim 함수를 사용하여 시뮬레이션을 실행하고 모델의 이름을 첫 번째 입력으로 지정하면 다음과 같이 작동합니다.

  • MATLAB® 명령 창에 오류가 보고됩니다.

  • 오류 발생 시 시뮬레이션과 시뮬레이션을 호출한 프로세스 모두 중지됩니다.

  • 오류 메시지가 Simulink.SimulationOutput 객체 또는 Simulink.SimulationMetadata 객체에 캡처되지 않습니다.

CaptureErrors'on'으로 지정하면 오류는 시뮬레이션 출력에만 보고됩니다. 오류가 발생한 시뮬레이션은 실행이 중지되지만, 중지된 시뮬레이션이 다른 프로세스에서 호출한 시뮬레이션이었다면 해당 프로세스는 계속 진행됩니다. 예를 들어, 루프에서 여러 시뮬레이션을 실행하는 경우 CaptureErrors'on'으로 지정하면 후속 시뮬레이션은 오류가 발생한 시뮬레이션 다음에 계속 실행됩니다.

이 인수는 sim 함수의 첫 번째 입력 인수를 시뮬레이션할 모델의 이름으로 지정하는 경우에만 지원됩니다.

예: sim("myModel","CaptureErrors","on")

  • 이 옵션은 SIL(Software-in-the-Loop) 시뮬레이션과 PIL(Processor-in-the-Loop) 시뮬레이션에서는 지원되지 않습니다.

  • sim 함수의 입력으로 하나 이상의 Simulink.SimulationInput 객체를 지정한다면 StopOnError 이름-값 인수를 사용하여 이 동작을 구성해 보십시오.

  • CaptureErrors'on'으로 지정하면 Simulink.SimulationOutput 객체와 Simulink.SimulationMetadata 객체에 오류 메시지 정보가 캡처됩니다.

    • 이 메시지를 보려면 SimulationOutput 객체의 ErrorMessage 속성을 사용하십시오.

    • 오류에 관한 자세한 내용을 알아보려면 Simulink.SimulationMetadata 객체의 ExecutionInfo 속성을 사용하십시오. ErrorDiagnostic 필드에는 오류가 발생한 시뮬레이션 단계 등 오류에 관한 내용이 포함됩니다.

데이터형: char | string

디버그 모드에서 시뮬레이션을 시작하는 옵션으로, 'off' 또는 'on'으로 지정됩니다.

이 인수는 sim 함수의 첫 번째 입력 인수를 시뮬레이션할 모델의 이름으로 지정하는 경우에만 지원됩니다.

예: sim("modelName","Debug","on")

데이터형: char | string

고속 액셀러레이터 타깃의 재빌드를 비활성화하는 옵션으로, 'on' 또는 'off'로 지정됩니다. 이 인수를 'on'으로 지정하면 고속 액셀러레이터 타깃을 재빌드하는 데 필요한 변경 사항이 무시됩니다. 이 옵션을 사용하면 고속 액셀러레이터 타깃을 재빌드하는 데 필요하지 않은 옵션만 수정할 수 있습니다.

이 인수는 sim 함수의 첫 번째 입력 인수를 시뮬레이션할 모델의 이름으로 지정하는 경우에만 지원됩니다.

예: sim("modelName","RapidAcceleratorUpToDateCheck","off")

Simulink.SimulationInput 객체를 사용하여 구성된 시뮬레이션에 이 옵션을 지정하려면 setModelParameter 함수를 사용하십시오.

simIn = Simulink.SimulationInput("myModel");
simIn = setModelParameter(simIn,"RapidAcceleratorUpToDateCheck","off");

데이터형: char | string

최대 시뮬레이션 실행 시간으로, 양의 스칼라로 지정됩니다. 시뮬레이션 실행을 허용할 시간을 초 단위로 지정하십시오. 시뮬레이션이 지정한 값보다 오래 실행되면 소프트웨어에서 경고가 발생하고 시뮬레이션이 중지됩니다. 예를 들어, TimeOut30으로 지정한 경우 시뮬레이션 결과를 계산하는 데 30초 넘게 소요되면 소프트웨어에서 시뮬레이션을 중지하고 경고를 발생시킵니다.

TimeOut 파라미터는 시뮬레이션 실행에 소요되는 클록 시간에 대한 제한값을 지정합니다. 시뮬레이션할 최대 시간 값을 지정하려면 중지 시간 파라미터를 사용하십시오.

이 인수는 sim 함수의 첫 번째 입력 인수를 시뮬레이션할 모델의 이름으로 지정하는 경우에만 지원됩니다.

예: sim("modelName","TimeOut",60)은 최대 60초 동안 실행되는 시뮬레이션을 구성합니다.

Simulink.SimulationInput 객체를 사용하여 구성된 시뮬레이션에 이 옵션을 지정하려면 setModelParameter 함수를 사용하십시오.

simIn = Simulink.SimulationInput("modelName");
simIn = setModelParameter(simIn,"TimeOut",60);

시뮬레이션 전에 파라미터 요약을 표시하는 옵션으로, 'siminfo'로 지정됩니다.

이 인수는 sim 함수의 첫 번째 입력 인수를 시뮬레이션할 모델의 이름으로 지정하는 경우에만 지원됩니다.

예: sim("modelName","Trace","siminfo")

데이터형: char | string

출력 인수

모두 축소

시뮬레이션 출력으로, Simulink.SimulationOutput 객체, Simulink.SimulationOutput 객체로 구성된 배열 또는 벡터로 반환됩니다. Simulink.SimulationOutput 객체에는 시뮬레이션에서 기록된 모든 데이터와 시뮬레이션에 관한 메타데이터(예: 시간 설정 정보 및 진단)가 포함됩니다.

입력 인수로 모델 이름만 지정했고 시뮬레이션할 모델의 단일 시뮬레이션 출력 파라미터가 비활성화되어 있다면 sim 함수의 출력은 시뮬레이션 시간으로 구성된 벡터입니다. 다른 구문과 일관된 형식으로 결과를 반환하는 sim 함수의 경우 활성화된 단일 시뮬레이션 출력 파라미터를 사용하여 모델을 저장합니다.

  • 지정한 입력 인수와 관계없이 sim 함수가 동일한 형식으로 결과를 반환하도록 하려면 단일 시뮬레이션 출력 파라미터를 활성화하고 모델을 저장하십시오. 이 옵션이 활성화되면 시뮬레이션 결과는 기록된 모든 데이터 및 시뮬레이션 메타데이터(예: 시간 설정 정보 및 진단)가 포함된 Simulink.SimulationOutput으로 반환됩니다. 모든 시뮬레이션 데이터와 메타데이터가 단일 객체에 저장되어 있으면 여러 시뮬레이션의 결과를 분석하는 것이 더 쉽습니다.

  • 모델 구성 파라미터의 목록을 가져오려면 getActiveConfigSet 함수와 get_param 함수를 사용하십시오. 예를 들어, 모델 vdp의 구성 파라미터를 보려면 MATLAB 명령 창에 다음 명령을 입력합니다.

    configSet = getActiveConfigSet("vdp");
    configSetNames = get_param(configSet,"ObjectParameters")

    get_param 함수의 반환값은 StopTime, SaveTime, SaveState, SaveOutput, SignalLogging과 같은 모델 구성 파라미터를 나열합니다.

  • 모델 계층 구조를 시뮬레이션하는 경우 sim 함수에 입력 인수로 지정한 모델 구성 파라미터는 최상위 모델에 적용됩니다.

  • sim 함수를 사용하여 시뮬레이션을 실행하면 오류가 발생하거나 시뮬레이션이 지정된 중지 시간에 도달할 때까지 실행됩니다. 프로그래밍 방식으로 일시 중지하고 계속 실행할 수 있는 대화형 방식의 시뮬레이션을 프로그래밍 방식으로 실행하려면 set_param 함수에 SimulationCommand 입력 인수를 사용하십시오. 자세한 내용은 프로그래밍 방식으로 시뮬레이션 실행하기 항목을 참조하십시오.

  • 중지 시간을 무한대로 설정하여 모델을 시뮬레이션할 때 시뮬레이션을 중지하려면 MATLAB 명령 창에서 Ctrl+C를 눌러야 합니다. 그러면 시뮬레이션이 중단되고 시뮬레이션 결과는 MATLAB 작업 공간에 저장되지 않습니다.

  • 구성 파라미터 대화 상자를 사용하여 시간, 상태, 출력 기록을 구성합니다. 모델링 탭의 설정 아래에서 모델 설정을 클릭합니다. 그런 다음, 구성 파라미터 대화 상자에서 데이터 가져오기/내보내기를 선택합니다.

  • 모델을 통해 신호를 기록하려면, 신호 기록 또는 To Workspace 블록이나 Record, XY Graph 블록과 같은 기록 블록을 사용하십시오. 신호 기록에 대한 자세한 내용은 Export Signal Data Using Signal Logging 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

모두 확장