Документация

Список, разделенный запятыми

При указании Dataset данные, укажите только один Dataset для параметра Input. Не включайте его в список, разделенный запятыми.

Каждая переменная или выражение должна вычисляться для соответствующего объекта, соответствующего определенному входному порту корневого уровня в модели. Каждая переменная или выражение в списке должны вычисляться до соответствующего объекта, соответствующего одному из входных портов корневого уровня модели. Первый элемент соответствует первому входному порту корневого уровня, второй - второму входному порту корневого уровня и т.д. Размеры каждого образца данных должны соответствовать размерам данных, указанным в параметре входного блока.

Для блока Enable или Trigger сигнал, управляющий портом enable или trigger, должен быть последним элементом в списке, разделенном запятыми. При наличии порта enable и trigger укажите:

Используйте пустую матрицу для задания значений заземления для порта. Например, для загрузки данных для входных портов in1 и in3и использовать значения земли для порта in2введите в поле Input (Ввод) следующее:

in1, [], in3

Элементы набора данных

A Dataset объект может включать элементы с различными типами данных.

Для отдельных данных сигналов, не относящихся к шине, можно указать эти типы данных для Dataset элементы:

Для сигналов шины используйте структуру с элементом данных для каждого листового сигнала, используя один из следующих форматов:

Создание объекта набора данных для блоков ввода

Для создания Simulink.SimulationData.Dataset из блоков Inport корневого уровня в модели, можно использовать createInputDataset функция. Сигналы в сгенерированном наборе данных имеют свойства блоков Inport и соответствующие значения земли в момент начала и окончания модели. Можно создавать timeseries и timetableобъекты для времени и значения для сигналов для загрузки. Другие сигналы используют наземные значения. Каждый timetable объект должен содержать данные только для одного сигнала.

Можно загрузить данные входного порта корневого уровня, указанные в MATLAB timeseries объект, находящийся в рабочей области.

Измерение времени

При создании MATLAB timeseries объект для импорта данных в Simulink, измерение времени (количество отсчетов времени) зависит от измерения и типа данных сигнала.

t = (0:10)';
ts = timeseries(sin(t), t);

t = 0;
ts = timeseries([1 2; 3 4], t);

'InterpretSingleRowDataAs3D', true

t = 0;
ts = timeseries([1 2], t, 'InterpretSingleRowDataAs3D', true);

Данные перечисления

При указании enum в timetable очистите параметр Interpolate data для соответствующего блока Inport.

Структуры данных

Данные входного порта корневого уровня можно загрузить из рабочей области в виде структуры, имя которой указано в параметре «Параметры конфигурации» > «Импорт/экспорт данных» > «Ввод». Сведения об определении структур MATLAB см. в разделе Структурные массивы.

Можно указать структуры для модели в целом или для каждого порта. Сведения об указании структур для каждого порта для параметра «Input» см. в разделе Структуры для всех портов или для каждого порта.

Структура всегда включает подструктуру сигналов, которая содержит поле значений и поле измерений. В зависимости от задачи моделирования, которую требуется выполнить, структура может также включать поле времени. Форма используемой структуры зависит от типа сигналов, для которых импортируются данные:

Примеры импорта данных для дискретных и непрерывных сигналов см. в:

Структуры для всех портов или для каждого порта

Можно указать одну структуру, чтобы обеспечить ввод для всех портов ввода на корневом уровне в модели, или можно указать отдельную структуру для каждого порта.

Формат структуры для каждого порта состоит из отдельной структуры с временем или структуры без времени для каждого порта. Структура входных данных для каждой имеет только одну signals поле. Чтобы задать этот параметр, введите имена структур в текстовом поле «Ввод» в виде списка, разделенного запятыми. in1, in2,..., inN. Стоимость in1 - данные для первого входного порта в модели, in2 для второго входного порта и т.д.

Чтобы указать одну структуру для всех портов:

Указание временных данных

В качестве части импортируемой структуры данных можно указать вектор времени двойников. Например, укажите вектор времени при импорте данных сигнала для представления непрерывного производства или создания тестового случая. Чтобы проверить дискретный алгоритм, используйте структуру с пустым вектором времени. В этой таблице представлены дополнительные рекомендации по определению значений времени на основе типа загружаемых данных сигнала.

timeVector = timeStep * [startTime:numSteps-1]' 

T1 = 0.2 * [0:49]' 

timeVector = [startTime:timeStep:endTime]' 

T2 = [0:0.2:10]' 

Примеры указания сигнала и временных данных

В первом примере рассмотрим следующую модель, которая имеет один входной порт:

В качестве другого примера рассмотрим модель с двумя входами.

Предположим, что вы хотите ввести синусоидальную волну в первый порт и косинусоидальную волну во второй порт. Определите структуру, a, в рабочей области MATLAB:

a.time = 0.1*[0:1]';
a.signals(1).values = sin(a.time);
a.signals(1).dimensions = 1;
a.signals(2).values = cos(a.time);
a.signals(2).dimensions = 1;

Введите имя структуры (a) в окне «Параметры конфигурации» > «Импорт/экспорт данных» > «Параметры ввода».

Укажите входное выражение

Входное выражение по умолчанию для модели: [t,u] и формат ввода по умолчанию: Array. При определении t и u в рабочей области MATLAB просто выберите Параметры конфигурации (Configuration Parameters) > Импорт/экспорт данных (Data Import/Export) > Входной параметр (Input) для ввода данных из рабочей области модели.

Предположим, что имеется модель с двумя блоками ввода:

Определение t и u в рабочей области MATLAB:

numSteps = 9;
timeStep = 0.1;
t = (timeStep*(0:numSteps))';
u = [sin(t),cos(t),4*cos(t)];

При выполнении моделирования данные сигнала sin(t) и cos(t) присвоены In1 и данные сигнала 4*cos(t) присвоен In2. Данные сигнала вводятся в течение 100 моментов времени.

Массивы для входных портов, управляющие функциональными подсистемами вызовов

Можно использовать массив для управления подсистемой вызова функций через входной порт корневого уровня. Можно использовать массив или массив, являющийся элементом Dataset объект. Массив должен быть nx1 массив. Для блока ввода корневого уровня выберите параметр Output function call.

Например, это Dataset объект имеет элемент массива x:

ds = Simulink.SimulationData.Dataset;
x = [1 3 7 8]';
ds = ds.addElement(x,'theElementName');

В этой модели используется ds набор данных в разделе Параметры конфигурации > Импорт/экспорт данных > Параметр ввода.

При моделировании модели значения времени регистрируемых сигнальных данных в подсистеме Function-Call показывают, что подсистема Function-Call была запущена только для времени, указанного в массиве, хранящемся в ds.

>> logsout{1}.Values.Time

ans =

     1
     3
     7
     8

Укажите входное выражение

Выражение времени MATLAB можно использовать для загрузки данных из рабочей области в порт ввода корневого уровня. Чтобы использовать временное выражение, введите выражение в виде строки (заключенной в одинарные кавычки) в поле Ввод (Input) панели Импорт/экспорт данных (Data Import/Export). Временным выражением может быть любое выражение MATLAB, которое вычисляет вектор строки, равный по длине количеству сигналов, поступающих во входные порты модели. Предположим, что модель имеет один вектор Inport, который принимает два сигнала. Также предположим, что timefcn - определяемая пользователем функция, возвращающая вектор строки длиной в два элемента. Вот допустимые выражения времени ввода для такой модели:

'[3*sin(t), cos(2*t)]' 

'4*timefcn(w*t)+7'

Выражение вычисляется на каждом этапе моделирования, применяя результирующие значения к входным портам модели. Simulink определяет переменную t при выполнении моделирования. Кроме того, можно опустить переменную времени в выражениях для функций одной переменной. Например, выражение sin интерпретируется как sin(t).