13.6 Профилирование

Octave поддерживает профилирование выполнения кода на уровне каждой функции. Если профилирование включено, каждый вызов функции (встроенных функций, операторов, функций в файлах oct- и mex-файлах, пользовательских функций в коде Octave и анонимных функций) записывается во время выполнения кода Octave. После этого эти данные могут помочь в анализе поведения кода и особенно полезны для поиска «узких мест» в коде, которые используют много времени вычислений и являются лучшими целями для оптимизации.

Основная команда для профилирования — profile, которая может использоваться для запуска или остановки профилировщика, а также для запроса собранных данных впоследствии. Данные возвращаются в структуре данных Octave, которую затем можно проверить или обработать другими процедурами или инструментами.

profile on

profile off

profile resume

profile clear

S = profile ("status")

T = profile ("info")

Управление встроенным профилировщиком.

profile on

Запустить профилировщик, очистив все ранее собранные данные, если они есть.

profile off

Остановить профилирование. Собранные данные могут быть позже извлечены и просмотрены с помощью T = profile ("info").

profile clear

Очистить все собранные данные профилировщика.

profile resume

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

S = profile ("status")

Возвращает структуру с информацией о текущем состоянии профилировщика. В данный момент единственным полем является ProfilerStatus, которое может быть либо "on", либо "off".

T = profile ("info")

Возвращает собранные статистические данные профилирования в структуре T. Плоский профиль возвращается в поле FunctionTable, которое представляет собой массив структур, каждая запись соответствует функции, которая была вызвана, и для которой есть статистические данные профилирования. Кроме того, поле Hierarchical содержит иерархическое дерево вызовов. Каждый узел имеет индекс в FunctionTable, определяющий соответствующую функцию, а также поля данных для количества вызовов и времени, затраченного на этом уровне в дереве вызовов.

См. также: profshow, profexplore.

Легкий способ получить обзор собранных данных — profshow. Эта функция принимает данные профилировщика, возвращаемые profile, в качестве входных данных и печатает плоский профиль, например:

Function Attr     Time (s)        Calls
----------------------------------------
   >myfib    R        2.195        13529
binary <=             0.061        13529
 binary -             0.050        13528
 binary +             0.026         6764

Это показывает, что большая часть времени выполнения была потрачена на выполнение функции ‘myfib’, а небольшая часть — на вычисление перечисленных бинарных операторов. Кроме того, показано, сколько раз функция была вызвана, и профилировщик также записывает, что она рекурсивная.

profshow (data)

profshow (data, n)

profshow ()

profshow (n)

Отображение плоских результатов профилирования по функциям.

Вывести данные профилирования (время выполнения, количество вызовов) для наиболее важных n функций. Результаты сортируются в порядке убывания по общему времени, потраченному на каждую функцию. Если n не указано, по умолчанию используется 20.

Входные данные data — структура, возвращаемая profile ("info"). Если не указано, profshow будет использовать текущий набор данных профиля.

Столбец атрибутов отображает ‘R’ для рекурсивных функций и пуст для всех других типов функций.

См. также: profexplore, profile.

profexport (dir)

profexport (dir, data)

profexport (dir, name)

profexport (dir, name, data)

Экспорт данных профилирования в формате HTML.

Экспортировать данные профилирования в data в виде серии HTML-файлов в папке dir. Изначальный файл будет data/index.html.

Если name указан, он должен быть строкой, содержащей «имя» экспортируемого профиля. Это имя включено в HTML.

Входные данные data — структура, возвращаемая profile ("info"). Если не указано, profexport будет использовать текущий набор данных профиля.

См. также: profshow, profexplore, profile.

profexplore ()

profexplore (data)

Интерактивное исследование иерархического вывода профилирования.

Предполагая, что data — структура с данными профилирования, возвращаемая profile ("info"), эта команда открывает интерактивное окно, которое можно использовать для исследования дерева вызовов. Наберите help, чтобы получить список возможных команд. Если data опущено, profile ("info") вызывается и используется вместо него.

См. также: profile, profshow.