Exponenta Banner
exponenta event banner

solverprofiler.profileModel

Анализ модели для анализа производительности

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

Синтаксис

res = solverprofiler.profityModel (модель)
res = solverprofiler.profityModel (модель, имя, значение)

Описание

пример

res = solverprofiler.profileModel(model) запускает профилировщик решателя на указанном model и сохраняет результаты в res

пример

res = solverprofiler.profileModel(model, Name,Value)задание параметров профилировщика решателя с использованием одного или нескольких Name, Value аргументы пары.

Примеры

свернуть все

Изучение модели f14 с использованием параметров командной строки по умолчанию.

model = 'f14';
res = solverprofiler.profileModel(model);

Вы можете просмотреть сводку результатов, позвонив по телефону res.summary.

res.summary
 struct with fields:

             solver: 'ode45'
             tStart: 0
              tStop: 60
             absTol: 1.0000e-06
             relTol: 1.0000e-04
               hMax: 0.1000
           hAverage: 0.0444
              steps: 1352
        profileTime: 0.9974
           zcNumber: 0
        resetNumber: 600
     jacobianNumber: 0
    exceptionNumber: 195

Откройте результаты в диалоговом окне «Профилировщик решателя» для их визуализации. Этот шаг эквивалентен включению OpenSP при вызове функции.

solverprofiler.exploreResult(res)

Изучение модели ssc_actuator_custom_pneumatic с полностью указанной конфигурацией.

model = 'ssc_actuator_custom_pneumatic';
res = solverprofiler.profileModel(model, ...
    'SaveStates' , 'on', ...
    'SaveSimscapeStates' , 'On', ...
    'SaveJacobian' , 'On', ...
    'StartTime' , 5, ...
    'StopTime' , 50, ...
    'BufferSize',  10000,...
    'TimeOut', 5,...
    'OpenSP', 'On',...
    'DataFullFile', fullfile(pwd, 'ssc_profiling_result.mat'));

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

свернуть все

Имя модели, подлежащей профилированию, указанное как символьный вектор.

Пример: h = solverprofiler.profileModel('vdp')

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'StartTime',0,'StopTime',10,'SaveStates','On'

По умолчанию профилировщик не сохраняет состояния модели. Включение этого параметра настраивает профилировщик на сохранение состояний в MAT-файл.

Пример: 'SaveStates','On'

Этот параметр используется для сохранения состояний Simscape в MAT-файле.

Пример: 'SaveSimscapeStates', 'On'

Опция для регистрации решающих матриц якобиана в памяти. Эта опция полезна при моделировании с использованием неявных решателей. Сравнение решателей см. в разделе Сравнение решателей.

Пример: 'SaveJacobian', 'On'

Время (в секундах) моделирования, в течение которого профилировщик начинает анализ модели. Это не то же самое, что время начала моделирования.

Пример: 'StartTime',5

Время (в секундах) моделирования, на которое профилировщик должен профилировать модель. По умолчанию анализ продолжается до конца моделирования. При изменении этого параметра не изменяется время остановки модели, указанное в окне Параметры конфигурации модели (Model Configuration Parameters).

Значение, меньшее, чем настроенное время остановки модели, останавливает профилирование и моделирование в StopTime.

Пример: 'StopTime',30

Максимальное количество зарегистрированных событий. Если количество зарегистрированных событий достигает этого значения и память доступна, увеличьте BufferSize. Если объем памяти ограничен, рекомендуется понизить значение.

Пример: 'BufferSize',60000

Время (в секундах) ожидания перед остановкой работы профилировщика. Эта опция полезна в ситуациях, когда моделирование не может быть продолжено. Профилировщик ожидает указанного времени и завершает работу, если прогресс не был достигнут.

Пример: 'TimeOut', 10

Опция для открытия диалогового окна Профилировщик решателя (Solver Profiler) после завершения профилирования.

Пример: 'OpenSP','On'

По умолчанию результаты профилирования сохраняются в MAT-файле с именем model_@_dd_Month_yyyy_hh_mm_ss.mat в текущей рабочей папке. Можно указать другое имя файла для сохранения результатов в текущей рабочей папке. Чтобы сохранить файл в другом месте, укажите полный путь к файлу, включая имя файла.

Пример: 'DataFullFile','C:\Users\myusername\Documents\profiled\vdp_results.mat'

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

свернуть все

Результаты профилирования, возвращенные в виде структуры с полями:

Путь и имя MAT-файла, в котором результаты операции профилирования хранятся как MAT-файл. По умолчанию они хранятся в текущей рабочей папке с именем файла, имеющим шаблон: model_@_dd_Month_yyyy_hh_mm_ss.mat. Чтобы сохранить их в другом месте или под другим именем, укажите DataFullFile при вызове solverprofiler.profileModel.

Высокоуровневая сводка результатов операции профилирования, возвращенная в виде структуры. В резюме представлен обзор производительности моделирования и работоспособности модели.

summary структура содержит эти поля.

ОбластьЦельЦенностиОписание
solverРешатель, используемый при моделированиилюбой из решателей, поддерживаемых Solver ProfilerРешатель, используемый при моделировании как настроенный в параметрах конфигурации для модели. Список всех решателей см. в разделе Решатель. Профилировщик решателя не поддерживает модели без непрерывных состояний.
tStartВремя начала моделированияскалярВремя начала (в секундах) для моделирования модели во время операции профилирования.
tStopВремя остановки моделированияскалярВремя остановки моделирования во время операции профилирования в секундах. Если StopTime установлено более ранним, чем настроенное время остановки модели, моделирование останавливается на StopTime.
absTolАбсолютный допуск решателяположительный скалярАбсолютный допуск решателя, указанный в настройках конфигурации модели. Дополнительные сведения см. в разделе Абсолютный допуск
relTolОтносительный допуск решателяположительный скалярОтносительный допуск решателя, указанный в настройках конфигурации модели. Дополнительные сведения см. в разделе Относительный допуск
hMaxМаксимальный размер шагаположительный скалярСамый большой временной шаг, который может сделать решатель. См. раздел Максимальный размер шага.
hAverageСредний размер шагаположительный скалярСредний размер временного шага, сделанного решателем.
stepsВсего принятых мерположительный скалярОбщее количество шагов времени, выполненных решателем.
profileTimeВремя профилированияположительный скалярВремя (в секундах), затраченное профилировщиком решателя на исследование модели.
zcNumberОбщее число нулевых переходовнеотрицательный скалярКоличество пересечений нуля во время моделирования модели. Обнаружение этих нулевых пересечений влечет за собой вычислительные затраты и может замедлить моделирование. Сведения об обнаружении пересечения нуля см. в разделе Обнаружение пересечения нуля.
resetNumberКоличество сбросов решателянеотрицательный скалярКоличество раз, когда решатель должен сбросить свои параметры.
jacobianNumberКоличество обновлений Jacobianнеотрицательный скалярЧисло обновлений матрицы якобиана решателя во время моделирования. Дополнительные сведения см. в разделе Явные и неявные непрерывные решатели.
exceptionNumberКоличество исключений решателянеотрицательный скалярОбщее число исключений решателя, обнаруженных во время моделирования. Эти исключения являются событиями, в которых решатель не может решить состояния модели с заданной точностью. В результате решатель выполняет скорректированные испытания, которые увеличивают вычислительные затраты.

Типы данных: struct

См. также

Темы

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

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

Поддержка