Simulink.SimulationInput

Simulink.SimulationInput 객체를 생성해 모델을 변경하여 다중 시뮬레이션 또는 개별 시뮬레이션 실행

설명

Simulink.SimulationInput 객체를 사용하면 모델을 변경하고 그러한 변경이 적용된 상태로 시뮬레이션을 실행할 수 있습니다. 이러한 변경 사항은 일시적으로 모델에 적용됩니다. Simulink.SimulationInput 객체를 사용하여 초기 상태, 모델 파라미터, 블록 파라미터, 외부 입력 및 변수를 변경할 수 있습니다. Simulink.SimulationInput 객체를 통해, setPreSimFcn 함수와 setPostSimFcn 함수를 사용하여 각 시뮬레이션의 시작과 끝에 실행할 MATLAB^® 함수를 지정할 수도 있습니다.

생성

구문

simIn = Simulink.SimulationInput(mdlName)

설명

simIn = Simulink.SimulationInput(mdlName)은 Simulink.SimulationInput 객체를 생성해 mdlName으로 지정된 모델의 시뮬레이션을 구성합니다.

입력 인수

mdlName — 모델 이름

string형 | 문자형 벡터

모델 이름으로, string형 또는 문자형 벡터로 지정됩니다. 모델 이름을 지정할 때는 .slx 확장자를 포함하지 마십시오.

속성

ModelName — 모델의 이름

문자형 벡터

SimulationInput 객체가 생성되는 모델의 이름입니다.

InitialState — 초기 상태

Simulink.op.ModelOperatingPoint 객체

시뮬레이션할 모델의 초기 상태로, Simulink.op.ModelOperatingPoint 객체로 지정됩니다.

ExternalInput — 외부 입력

Simulink.SimulationData.Dataset 객체 | timeseries 객체 | 숫자형 배열

시뮬레이션할 모델에 추가되는 외부 입력입니다.

BlockParameters — 블록 파라미터

Simulink.Simulation.BlockParameter 객체로 구성된 배열

모델의 블록 파라미터 중 수정되는 파라미터입니다.

Variables — 변수

Simulink.Simulation.Variable 객체로 구성된 배열

모델 변수 중 수정되는 변수입니다.

ModelParameters — 모델 파라미터

Simulink.Simulation.ModelParameter 객체로 구성된 배열

모델의 모델 파라미터 중 수정되는 파라미터입니다.

PreSimFcn — 사전 시뮬레이션 함수

MATLAB 함수

시뮬레이션 시작 전에 실행할 MATLAB 함수입니다.

PostSimFcn — 사후 시뮬레이션 함수

MATLAB 함수

각 시뮬레이션 후에 실행할 MATLAB 함수입니다.

UserString — 사용자 문자열

문자형 배열 | string형

시뮬레이션에 대한 간단한 설명으로, 문자형 배열 또는 string형으로 지정됩니다.

VariantConfiguration — Variant 구성의 이름

string형 | 문자형 벡터

R2024a 이후

시뮬레이션을 실행하기 전에 모델에 적용할 Variant 구성의 이름으로, string형 또는 문자형 벡터로 지정됩니다.

이 속성은 Variant 블록 및 Variant 파라미터와 같은 Variant 요소를 사용하고 Variant Manager for Simulink^®를 사용하여 모델에 대해 생성된 Variant 구성을 갖는 모델에 적용할 수 있습니다. 이러한 모델의 경우 시뮬레이션을 실행하기 전에 모델 계층 구조 전체에 걸쳐 특정 Variant 경로를 활성화할 수 있는 Variant 구성을 지정할 수 있습니다.

예제는 Run Simulations for Variant Models Using Variant Configurations 항목을 참조하십시오.

예: "LinInterExpNoNoise"

데이터형: char | string

객체 함수

applyToModel	Apply configuration in SimulationIntput object to model
getVariantConfiguration	Get name of variant configuration from SimulationInput object
loadVariablesFromExternalSource	Load variables from a custom file into Simulink.SimulationInput object
loadVariablesFromMATFile	Load variables from MAT file into Simulink.SimulationInput object
removeVariable	Remove variable from SimulationInput or Simulation object
setBlockParameter	Set block parameter values for simulation using SimulationInput or Simulation object
setExternalInput	Specify external input data for top-level input ports using SimulationInput or Simulation object
setInitialState	Specify initial state for simulation using SimulationInput or Simulation object
setPostSimFcn	Set MATLAB function to run after each simulation
setPreSimFcn	Specify MATLAB function to run before start of each simulation on Simulink.SimulationInput object
setModelParameter	Set model parameter values for simulation using SimulationInput or Simulation object
setVariable	SimulationInput 또는 Simulation 객체를 사용하는 시뮬레이션에 대한 변수 값 설정
setVariantConfiguration	Set variant configuration for simulation using SimulationInput object
showContents	View summary of specification in SimulationInput or Simulation object
validate	Validate contents of SimulationInput object

예제

Simulink.SimulationInput 객체 생성하기

SimulationInput 객체를 생성해 모델 sldemo_househeat의 시뮬레이션을 구성합니다.

모델을 엽니다.

openExample("simulink_general/sldemo_househeatExample") 

모델에 사용할 단일 SimulationInput 객체를 생성합니다.

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

Simulink.SimulationInput 객체로 구성된 배열 생성하기

이 예제에서는 SimulationInput 객체로 구성된 배열을 생성해 모델 vdp의 여러 시뮬레이션을 구성하는 방법을 보여줍니다.

모델을 엽니다.

openExample("simulink_general/VanDerPolOscillator")

for 루프를 사용하여 SimulationInput 객체로 구성된 배열을 만듭니다.

mdl = "vdp";
simIn(1:10) = Simulink.SimulationInput(mdl);

Simulink.SimulationInput 객체를 사용하여 블록 파라미터 값 설정하기

Simulink.SimulationInput 객체를 사용하여 모델 sldemo_househeat의 시뮬레이션을 위한 블록 파라미터 값을 수정합니다.

모델을 엽니다.

openExample("sldemo_househeat")

모델에 대한 SimulationInput 객체로 구성된 배열을 만듭니다.

mdl = "sldemo_househeat";
simIn(1:10) = Simulink.SimulationInput(mdl);

setBlockParameter 함수를 사용하여 Set Point라는 블록에 대한 값 파라미터를 지정합니다.

for i = 1:10
simIn(i) = simIn(i).setBlockParameter('ex_sldemo_househeat/Set Point', ...
	'Value',num2str(rand()*10+70));
end

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

out = sim(simIn);

Simulink.SimulationInput 객체에 외부 입력으로 Dataset 사용하기

이 예제에서는 Dataset 객체를 사용하여 Simulink.SimulationInput 객체에 외부 입력을 설정하는 방법을 보여줍니다.

모델을 엽니다.

mdl = 'sldemo_mdlref_counter';
open_system(mdl);

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

t = (0:0.01:10)';
ds = Simulink.SimulationData.Dataset;
ds = setElement(ds,1,timeseries(5*ones(size(t)),t));
ds = setElement(ds,2,timeseries(10*sin(t),t));
ds = setElement(ds,3,timeseries(-5*ones(size(t)),t));

Simulink.SimulationInput 객체를 생성하고 외부 입력을 설정합니다.

simIn = Simulink.SimulationInput('sldemo_mdlref_counter');
simIn = setExternalInput(simIn,ds);

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

out = parsim(simIn);

버전 내역

R2017a에 개발됨

R2024a: Variant 구성을 위한 새로운 속성 및 함수가 추가됨

Variant 모델의 경우 시뮬레이션을 실행하기 전에 VariantConfiguration 속성을 사용하여 모델에 적용할 Variant 구성을 지정할 수 있습니다. 속성값을 설정하려면 setVariantConfiguration 함수를 사용하십시오.

참고 항목

함수

• sim | parsim | batchsim

툴

• 시뮬레이션 관리자

객체

• Simulink.SimulationOutput

도움말 항목

• Running Multiple Simulations
• Run Parallel Simulations for a Thermal Model of a House Using parsim