Simulink.sdi.createRun

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

Синтаксис

runID = Simulink.sdi.createRun
runID = Simulink.sdi.createRun(runName)
runID = Simulink.sdi.createRun(var)
runID = Simulink.sdi.createRun(runName,'vars',var,var2,...,varn)
runID = Simulink.sdi.createRun(runName,'namevalue',sourceNames,sigValues)
runID = Simulink.sdi.createRun(runName,'file',filename)
[runID,runIndex] = Simulink.sdi.createRun(___)
[runID,runIndex,signalIDs] = 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 выполнения, индекс выполнения в Инспекторе Данных моделирования и идентификаторы сигнала для сигналов в выполнении.

Примеры

свернуть все

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

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

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

% 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';

% Create Dataset workspace data
sinusoids_ds = Simulink.SimulationData.Dataset;
sinusoids_ds = sinusoids_ds.add(cos_ts);
sinusoids_ds = sinusoids_ds.add(sine_ts);

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

doubSinusoids_ds = Simulink.SimulationData.Dataset;
doubSinusoids_ds = doubSinusoids_ds.add(doubSine);
doubSinusoids_ds = doubSinusoids_ds.add(doubCos);

% Save workspace data to a MAT-file
save sinusoids.mat sine_ts cos_ts

Создайте выполнение с объектом выполнения

Можно создать объект выполнения использование объекта Simulink.sdi.Run метод create и затем добавить данные в выполнение с помощью метода add. Метод add поддерживает всю загрузку и журналирование форматов данных.

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

% Add timeseries data to run
sinusoidsRun.add('vars',sine_ts,cos_ts);

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

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

runID = Simulink.sdi.createRun(sine_ts);

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

С этим синтаксисом можно создать пустое выполнение и задать его имя. Затем можно использовать возвращенный runID, чтобы добавить данные в выполнение.

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

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

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

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

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

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

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

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

Можно создать выполнение в Инспекторе Данных моделирования непосредственно из файла данных с помощью синтаксиса 'file'.

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

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

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

Simulink.sdi.view

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

Сгенерируйте данные для выполнения

В данном примере создайте данные о 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
ans =

    'Cosine, T=8'

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

свернуть все

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

Пример: '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