Exponenta Banner
exponenta event banner

Класс Metadata Simulink.CloseMetadata

Пакет: Simulink
Суперклассы:

Доступ к метаданным прогонов моделирования

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

Описание

SimulationMetadata класс содержит информацию о прогоне моделирования, в том числе:

  • Информация о модели

  • Информация о времени

  • Исполнительная и диагностическая информация

  • Пользовательский вектор символов для маркировки моделирования

  • Пользовательские данные для описания моделирования

SimulationMetadata упаковывает эту информацию с SimulationOutput объект. Использовать SimulationMetadata, используйте один из следующих подходов:

  • В разделе Параметры конфигурации > Импорт/экспорт данных в разделе Опции сохранения выберите Вывод одного моделирования.

  • Использовать set_param установить ReturnWorkspaceOutputs кому on.

    set_param(model_name,'ReturnWorkspaceOutputs','on');

Чтобы получить SimulationMetadata объект, используйте getSimulationMetadata метод на SimulationOutput объект.

Свойства

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

ModelInfo структура имеет эти поля.

Имя поляНапечататьОписание
ModelNameслучайная работаИмя модели
ModelVersionслучайная работаВерсия модели
ModelFilePathслучайная работаАбсолютное расположение .mdl/.slx файл
UserIDслучайная работаИдентификатор системного пользователя машины, используемой для моделирования
MachineNameслучайная работаИмя хоста компьютера, используемого для моделирования
Platformслучайная работаОперационная система машины, используемой для моделирования
ModelStructuralChecksum4 по 1 uint32Структурная контрольная сумма модели, рассчитанная после схемы обновления
SimulationModeслучайная работаРежим моделирования
StartTimeдваждыВремя начала моделирования
StopTimeдваждыВремя завершения моделирования
SolverInfoструктураСведения о решателе:

  • Решатели с фиксированным шагом - тип решателя, имя и фиксированный размер шага

  • Решатели переменных - тип решателя, имя и максимальный размер шага (начальная настройка)

SimulinkVersionструктураВерсия Simulink ®
LoggingInfoструктураМетаданные о входе в постоянное хранилище:

  • LoggingToFile field - указывает, включен ли вход в постоянное хранилище ('on' или 'off')

  • LoggingFileName поле - имя разрешенного файла для MAT-файла постоянного хранилища (если LoggingToFile является 'on').

Структура для хранения информации о прогоне моделирования, включая причину остановки моделирования и любую диагностику, о которой сообщается во время моделирования. Структура имеет эти поля.

Имя поляНапечататьОписание
StopEventНетранслируемый символьный векторПричина остановки моделирования, представляемая одним из следующих вариантов:

  • ReachedStopTime - Моделирование остановлено по достижении времени остановки, и во время выполнения не было получено сообщений об ошибках. StopEvent имеет значение ReachedStopTime, даже если об ошибках сообщается в обратных вызовах остановки, которые выполняются после завершения моделирования.

  • ModelStop - Моделирование останавливается блоком или решателем до достижения времени остановки.

  • StopCommand - Моделирование остановлено вручную, нажав кнопку Stop или используя set_param команда.

  • DiagnosticError - Моделирование остановлено из-за сообщения об ошибке во время моделирования.

  • KeyboardControlC - Моделирование остановлено с помощью нажатия клавиши Ctrl+C.

  • PauseCommand - Моделирование приостановлено вручную, нажав кнопку Пауза (Pause) или используя set_param команда.

  • ConditionalPause - Моделирование приостановлено с использованием условной точки останова.

  • PauseTime - Моделирование приостановлено в указанное время паузы или после него.

  • StepForward - Моделирование приостановлено после нажатия на шаг вперед.

  • StepBackward - Моделирование приостановлено после нажатия на шаг назад.

  • TimeOut - Моделирование остановлено, так как превышено время ожидания выполнения, указанное в TimeOut.

StopEventSourceSimulink.SimulationData.BlockPathИсточник события stop, если это допустимый объект Simulink.
StopEventDescriptionПреобразованный вектор символовСупернабор информации, хранящейся в StopEvent и StopEventSource.
ErrorDiagnosticструктураСообщение об ошибке во время моделирования, представленное следующими полями:

  • Diagnostic – MSLDiagnostic объект, включающий пути, идентификатор, сообщение, причину и стек объектов.

  • SimulationPhase - Представлен одним из следующих: Initialization, Execution, или Termination.

  • SimulationTime - время моделирования, представляемое как двойное, если сообщается во время выполнения; остальное, представленное как [].

Передавая пару имя-значение 'CaptureErrors', 'on' в sim , ошибки, возникшие при моделировании, сообщаются в ExecutionInfo.ErrorDiagnostic. sim команда не фиксирует сгенерированные ошибки.

WarningDiagnosticsМассив структурыМассив всех предупреждений, сообщенных во время моделирования. Каждый элемент массива представлен следующими полями:

  • Diagnostic – MSLDiagnostic объект, включающий пути, идентификатор, сообщение, причину и стек объектов.

  • SimulationPhase - Представлены следующим образом: Initialization, Execution, или Termination.

  • SimulationTime - Время моделирования, представляемое как двойное, если сообщается во время Execution; остальное, представленное как [].

Структура для хранения профилирующей информации о моделировании, включая временные метки для начала и конца моделирования. Структура имеет эти поля.

Имя поляНапечататьОписание
WallClockTimestampStartсимвольный векторВремя начала моделирования на стене, в YYYY-MM-DD HH:MI:SS формат с микросекундным разрешением
WallClockTimestampStopсимвольный векторВремя остановки моделирования на стене, в YYYY-MM-DD HH:MI:SS формат с микросекундным разрешением
InitializationElapsedWallTimeдваждыВремя, затраченное до выполнения, в секундах
ExecutionElapsedWallTimeдваждыВремя, затраченное во время выполнения, в секундах
TerminationElapsedWallTimeдваждыВремя, затраченное после выполнения, в секундах
TotalElapsedWallTimeдваждыОбщее время инициализации, выполнения и завершения в секундах
ProfilerDataSimulink.profiler.Data

Результаты профилирования модели, возвращенные как Simulink.profiler.Data объект

Примечание

ProfilerData отображается только в том случае, если Profile и ReturnWorkspaceOutputs параметры модели включены

ExecutionElapsedWallTime включает время, потраченное Simulink на откат или шаг назад в моделировании. ExecutionElapsedWallTime не включает время между шагами. Например, если для перехода к моделированию используется Stepper, ExecutionElapsedWallTime время не включает время, когда моделирование находится в приостановленном состоянии. Дополнительные сведения об использовании степпера см. в разделе Как степпер моделирования помогает при анализе модели.

Использовать Simulink.SimulationOutput.setUserString для непосредственного сохранения вектора символов в SimulationMetadata объект, который содержится в SimulationOutput объект.

Использовать Simulink.SimulationOutput.setUserData для хранения пользовательских данных в SimulationMetadata объект, который содержится в SimulationOutput объект.

Копирование семантики

Значение. Сведения о том, как классы значений влияют на операции копирования, см. в разделе Копирование объектов.

Примеры

свернуть все

Открыть сценарий

Моделирование vdp модель. Получение метаданных из SimulationMetadata объект моделирования.

Моделирование vdp модель. Сохранение результатов Simulink.SimulationOutput объект в simout.

 open_system('vdp');
 simout = sim(bdroot,'ReturnWorkspaceOutputs','on');

Получение метаданных об этом моделировании с помощью mData. Это SimulationMetadata объект, который simout содержит.

 mData=simout.getSimulationMetadata()

mData = 

  SimulationMetadata with properties:

        ModelInfo: [1x1 struct]
       TimingInfo: [1x1 struct]
    ExecutionInfo: [1x1 struct]
       UserString: ''
         UserData: []

Сохранить пользовательские данные или строку в simout.

 simout=simout.setUserData(struct('param1','value1','param2','value2','param3','value3'));
 simout=simout.setUserString('Store first simulation results');

Получение пользовательских данных, сохраненных из mData.

 mData=simout.getSimulationMetadata()
 disp(mData.UserData)

mData = 

  SimulationMetadata with properties:

        ModelInfo: [1x1 struct]
       TimingInfo: [1x1 struct]
    ExecutionInfo: [1x1 struct]
       UserString: 'Store first simulation results'
         UserData: [1x1 struct]

    param1: 'value1'
    param2: 'value2'
    param3: 'value3'

Получить пользовательскую строку, сохраненную из mData.

 mData=simout.getSimulationMetadata()
 disp(mData.UserString)

mData = 

  SimulationMetadata with properties:

        ModelInfo: [1x1 struct]
       TimingInfo: [1x1 struct]
    ExecutionInfo: [1x1 struct]
       UserString: 'Store first simulation results'
         UserData: [1x1 struct]

Store first simulation results

См. также

| |

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

Документация Simulink

Поддержка