В этом примере показано, как создать функцию MEX из функции MATLAB ® ,compute_average, который использует постоянные переменные. Это показывает, что перед использованием функции для вычисления среднего значения нового набора значений необходимо очистить состояние постоянных переменных.
В этом примере также показано, как инициализировать и заканчивать состояние постоянных переменных для одной и той же функции MATLAB в автономном сгенерированном коде. Перед использованием функции для вычисления среднего значения нового набора значений необходимо очистить состояние постоянных переменных в сгенерированном коде.
Предпосылки для этого примера отсутствуют.
compute_average Функция compute_average.m функция использует две постоянные переменные, накопленную сумму и количество добавленных значений, чтобы можно было вызвать функцию с одним значением за раз.
type compute_average% y = compute_average(x)
% This function takes an input scalar value 'x' and returns the average
% value so far.
function y = compute_average(x) %#codegen
assert(isa(x,'double')); % Input is scalar double
% Declare two persistent variables 'sum' and 'cnt'.
persistent sum cnt;
% Upon the first call we need to initialize the variables.
if isempty(sum)
sum = 0;
cnt = 0;
end
% Compute the accumulated sum and the number of values so far.
sum = sum + x;
cnt = cnt + 1;
% Return the current average.
y = sum / cnt;
%#codegen директива указывает, что код MATLAB предназначен для генерации кода.
Сначала создайте функцию MEX с помощью команды codegen за которым следует имя файла MATLAB для компиляции.
codegen compute_averageCode generation successful.
По умолчанию codegen генерирует функцию MEX с именем hello_world_mex в текущей папке. Это позволяет протестировать код MATLAB и функцию MEX и сравнить результаты.
(10 + 20 + 100) / 3 = 43.3333
compute_average_mex(10)
ans = 10
compute_average_mex(20)
ans = 15
compute_average_mex(100)
ans = 43.3333
Очистить постоянные переменные с помощью clear mex команда.
clear mex(10 + 20 + 30 + 40) / 4 = 25
compute_average_mex(10)
ans = 10
compute_average_mex(20)
ans = 15
compute_average_mex(30)
ans = 20
compute_average_mex(40)
ans = 25
Состояния постоянных переменных в автономном сгенерированном коде очищаются путем вызова функций инициирования и завершения в основной функции. Эти функции генерируются генератором кода. Эти файлы находятся в codegen каталог.
Можно отредактировать основной файл примера, main.c для вызова функций инициирования и завершения. Например:
type main.c/*
* File: main.c
*/
/* Include Files */
#include "main.h"
#include "compute_average.h"
#include "compute_average_terminate.h"
#include "compute_average_initialize.h"
/* Function Declarations */
static double argInit_real_T(void);
static void main_compute_average(void);
/* Function Definitions */
/*
* Arguments : void
* Return Type : double
*/
static double argInit_real_T(void)
{
return 0.0;
}
/*
* Arguments : void
* Return Type : void
*/
static void main_compute_average(void)
{
double y;
/* Initialize function 'compute_average' input arguments. */
/* Call the entry-point 'compute_average'. */
y = compute_average(argInit_real_T());
}
/*
* Arguments : int argc
* const char * const argv[]
* Return Type : int
*/
int main(int argc, const char * const argv[])
{
(void)argc;
(void)argv;
/* Initialize the entry-point function. */
compute_average_initiatlize();
/* Invoke the entry-point functions.
You can call entry-point functions multiple times. */
main_compute_average();
/* Terminate the application. */
compute_average_terminate();
/*Once the application is terminated, the state of the persistent variables is cleared. */
/* Re-initialize the entry-point function. */
compute_average_initialize();
/* You can run the application for a new set of values.*/
main_compute_average();
/* Terminate the application after your process is complete.*/
compute_average_terminate();
return 0;
}
/*
* File trailer for main.c
*
* [EOF]
*/
Как видите, main.c файл был отредактирован для вызова функции завершения, compute_average_terminate() для очистки состояния постоянных переменных. Новый набор вычислений выполняется вызовом compute_average_initialize() и main_compute_average() с новым набором значений.