Simulink.sdi.exportRun

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

Описание

пример

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

пример

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

Примеры

свернуть все

В этом примере показано, как экспортировать данные из запуска в Инспекторе Данных моделирования к 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 функционируйте, чтобы получить доступ к ID запуска для последний раз созданного запуска. Затем используйте Simulink.sdi.getRun функционируйте, чтобы получить доступ к Run объект, соответствующий запуску.

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

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

simDataset = export(vdpRun);

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

свернуть все

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

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

Когда вы экспортируете данные в файл 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.

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

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

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

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

свернуть все

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

Введенный в R2017a