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

Создание профиля MEX

Профилировщик MATLAB можно использовать с созданной функцией MEX. Кроме того, если имеется тестовый файл, вызывающий функцию MATLAB, можно создать функцию MEX и профилировать ее за один шаг. Эти операции можно выполнить в командной строке или в приложении MATLAB Coder.

Для использования профилировщика с созданной функцией MEX:

При наличии тестового файла MyFunctionTest.m который вызывает функцию MATLAB, можно:

Пример

Профилировщик используется для определения функций или строк кода MATLAB, создающих сгенерированный код, который занимает наибольшее время. Ниже приведен пример функции MATLAB, которая преобразует представление своих входных матриц. A и B от главной строки к главной колонке в одной из ее линий. Такое преобразование имеет длительное время выполнения для больших матриц. Исключение преобразования путем изменения данной строки делает функцию более эффективной.

Рассмотрим функцию MATLAB:

function [y] = MyFunction(A,B) %#codegen

% Generated code uses row-major representation of matrices A and B
coder.rowMajor; 
length = size(A,1);

% Summing absolute values of all elements of A and B by traversing over the
% matrices row by row
sum_abs = 0;  
for row = 1:length 
   for col = 1:length  
       sum_abs = sum_abs + abs(A(row,col)) + abs(B(row,col));
   end
end

% Calling external C function 'foo.c' that returns the sum of all elements
% of A and B
sum = 0;
sum = coder.ceval('foo',coder.ref(A),coder.ref(B),length);

% Returning the difference of sum_abs and sum
y = sum_abs - sum;
end

Созданный код для этой функции использует главное представление строк квадратных матриц A и B. Код сначала вычисляет sum_abs (сумма абсолютных значений всех элементов A и B) путем обхода матриц по строкам. Этот алгоритм оптимизирован для матриц, представленных в главной строке. Код затем использует coder.ceval для вызова внешней функции C foo.c:

#include <stdio.h>
#include <stdlib.h>
#include "foo.h"

double foo(double *A, double *B, double length)
{
 int i,j,s;
 double sum = 0;
 s = (int)length;
 
 /*Summing all the elements of A and B*/
 for(i=0;i<s*s;i++)
 {
         sum += A[i] + B[i];
 }
 return(sum);
}

Соответствующий файл заголовка C foo.h является:

#include "rtwtypes.h"

double foo(double *A, double *B, double length);

foo.c возвращает переменную sum, которая является суммой всех элементов A и B. Выполнение функции foo.c не зависит от того, являются ли матрицы матрицами A и B представлены в компоновках «основные строки» или «основные столбцы». MyFunction возвращает разность sum_abs и sum.

Вы можете измерить производительность MyFunction для больших входных матриц A и B, а затем оптимизировать его дальше:

Влияние выражений сворачивания на охват кода MEX

При использовании coder.const сворачивание выражений в константы приводит к различию в покрытии кода между функцией MATLAB и функцией MEX. Например, рассмотрим функцию:

function y = MyFoldFunction %#codegen
a = 1;
b = 2; 
c = a + b;
y = 5 + coder.const(c);
end

Профилирование функции MATLAB MyFoldFunction показывает покрытие кода в подробном отчете о профиле:

Однако профилирование функции MEX MyFoldFunction_mex показывает другое покрытие кода:

Строки 2, 3 и 4 не выполняются в созданном коде, поскольку выражение было свернуто c = a + b в константу для генерации кода.

В этом примере используется пользовательское сворачивание выражений. Генератор кода иногда автоматически сворачивает определенные выражения для оптимизации производительности создаваемого кода. Такие оптимизации также приводят к тому, что охват функции MEX отличается от охвата функции MATLAB.