экспорт

Класс: Simulink.sdi. Запущенный
Пакет: Simulink.sdi

Экспорт запущен к базовому рабочему пространству или файлу

Синтаксис

ds = runObj.export
runObj.export(Name,Value)

Описание

ds = runObj.export экспортирует объект Simulink.sdi.Run runObj в базовое рабочее пространство в Simulink.SimulationData.Dataset, ds.

runObj.export(Name,Value) экспортирует объект Simulink.sdi.Run runObj в базовое рабочее пространство или файл согласно опциям, заданным одним или несколькими аргументами пары "имя-значение".

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

развернуть все

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

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

Когда вы экспортируете сигнал, данные сохранены в MAT-файле как объект timeseries. Когда вы экспортируете выполнение в MAT-файл, данные сохранены в объекте Simulink.SimulationData.Dataset.

Данные, экспортированные в файл Microsoft® Excel®, сохранены с форматом, описанным в Инспекторе Данных моделирования Формат файла Экспорта и Импорт.

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

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

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

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

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

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

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

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

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

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

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

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

  • модули Модули сигнала

  • blockPath — Путь к исходному блоку для регистрируемых сигналов

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

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

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

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

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

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

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

развернуть все

Simulink. SimulationData. Объект Dataset, содержащий данные о выполнении.

Примеры

развернуть все

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

Экспорт, запущенный Используя Simulink.sdi.exportRun

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

% Load vdp model
load_system('vdp')

% Get handles for signal lines in model
SignalHandles = get_param('vdp', 'Lines');

% Mark signals for streaming
Simulink.sdi.markSignalForStreaming(SignalHandles(5).Handle, 'on')
Simulink.sdi.markSignalForStreaming(SignalHandles(6).Handle, 'on')

% Simulate vdp model
sim('vdp')
ans = 
  Simulink.SimulationOutput:

                logsout: [1x1 Simulink.SimulationData.Dataset] 

     SimulationMetadata: [1x1 Simulink.SimulationMetadata] 
           ErrorMessage: [0x0 char] 

% Get run ID for simulation run
runIDs = Simulink.sdi.getAllRunIDs;
runID = runIDs(end);

% Export run
simDataset = Simulink.sdi.exportRun(runID);

Экспорт, запущенный Используя метод export

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

% Load vdp model
load_system('vdp')

% Get handles for signal lines in model
SignalHandles = get_param('vdp', 'Lines');

% Mark signals for streaming
Simulink.sdi.markSignalForStreaming(SignalHandles(5).Handle, 'on')
Simulink.sdi.markSignalForStreaming(SignalHandles(6).Handle, 'on')

% Simulate model vdp and get run object
sim('vdp')
ans = 
  Simulink.SimulationOutput:

                logsout: [1x1 Simulink.SimulationData.Dataset] 

     SimulationMetadata: [1x1 Simulink.SimulationMetadata] 
           ErrorMessage: [0x0 char] 

% Get run object for simulation run
runIDs = Simulink.sdi.getAllRunIDs;
runID = runIDs(end);
vdpRun = Simulink.sdi.getRun(runID);

% Get signal ids for signals
sigID1 = vdpRun.getSignalIDByIndex(1);
sigID2 = vdpRun.getSignalIDByIndex(2);

% Compare signals
diffResult = Simulink.sdi.compareSignals(sigID1,sigID2);
diffResult.match
ans = logical
   0

% Export run
simDataset = vdpRun.export;

Альтернативы

Можно экспортировать данные о выполнении программно с помощью функции Simulink.sdi.exportRun, или можно использовать Инспектора Данных моделирования пользовательский интерфейс. Для получения дополнительной информации смотрите, Сохраняют и инспектор Данных моделирования Доли Дэта и Представления.

Введенный в R2017b

Для просмотра документации необходимо авторизоваться на сайте