Simulink.sdi.exportRun

Export Simulation Data Inspector запускает данные в рабочую область или файл

Описание

пример

dataset = Simulink.sdi.exportRun(runID) создает Simulink.SimulationData.Dataset объект в базовом рабочем пространстве с данными в Данных моделирования Inspector, выполняемом идентифицированным runID.

пример

Simulink.sdi.exportRun(runID,Name,Value) экспортирует данные в запуск, соответствующую runID в базовое рабочее пространство или файл в соответствии с опциями, заданными одним или несколькими аргументами пары "имя-значение". Можно экспортировать данные для одного или нескольких запусков в MAT, MLDATX или Microsoft® Excel® файл. Чтобы экспортировать данные для нескольких запусков в файл, можно задать runIDs вход как вектор идентификаторов участков.

Примеры

свернуть все

В этом примере показов, как экспортировать данные из запуска в Данные моделирования Inspector в Simulink.SimulationData.Dataset объект в базовом рабочем пространстве, который можно использовать для дальнейшей обработки данных. Метод экспорта зависит от обработки, выполняемой в скрипте. Если у вас есть объект запуска для запуска, можно использовать export метод для создания Simulink.SimulationData.Dataset объект с данными запуска в базовом рабочем пространстве. Если у вас нет объекта запуск, используйте Simulink.sdi.exportRun функция для экспорта запуска в рабочую область.

Экспорт выполнения с использованием Simulink.sdi.exportRun

Используйте Simulink.sdi.export функция для экспорта данных запуска в рабочую область или файл, когда рабочий процесс не включает создание объекта выполнения.

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

load_system('vdp')

SignalHandles = get_param('vdp', 'Lines');

Simulink.sdi.markSignalForStreaming(SignalHandles(5).Handle, 'on')
Simulink.sdi.markSignalForStreaming(SignalHandles(6).Handle, 'on')

out = sim('vdp');

Используйте Simulink.sdi.getAllRunIDs функция для доступа к последнему созданному запуску.

runIDs = Simulink.sdi.getAllRunIDs;
runID = runIDs(end);

Используйте Simulink.sdi.exportRun функция для экспорта данных запуска в Dataset объект в рабочей области.

simDataset = Simulink.sdi.exportRun(runID);

Экспорт выполнения с использованием export Функция

Когда ваша задача включает в себя создание Run объект, можно использовать export функция для создания Simulink.SimulationData.Dataset объект в базовом рабочем пространстве для дальнейшей обработки данных запуска. Например, предположим, что вам нужно получить доступ к Run объекты для симуляции выполняются с данными о сигнале, которые вы хотите сравнить с помощью Simulink.sdi.compareSignals функция.

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

load_system('vdp')

SignalHandles = get_param('vdp', 'Lines');

Simulink.sdi.markSignalForStreaming(SignalHandles(5).Handle, 'on')
Simulink.sdi.markSignalForStreaming(SignalHandles(6).Handle, 'on')

sim('vdp');

Используйте Simulink.sdi.getAllRunIDs функция для доступа к идентификатору запуска для последнего недавно созданного запуска. Затем используйте Simulink.sdi.getRun функция для доступа к Run объект, относящийся к запуску.

runIDs = Simulink.sdi.getAllRunIDs;
runID = runIDs(end);
vdpRun = Simulink.sdi.getRun(runID);

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

simDataset = export(vdpRun);

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

свернуть все

Запустите идентификатор для запуска, которую вы хотите экспортировать в рабочую область или файл. При экспорте данных в файл можно экспортировать несколько прогонов, задав runID Вход как вектор Данных моделирования Inspector.

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

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'to','file'

Где экспортировать данные, заданные как разделенная разделенными запятой парами, состоящая из 'to' и 'variable' или 'file'.

При экспорте данных в файл необходимо также задать имя файла с помощью 'filename' аргумент пары "имя-значение". Вы можете задать имя файла с .mat, .mldatx, или .xlsx расширение.

При экспорте запуска в MAT-файл данные сохраняются в Simulink.SimulationData.Dataset объект. Когда вы экспортируете несколько прогонов в MAT-файл, используя Simulink.sdi.exportRun функция, данные сохраняются в Dataset объект, где каждый элемент является Dataset объект, содержащий данные для одного экспортированного запуска.

Данные, экспортированные в файл Microsoft Excel, сохраняются в формате Microsoft Excel Import, Export и Logging Format.

При экспорте данных в файл Microsoft Excel можно задать дополнительные опции с помощью 'overwrite', 'metadata', и 'sharetimecolumn' Пары "имя-значение".

Пример: 'to','file'

Имя файла, содержащего экспортированные данные, заданное как разделенная разделенными запятой парами, состоящая из 'filename' и строка или символьный массив. Включите .mat, .mldatx, или .xlsx расширение в имени файла, чтобы указать, экспортировать ли данные в MAT-файл, файл MLDATX или файл Microsoft Excel. Когда вы не задаете расширение с именем файла, данные экспортируются в MAT-файл.

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

При экспорте данных в файл Microsoft Excel можно задать дополнительные опции с помощью 'overwrite', 'metadata', и 'sharetimecolumn' Аргументы пары "имя-значение".

Пример: 'filename',"mySpreadsheet.xlsx"

Данные для перезаписи в существующем файле Microsoft Excel, заданные как разделенная разделенными запятой парами, состоящая из 'overwrite' и 'file' или 'sheetsonly'.

  • 'file' - Перезаписать весь файл экспортированными данными.

  • 'sheetsonly' - Только перезаписать листы файла Microsoft Excel данными, соответствующими экспортированным данным.

При экспорте данных в существующий MAT-файл или файл MLDATX экспортированные данные перезаписывают весь файл.

Пример: 'overwrite','sheetsonly'

Метаданные для включения в экспортированный файл Microsoft Excel, заданные как разделенная разделенными запятой парами, состоящая из 'metadata' и строковые массивы. По умолчанию операция экспорта не содержит никаких метаданных. Можно экспортировать эти метаданные в файл Microsoft Excel:

  • dataType - Тип данных сигнала

  • units - Сигнальные модули

  • blockPath - Путь к исходному блоку для записанных сигналов

  • interp - Метод интерполяции сигналов

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

Требуемые метаданные можно задать в любом порядке, выбранном в строковые массивы. Порядок метаданных в строковые массивы не влияет на формат в экспортированном файле, который всегда соответствует описанию в Microsoft Excel Import, Экспорту и Logging Format.

Пример: 'metadata',["units","dataType"]

Разделяют ли сигналы, которые имеют одинаковые временные данные, временные столбцы в экспортированном файле Microsoft Excel, заданные как разделенная разделенными запятой парами, состоящая из 'sharetimecolumn' и 'on' или 'off'. По умолчанию сигналы с теми же данными времени совместно используют столбец времени в экспортированном файле. Когда вы задаете значение как 'off'каждый сигнал в экспортированном файле имеет свой собственный временной столбец.

Пример: 'sharetimecolumn','off'

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

свернуть все

Simulink.SimulationData.Dataset объект, содержащий данные из запуска, идентифицированного runID.

Введенный в R2017a