exponenta event banner

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 с данными выполнения в базовой рабочей области. Если у вас нет объекта run, используйте 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 ввод в виде вектора идентификаторов запуска инспектора расчетных данных.

Инспектор данных моделирования присваивает каждому прогону уникальный идентификатор прогона. Идентификатор прогона для одного или нескольких прогонов можно получить с помощью 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 Import, Export и Logging Format.

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

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

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

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

свернуть все

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

Представлен в R2017a