Simulink.sdi.Run.create

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

Описание

пример

runObj = Simulink.sdi.Run.create создает пустой Simulink.sdi.Run объект, runObj. Можно добавить сигналы к Run объект с использованием add функцию или Simulink.sdi.addToRun функция.

пример

runObj = Simulink.sdi.Run.create(runName) создает пустой запуск с именем runName.

пример

runObj = Simulink.sdi.Run.create(var) создает запуск, содержащий данные переменной скалярной рабочей области var. Имя запуска определяется согласно переменного входа. Для примера, когда var является timeseries объект, имя запуска происходит от Name свойство timeseries объект.

пример

runObj = Simulink.sdi.Run.create(runName,'file',filename) создает запуск, который содержит данные в файле, заданном filename.

runObj = Simulink.sdi.Run.create(runName,'file',filename,reader) использует средство чтения файлов, reader, чтобы создать запуск, содержащий данные в файле, filename. Используйте этот синтаксис, когда несколько устройств чтения файлов, поддерживающих файл с данными для импорта, регистрируются в Данные Моделирования Inspector. Чтобы определить, какие средства чтения доступны для вашего файла, используйте io.reader.getSupportedReadersForFile функция.

пример

runObj = Simulink.sdi.Run.create(runName,'namevalue',sourceNames,sigValues) создает запуск, содержащий данные в массиве ячеек sigValues. Массив ячеек sourceNames задает имена источников, используемые для установки RootSource, TimeSource, и DataSource свойства для сигналов, импортированных из sigValues массив ячеек.

Примеры

свернуть все

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

Создание данных

Создайте данные в рабочей области. Данные моделирования Inspector поддерживают данные временных рядов во многих форматах. Этот пример создает данные с помощью 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 формат для группирования связанных данных сигнала в один объект. The 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

Откройте Данные моделирования Inspector

Чтобы просмотреть запуски, созданные вами в каждом разделе, откройте Данные моделирования Inspector путем ввода Simulink.sdi.view в MATLAB™ Командном окне.

Создайте запуск с использованием Simulink.sdi.Run Объект

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

Этот пример создает пустой запуск с использованием Simulink.sdi.Run.create function, дает запуску значимое имя и описание, а затем добавляет синус и косинус 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 функция для создания нового запуска в Данные моделирования Inspector 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);

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

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

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

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

Этот пример создает запуск с именем 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 функция для импорта данных в Данные моделирования Inspector из файла. Используйте file опция для импорта данных в simusoids.mat файл.

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

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

Создание данных для запуска

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

time = linspace(0,20,100);

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.view функция для открытия Данные Моделирования Inspector.

Simulink.sdi.view

Чтобы импортировать данные в Данные моделирования Inspector из рабочей области, создайте Simulink.sdi.Run объект с использованием Simulink.sdi.Run.create функция. Добавьте информацию о запуске к его метаданным с помощью Name и Description свойства Run объект.

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

Используйте add функция для добавления данных, созданных в рабочей области, в пустой запуск.

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

Постройте график данных в Данные моделирования Inspector

Используйте getSignalByIndex функция для доступа к Simulink.sdi.Signal объекты, которые содержат сигнальные данные. Можно использовать Simulink.sdi.Signal свойства объекта, чтобы задать стиль линии и цвет для сигнала и построить его в Данные моделирования Inspector. Задайте LineColor и LineDashed свойства для каждого сигнала.

sine_sig = getSignalByIndex(sinusoidsRun,1);
sine_sig.LineColor = [0 0 1];
sine_sig.LineDashed = '-.';

cos_sig = sinusoidsRun.getSignalByIndex(2);
cos_sig.LineColor = [0 1 0];
cos_sig.LineDashed = '--';

Используйте Simulink.sdi.setSubPlotLayout функция для конфигурирования 2-by- 1 subplot размещения в области построения графиков Данных моделирования Inspector. Затем используйте plotOnSubplot функция для построения графика синусоидального сигнала на верхней подграфике и косинусоидального сигнала на нижней подграфике.

Simulink.sdi.setSubPlotLayout(2,1);

plotOnSubPlot(sine_sig,1,1,true);
plotOnSubPlot(cos_sig,2,1,true);

Закройте Данные моделирования Inspector и сохраните данные

После завершения проверки данных нанесенного на график сигнала можно закрыть Данные моделирования Inspector и сохранить сеанс в файле MLDATX.

Simulink.sdi.close('sinusoids.mldatx')

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

свернуть все

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

Пример: 'Baseline Simulation'

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

Пример: myData

Имена источников для импортированных данных, заданные как массив ячеек из векторов символов. Имя источника используется для установки RootSource, TimeSource, и DataSource свойства Simulink.sdi.Signal объекты, созданные из данных, заданных sigValues вход.

Предоставьте sourceNames вводите, когда вы задаете 'namevalue' для второго аргумента.

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

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

Предоставьте sigValues вводите, когда вы задаете 'namevalue' для второго аргумента.

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

Имя файла с данными для импорта, заданное как вектор символов. Предоставьте filename вводите, когда вы задаете 'file' для второго аргумента.

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

  • MAT-файл

  • Файл CSV

  • Microsoft® Excel® файл, содержащий данные, форматированные в соответствии с форматами Microsoft Excel Import, Export и Logging Format.

  • MDF-файл с одним из следующих расширений:

    • .mdf

    • .mf4

    • .mf3

    • .data

    • .dat

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

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

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

Укажите вход ридера, когда:

  • Вы хотите использовать встроенный reader для импорта данных для файла, который также поддерживается пользовательским reader.

  • Файл поддерживается несколькими зарегистрированными пользовательскими считывателями.

Чтобы определить, какие средства чтения доступны для импорта файла, используйте io.reader.getSupportedReadersForFile функция.

Пример: 'MyExcelReader'

Пример: 'built-in'

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

свернуть все

Импортированные данные, возвращенные как Simulink.sdi.Run объект. Когда вы создаете пустой Run объект, импортируйте данные из базового рабочего пространства или файла с помощью add функцию или Simulink.sdi.addToRun функция.

Введенный в R2017b