Main Content

입력

최상위 입력 포트를 사용하여 시뮬레이션을 위한 외부 입력 데이터를 불러오는 옵션

모델 구성 창: 데이터 가져오기/내보내기

설명

입력 파라미터는 최상위 입력 포트를 위한 외부 입력 데이터를 불러올지 여부를 지정합니다. 입력 파라미터를 선택할 때 각 최상위 입력 포트에 불러올 외부 입력 데이터도 지정해야 합니다.

모델 계층 구조를 시뮬레이션하는 경우 최상위 모델의 입력 포트만 작업 공간에서 데이터를 불러옵니다. 참조된 모델을 최상위 모델로 시뮬레이션하는 경우를 제외하고 참조된 모델의 입력 파라미터 값은 무시됩니다. 최상위 모델로 시뮬레이션되지 않은 참조된 모델에 데이터를 불러오려면 Inport 블록이나 In Bus Element 블록이 아닌 다른 불러오기 블록(예: From Workspace 블록)을 사용하십시오.

자세한 내용은 Load Data to Root-Level Input Ports 항목을 참조하십시오.

설정

off (디폴트 값) | on
off

기본적으로 입력 파라미터는 비활성화되어 있습니다. 모델에 최상위 입력 포트가 없는 경우 이 파라미터를 비활성화된 상태로 두십시오.

on

모델에 최상위 입력 포트가 있는 경우 입력 파라미터를 선택하여 시뮬레이션 중에 각 포트에 볼러올 입력 데이터를 지정합니다. 텍스트 상자에서, 불러올 외부 입력 데이터를 모든 최상위 입력 포트에 대한 데이터가 포함된 MATLAB® 변수로 지정하거나 각 항목에 최상위 입력 포트에 대한 데이터가 포함된 쉼표로 구분된 목록으로 지정합니다. 여러 형식을 사용하여 모든 최상위 입력 포트에 대한 데이터를 표현하고 각각의 최상위 입력 포트에 대한 데이터를 표현할 수 있습니다. 모든 데이터 형식에 대해 다음을 충족해야 합니다.

  • 시간 값은 double 데이터형을 가지고 단조 증가해야 합니다.

  • 시간 및 신호 데이터는 Inf 값 또는 NaN 값을 포함해서는 안 됩니다.

다음 표에는 모든 최상위 입력 포트에 대한 데이터를 포함하는 하나의 변수로 입력 파라미터의 값을 지정하는 데 지원되는 데이터 형식이 요약되어 있습니다.

형식설명팁 및 고려 사항

Simulink.SimulationData.Dataset

Dataset 객체의 각 요소는 최상위 입력 포트에 대한 데이터를 포함합니다.

  • Dataset 객체는 스칼라 신호, 벡터 신호, 다차원 신호와 버스 및 버스로 구성된 배열을 생성하는 최상위 포트에 대한 데이터를 포함할 수 있습니다.

  • 각 최상위 입력 포트의 요소를 포함하는 Dataset 객체를 만들려면 createInputDataset 함수를 사용하십시오.

  • 데이터셋은 출력, 상태, 신호 기록을 비롯한 대부분의 기록 유형에 대한 디폴트 형식입니다.

Simulink.SimulationData.DatasetRef

DatasetRef 객체는 MAT 파일에 저장된 Dataset 객체를 참조합니다. DatasetRef 객체에서 참조하는 Dataset 객체의 각 요소는 최상위 입력 포트에 대한 데이터를 포함합니다.

시뮬레이션은 시뮬레이션 시작 시 모든 데이터를 메모리로 불러오지 않고 DatasetRef 객체에서 참조하는 데이터를 단계적으로 불러옵니다. 대량의 데이터를 불러와야 하는 경우 DatasetRef 객체를 사용해 보십시오. 자세한 내용은 다음 항목을 참조하십시오.

구조체

다음 필드를 포함하는 구조체:

  • signals — 각 구조체에 최상위 입력 포트에 대한 데이터가 포함된 구조체 배열

  • time — 모든 최상위 입력 포트의 신호 값에 대응하는 시간 값으로 구성된 배열(선택 사항)

  • 이 형식은 버스 또는 버스로 구성된 배열에 대한 입력 데이터를 지원하지 않습니다.

  • 이산 입력 신호에 대한 데이터만 불러오는 경우 time 필드를 생략해 보십시오. 자세한 내용은 Control How Models Load Input Data 항목을 참조하십시오.

  • 균일한 간격의 시간 벡터를 만들려면 원하는 개수만큼의 시간 스텝이 포함된 정수 벡터를 만든 다음 샘플 시간만큼 벡터의 값을 스케일링합니다.

    time = sampleTime*(0:numSteps);

    linspace와 같은 다른 옵션을 사용하면 부동정밀도 반올림으로 인해 데이터 불일치가 발생할 수 있습니다.

배열

배열의 첫 번째 열은 시간 값을 포함하며, 이러한 값은 단조 증가해야 합니다. 그 이후의 열은 각 최상위 입력 포트에 대한 데이터를 포트 번호에 따라 순차적으로 포함합니다.

  • 배열 형식은 실수형 스칼라 신호와 폭이 넓은 실수 신호 또는 벡터 신호 불러오기만 지원합니다.

  • 배열의 값은 double 데이터형을 가져야 합니다.

  • 모델에 최상위 Trigger 블록이 있는 경우 마지막 열에 트리거 신호에 대한 데이터를 지정합니다.

불러올 데이터를 단일 변수로 지정할지 쉼표로 구분된 목록으로 지정할지 선택하는 것 외에도 각 포트에 대한 입력 데이터를 나타내는 방법도 선택해야 합니다. 지원되는 형식은 입력 파라미터 값을 지정하는 방법과 포트에서 생성되는 출력 유형에 따라 다릅니다. 다음 표에는 최상위 입력 포트가 모델에서 생성하는 출력 유형을 기반으로 이 포트에 대한 데이터를 지정하는 데 사용할 수 있는 형식이 요약되어 있습니다.

출력 유형지원되는 입력 데이터 형식입력 파라미터의 지원되는 값팁 및 고려 사항

스칼라 또는 벡터 신호

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 구조체

  • 배열

  • 쉼표로 구분된 목록

  • 스칼라 및 벡터 신호의 경우, 신호 데이터의 행 개수가 시간 벡터의 행 개수와 일치해야 합니다.

  • timetable을 생성하려면 시간 값이 duration형 벡터여야 합니다.

    시뮬레이션 시간은 항상 초 단위를 사용합니다. 초 이외의 단위를 사용하는 duration형 벡터를 만들면 시뮬레이션에 사용할 수 있도록 값이 초로 변환됩니다.

  • 배열 형식은 복소수이거나 double 이외의 데이터형을 갖는 신호 값을 지원하지 않습니다.

다차원 신호

  • timeseries 객체

  • 단일 열을 포함하는 timetable

  • Simulink.SimulationData.Signal 객체

  • matlab.io.datastore.SimulationDatastore 객체

  • 구조체 또는 시간값을 갖는 구조체 기록 형식과 일치하는 필드와 계층 구조를 가진 구조체

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 구조체

  • 쉼표로 구분된 목록

  • 2차원 이상의 값을 가진 다차원 신호에서 마지막 차원의 길이는 시간 벡터의 길이와 일치해야 합니다.

    예를 들어, 2×2 행렬 신호 샘플 10개의 입력 데이터에는 10개 행을 포함하는 시간 벡터와 2×2×10 차원을 갖는 신호 값으로 구성된 배열이 있습니다.

  • timetable을 생성하려면 시간 값이 duration형 벡터여야 합니다.

    시뮬레이션 시간은 항상 초 단위를 사용합니다. 초 이외의 단위를 사용하는 duration형 벡터를 만들면 시뮬레이션에 사용할 수 있도록 값이 초로 변환됩니다.

가변 크기 신호

구조체 또는 시간값을 갖는 구조체 기록 형식과 일치하는 필드와 계층 구조를 가진 구조체

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 구조체

  • 쉼표로 구분된 목록

From Workspace 블록을 사용하여 불러올 수 있는 형식으로 가변 크기 신호를 기록하려면 신호를 최상위 Outport 블록에 연결하고 모델에 대한 형식 구성 파라미터를 구조체 또는 시간값을 갖는 구조체로 설정하십시오.

버스

timetable, timeseries 또는 matlab.io.datastore.SimulationDatastore 객체를 포함하는 구조체:

  • 버스를 정의하는 Simulink.Bus 객체로 출력 데이터형 파라미터를 지정합니다.

  • 구조체의 계층 구조와 필드 이름은 버스의 계층 구조 및 요소 이름과 일치해야 합니다.

  • 각 timetable 또는 timeseries 객체는 버스의 리프 신호에 대한 데이터를 포함합니다.

  • 각 timetable에는 열이 하나만 있어야 합니다.

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 쉼표로 구분된 목록

버스에 대한 입력 데이터를 부분적으로 지정하려면 입력 데이터 구조체에서 데이터를 불러올 필요가 없는 버스 요소를 []로 설정하십시오.

버스로 구성된 배열구조체로 구성된 배열로서, 각각의 구조체는 이 버스 배열에 속한 하나의 버스에 대한 데이터를 나타냄

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 쉼표로 구분된 목록

버스로 구성된 배열에 대한 입력 데이터를 부분적으로 지정하려면 해당 버스에 대한 데이터를 나타내는 구조체에서 데이터를 불러올 필요가 없는 버스 요소를 []로 설정하십시오.

함수 호출 신호

각 함수 호출 이벤트의 시간을 지정하는 n×1 열 벡터

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 구조체

  • 쉼표로 구분된 목록

최상위 Inport 블록을 구성하여 함수 호출 신호를 생성하려면 블록에 대해 함수 호출 출력 파라미터를 선택하십시오.

접지

[]

  • Simulink.SimulationData.Dataset 객체

  • Simulink.SimulationData.DatasetRef 객체

  • 구조체

  • 쉼표로 구분된 목록

입력 포트에 대한 외부 입력 데이터를 불러오지 않으려면 해당 포트에 대한 데이터를 []로 지정하십시오. 입력 포트는 시뮬레이션 중에 모델의 접지 값을 생성합니다.

팁

  • 루트 인포트 매퍼를 사용하면 최상위 Inport 블록 또는 최상위 In Bus Element 블록이 여러 개 있는 모델에서 최상위 입력 포트에 입력 데이터를 쉽게 매핑할 수 있습니다. 루트 인포트 매퍼를 열려면 입력 연결을 클릭하십시오.

  • 데이터 사전을 사용하여 최상위 입력 포트에 대한 외부 입력 데이터를 저장할 수는 없습니다. 입력 파라미터는 사용자가 입력 데이터에 대해 지정한 값의 연결을 맺을 때 데이터 사전을 포함하지 않습니다. 모델이 데이터 사전을 사용하고 있고 사용자가 기본 작업 공간에 대한 액세스를 비활성화했더라도 입력 파라미터는 여전히 기본 작업 공간에 있는 시뮬레이션 입력 데이터에 액세스합니다. 기호의 연결을 맺는 방법에 대한 자세한 내용은 Symbol Resolution 항목을 참조하십시오.

  • 최상위 모델의 Inport 블록은 블록 파라미터 값에 따라 입력 데이터 값을 보간 및 외삽합니다.

  • 최상위 모델의 In Bus Element 블록은 항상 입력 데이터 값을 선형으로 보간 및 외삽합니다.

권장 설정

다음 표에는 코드 생성과 관련된 고려 사항을 기반으로 이 파라미터에 대한 권장 값이 요약되어 있습니다.

응용 사례설정
디버그영향 없음
추적성영향 없음
효율성권장 설정 없음
안전 예방 조치권장 설정 없음

프로그래밍 방식의 사용법

파라미터: LoadExternalInput
값: 'on' | 'off'
디폴트 값: 'off'
파라미터: ExternalInput
유형: string형 | 문자형 벡터
값: Simulink.SimulationData.Dataset 객체 | Simulink.SimulationData.DatasetRef 객체 | 구조체 | 배열 | 시간 표현식 | 각 항목이 최상위 입력 포트에 대한 데이터를 포함하는 쉼표로 구분된 목록
디폴트 값: '[t,u]'

버전 내역

R2006a 이전에 개발됨

참고 항목

툴

블록

함수

도움말 항목