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 объект.

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

Значение. Чтобы изучить, как классы значения влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

свернуть все

Симулируйте 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

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