exponenta event banner

Simulink. ModelDataLogs.convertToDataset

Преобразовать данные регистрации из Simulink.ModelDataLogs формат для Simulink.SimulationData.Dataset формат

Синтаксис

convertedDataset = sourceModelDataLogsObject.convertToDataset(convertedDatasetName)

Описание

Примечание

ModelDataLogs поддерживается для обратной совместимости. Начиная с R2016a, нельзя регистрировать данные в ModelDataLogs формат. Регистрация сигналов использует Dataset формат. В R2016a или более поздней версии при открытии модели из более ранней версии, которая использовала ModelDataLogs формат, модель, моделируемая в процессе использования Dataset формат.

Можно преобразовать данные регистрации сигналов из ModelDataLogs кому Dataset формат. Преобразование в Dataset формат упрощает постобработку с другими записанными данными (например, зарегистрированными состояниями), которые также могут использовать Dataset формат. Дополнительные сведения см. в разделе Преобразование зарегистрированных данных в формат набора данных.

При наличии устаревшего кода, использующего ModelDataLogs API, вы можете столкнуться с ситуациями, которые требуют обновления кода или модели. См. раздел Миграция сценариев, использующих устаревший API ModelDataLogs.

convertedDataset = sourceModelDataLogsObject.convertToDataset(convertedDatasetName) преобразует sourceModelDataLogsObject в Simulink.SimulationData.Dataset объект. Имя преобразованного объекта основано на convertedDatasetName.

Получающееся Simulink.SimulationData.Dataset объект является плоским списком. Этот список содержит по одному элементу для каждого Simulink.Timeseries или Simulink.TsArray объект в Simulink.ModelDataLogs объект.

Ограничения

Источник записанных данных Simulink.ModelDataLogsОграничение преобразования

Ссылочная модель

Загружает всех предков ссылочной модели, не загруженной ранее. Если какая-либо модель-предок не появляется на пути MATLAB ®, преобразование завершается неуспешно.

Если модель изменилась или предки модели изменились после регистрации данных в Simulink ®, преобразование может завершиться ошибкой. Например, добавление, удаление или переименование блока после регистрации может привести к сбою преобразования.

Вариационная модель или подсистема

Текущий активный вариант должен быть тем же, который был активен, когда Simulink регистрировал данные. В противном случае преобразование не будет выполнено.

Сигнал кадра

Сбой преобразования.

Блок мультиплексора

Преобразование приводит к другому Simulink.SimulationData.Dataset объект в качестве набора данных, чем создает Simulink при моделировании модели с помощью Dataset формат для зарегистрированных данных.

Диаграмма Stateflow ®

Не поддерживается.

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

sourceModelDataLogsObject

A Simulink.ModelDataLogs объект, который требуется преобразовать в Simulink.SimulationData.Dataset объект.

convertedDatasetName

Имя набора данных, создаваемого процессом преобразования.

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

convertedDataset

Simulink.SimulationDataset объект, который Simulink.ModelDataLogs.convertToDataset создает функция.

Дополнительные сведения о преобразованном наборе данных см. в разделе Simulink.SimulationData.Dataset.

Пример

В версиях до R2016a можно регистрировать сигналы с помощью ModelDataLogs формат. Если имеется MAT-файл с данными регистрации сигналов, в котором используется ModelDataLogs формат, вот как можно преобразовать эти данные в Dataset формат. В этом примере предполагается, что в модели, создавшей данные регистрации, для параметра Configuration Parameters > Data Import/Export > Signal logging name установлено значение logsout.

  1. Загрузите MAT-файл.

  2. Новообращенный logsout в набор данных с именем myModel_dataset. (Информация об элементах будет отличаться для ваших данных.)

    dataset = logsout.convertToDataset('myModel_Dataset')
    
    dataset = 
      Simulink.SimulationData.Dataset
      Package: Simulink.SimulationData
    
      Characteristics:
                  Name: 'myModel_Dataset'
        Total Elements: 2
    
      Elements:
        1: 'x1'
        2: 'x2'
    
      -Use get or getElement to access elements by index or name.
      -Use addElement or setElement to add or modify elements.
    
      Methods, Superclasses
Представлен в R2011a