Simulink.sdi.createRun

Создайте запуск в Инспекторе Данных моделирования

Описание

пример

runID = Simulink.sdi.createRun создает пустой, запуск без имени в Инспекторе Данных моделирования репозиторий и возвращает ID запуска. Можно использовать Simulink.sdi.getRun получить Simulink.sdi.Run объект для запуска, который позволяет вам добавлять метаданные и сигналы к запуску.

пример

runID = Simulink.sdi.createRun(runName) создает пустой запуск под названием runName.

пример

runID = Simulink.sdi.createRun(var) создает запуск под названием var содержа данные в переменной var рабочей области.

пример

runID = Simulink.sdi.createRun(runName,'vars',var,var2,...,varn) создает запуск под названием runName содержа данные из одной или нескольких переменных в базовом рабочем пространстве. Сигналы в запуске берут свои имена из имен переменных.

пример

runID = Simulink.sdi.createRun(runName,'namevalue',sourceNames,sigValues) создает запуск под названием runName с данными в массиве ячеек sigValues. Массив ячеек sourceNames задает имена, чтобы использовать в качестве источника для sigValues данные.

пример

runID = Simulink.sdi.createRun(runName,'file',filename) создает запуск с данными из MAT, CSV, MDF или файла Microsoft® Excel®, заданного filename.

[runID,runIndex] = Simulink.sdi.createRun(___) возвращает ID запуска и индекс запуска для запуска, созданного в Инспекторе Данных моделирования репозиторий.

[runID,runIndex,signalIDs] = Simulink.sdi.createRun(___) возвращает ID запуска, индекс запуска в Инспекторе Данных моделирования и идентификаторы сигнала для сигналов в запуске.

Примеры

свернуть все

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

Создайте данные

Создайте данные в рабочей области. Инспектор Данных моделирования поддерживает данные временных рядов во многих форматах. Этот пример создает данные с помощью timeseries и Simulink.SimulationData.Dataset форматы и сохраняют данные в MAT-файле.

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

time = 0:0.2:20;

sine_vals = sin(2*pi/5*time);
sine_ts = timeseries(sine_vals,time);
sine_ts.Name = 'Sine, T=5';

cos_vals = cos(2*pi/8*time);
cos_ts = timeseries(cos_vals,time);
cos_ts.Name = 'Cosine, T=8';

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

sinusoids_ds = Simulink.SimulationData.Dataset;
sinusoids_ds = addElement(sinusoids_ds,cos_ts);
sinusoids_ds = addElement(sinusoids_ds,sine_ts);

Масштабируйте каждый сигнал фактором 2 и создайте Dataset объект содержать данные сигнала для результатов.

doubSine = 2*sine_ts;
doubCos = 2*cos_ts;

doubSinusoids_ds = Simulink.SimulationData.Dataset;
doubSinusoids_ds = addElement(doubSinusoids_ds,doubSine);
doubSinusoids_ds = addElement(doubSinusoids_ds,doubCos);

Наконец, сохраните timeseries данные к MAT-файлу.

save sinusoids.mat sine_ts cos_ts

Откройте инспектора данных моделирования

Откройте Инспектора Данных моделирования, таким образом, вы видите запуски, которые вы создаете в каждом разделе.

Simulink.sdi.view

Создайте запуск Используя Simulink.sdi.Run Объект

Можно импортировать данные в запуск в Инспекторе Данных моделирования путем создания пустого запуска и затем добавления данных в запуск из рабочей области или файла. В зависимости от вашей задачи можно использовать Simulink.sdi.Run.create функционируйте или Simulink.sdi.createRun функция, чтобы создать пустой запуск. Simulink.sdi.Run.create функция возвращает Simulink.sdi.Run объект для нового запуска и Simulink.sdi.createRun функция возвращает ID запуска для нового запуска.

Этот пример создает пустой запуск с помощью Simulink.sdi.Run.create функционируйте, дает запуску понятное имя и описание, и затем добавляет синус и косинус timeseries данные с помощью add функция.

sinusoidsRun = Simulink.sdi.Run.create;
sinusoidsRun.Name = 'Sinusoids';
sinusoidsRun.Description = 'Sine and cosine signals of different frequencies';

add(sinusoidsRun,'vars',sine_ts,cos_ts)

Этот пример использует Simulink.sdi.createRun функция, чтобы создать новый запуск в Инспекторе Данных моделирования под названием My Waves и затем использует Simulink.sdi.addToRun функция, чтобы добавить синус и косинус timeseries данные к запуску.

runID = Simulink.sdi.createRun('My Waves');
signalID = Simulink.sdi.addToRun(runID,'vars',sine_ts,cos_ts);

Создайте запуск из переменной рабочей области

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

Когда вы используете этот синтаксис, чтобы создать запуск из одной переменной рабочей области, запуск берет то же имя, как объект раньше создавал его.

runID = Simulink.sdi.createRun(sine_ts);

Simulink.sdi.createRun функция возвращает ID запуска для запуска, который это создает. Можно использовать Simulink.sdi.getRun функционируйте, чтобы получить доступ к Run объект для запуска.

sineRun = Simulink.sdi.getRun(runID);
sineRun.Name
ans = 
'Sine, T=5'

Создайте запуск из нескольких переменных рабочей области

Когда ваши данные существуют в нескольких переменных в вашей рабочей области, можно использовать Simulink.sdi.createRun функция с vars опция, чтобы импортировать данные от нескольких переменных в один запуск в Инспекторе Данных моделирования. Можно также использовать этот синтаксис, чтобы создать запуск для одной переменной, которая использует имя, которое вы задаете.

Этот пример создает запуск под названием My Sinusoids это содержит данные для синуса и косинуса timeseries объекты.

runID = Simulink.sdi.createRun('My Sinusoids','vars',sine_ts,cos_ts);

Создайте запуск и задайте исходные имена

Можно использовать namevalue опция Simulink.sdi.createRun функция, чтобы создать запуск и задать имена для сигналов в запуске. Этот синтаксис может быть особенно полезным, когда вы импортируете отдельные листовые сигналы из иерархических данных.

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

runID = Simulink.sdi.createRun('Waves','namevalue',{'Sinusoids',...
    'BigSinusoids'},{sinusoids_ds,doubSinusoids_ds});

Создайте запуск из данных в файле

Можно также использовать Simulink.sdi.createRun функция, чтобы импортировать данные в Инспектора Данных моделирования из файла. Используйте file опция, чтобы импортировать данные в simusoids.mat файл.

runID = Simulink.sdi.createRun('Wave Data','file','sinusoids.mat');

В этом примере показано, как получить доступ к данным сигнала, когда вы создаете запуск в Инспекторе Данных моделирования.

Сгенерируйте данные для запуска

В данном примере создайте данные о timeseries для сигналов косинуса и синуса.

% Create timeseries workspace data
time = linspace(0, 20, 101);

sine_vals = sin(2*pi/5*time);
sine_ts = timeseries(sine_vals,time);
sine_ts.Name = 'Sine, T=5';

cos_vals = cos(2*pi/8*time);
cos_ts = timeseries(cos_vals,time);
cos_ts.Name = 'Cosine, T=8';

Создайте запуск и возвратите идентификаторы сигнала

Можно использовать Simulink.sdi.createRun синтаксис с несколькими возвращаемыми аргументами, чтобы получить идентификаторы сигнала более непосредственно вместо того, чтобы получить доступ к идентификаторам сигнала через Simulink.sdi.Run объект.

[runID,runIndex,sigIDs] = Simulink.sdi.createRun('Sinusoids','vars',...
    sine_ts,cos_ts);

cosID = sigIDs(2);
cosSig = Simulink.sdi.getSignal(cosID);

Измените свойства сигнала и представление в инспекторе данных моделирования

Можно использовать Simulink.sdi.Signal возразите, чтобы просмотреть и изменить свойства сигнала и построить сигналы в Инспекторе Данных моделирования.

cosSig.Checked = true;
cosSig.AbsTol = 0.05;
Simulink.sdi.view
cosSig.Name

Входные параметры

свернуть все

Назовите для запуска в Инспекторе Данных моделирования.

Пример: 'Baseline Simulation'

Переменная в базовом рабочем пространстве, содержащем данные, вы хотите создать запуск для в Инспекторе Данных моделирования. Инспектор Данных моделирования требует связанного временного вектора для ваших данных. Simulink.sdi.createRun поддержки вся загрузка и логгирование форматов данных, включая timeseries и Simulink.SimulationData.Dataset.

Обеспечьте один var аргумент, когда var единственный аргумент и один или несколько var аргументы, когда вы задаете 'vars' для второго аргумента.

Пример: myData

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

Пример: {'sig1','sig2'}

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

Пример: {var1,var2}

Имя файла файла, содержащего ваши данные о запуске. Обеспечьте filename введите, когда вы зададите 'file' для второго аргумента. Можно создать запуск из MAT, CSV или файла Microsoft Excel. Можно также создать запуск из MDF-файла с mdf, mf4, mf3, данные или расширение dat-файла.

Пример: 'simulation.mat'

Выходные аргументы

свернуть все

Запустите идентификатор для нового запуска.

Индекс нового запуска в Инспекторе Данных моделирования репозиторий.

Вектор, содержащий идентификаторы сигнала для сигналов в запуске.

Представленный в R2011b