Simulink.SimulationMetadata class

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

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

Описание

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

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

  • Время выполнения

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

  • Пользовательский вектор символов, чтобы пометить симуляцию

  • Пользовательские данные, чтобы описать симуляцию

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

  • В Configuration Parameters> Data Import/Export, под Save options, выбирают Single simulation output.

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

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

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

Свойства

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

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

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

  • Переменные решатели – тип Решателя, имя, и макс. продвигаются размер (установка начальной буквы)

SimulinkVersionструктураВерсия Simulink®
LoggingInfoструктураМетаданные о логгировании к персистентному устройству хранения данных:
  • LoggingToFile поле Указывает, включено ли логгирование к персистентному устройству хранения данных ('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Источник события остановки, если это - допустимый объект Simulink.
StopEventDescriptionПереведенный вектор символовНадмножество информации сохранено в StopEvent и StopEventSource.
ErrorDiagnosticstruct ()Об ошибке сообщают в процессе моделирования, представленная следующими полями:
  • DiagnosticMSLDiagnostic объект, который включает контуры объектов, ID, сообщение, причину и стек.

  • SimulationPhase – Представленный одним из них: Initialization, Execution, или Termination.

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

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

WarningDiagnosticsМассив structО массиве всех предупреждений сообщают во время симуляции. Каждый элемент массивов представлен следующими полями:
  • DiagnosticMSLDiagnostic объект, который включает контуры объектов, ID, сообщение, причину и стек.

  • SimulationPhase – Представленный как: Initialization, Execution, или Termination.

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

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

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

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

Примечание

ProfilerData поле показывают только когда Profile и ReturnWorkspaceOutputs параметры модели включены

ExecutionElapsedWallTime включает время, когда Simulink потратил, чтобы откатывать или отступить в симуляции. ExecutionElapsedWallTime не включает время, проведенное между шагами. Например, если вы используете Степпер, чтобы продвинуться посредством симуляции, 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
Для просмотра документации необходимо авторизоваться на сайте