Simulink.sdi.createRun

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

Описание

runID = Simulink.sdi.createRun создает пустой неназванный запуск в Данные моделирования Inspector и возвращает идентификатор запуска.

Вы можете использовать Simulink.sdi.getRun для доступа к Simulink.sdi.Run объект, который соответствует запуску. Установите свойства на Run объект для добавления метаданных в запуск. Используйте Simulink.sdi.addToRun функцию или add функция для добавления данных к запуску.

пример

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

пример

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

пример

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

пример

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

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

пример

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

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

пример

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

Примеры

свернуть все

Можно программно импортировать данные в Данные моделирования 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 для синусоидальных и косинусоидных сигналов.

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

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

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

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

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

свернуть все

Имя для выполнения в Данные моделирования 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'

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

свернуть все

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

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

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

Введенный в R2011b