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

Объявление функций MATLAB как внешние функции

Чтобы объявить, что функция MATLAB является внешней, добавьте построение coder.extrinsic во главе основной функции или локальной функции:

coder.extrinsic('function_name_1', ... , 'function_name_n');

function c = pythagoras(a,b,color) %#codegen
% Calculates the hypotenuse of a right triangle
%  and displays the triangle. 

c = sqrt(a^2 + b^2);
create_plot(a, b, color);


function create_plot(a, b, color)
%Declare patch as extrinsic

coder.extrinsic('patch'); 

x = [0;a;a];
y = [0;0;b];
patch(x, y, color);
axis('equal');

function y = foo %#codegen
coder.extrinsic('rat','min');
[N D] = rat(pi);
y = 0;
y = min(N, D);

Вызов функций MATLAB Используя feval

Функциональный feval автоматически интерпретирован как внешняя функция во время генерации кода. Поэтому можно использовать feval, чтобы удобно вызвать функции, которые вы хотите выполнить в среде MATLAB, а не скомпилированный к сгенерированному коду.

Рассмотрите следующий пример:

function y = foo 
coder.extrinsic('rat');
[N D] = rat(pi);
y = 0;
y = feval('min', N, D);

Поскольку feval является внешним, оператор feval('min', N, D) оценен MATLAB — не скомпилированный — который имеет тот же результат как объявление функционального min, внешнего для только этого вызова. В отличие от этого, функциональный rat является внешним в функциональном foo.

Генератор кода не поддерживает использование feval, чтобы вызвать локальные функции или функции, которые расположены в частной папке.

Внешнее объявление для нестатических методов

Предположим, что вы задаете класс myClass, который имеет нестатический метод foo, и затем создайте экземпляр obj этого класса. Если вы хотите объявить метод obj.foo как внешний в вашем коде MATLAB, который вы предназначаете для генерации кода, следуете этим правилам:

Например, задайте myClass как:

classdef myClass
    properties
        prop = 1
    end
    methods
        function y = foo(obj,x)
            y = obj.prop + x;
        end
    end
end

Вот функция MATLAB в качестве примера, которая объявляет foo как внешний.

function y = myFunction(x) %#codegen
coder.extrinsic('foo');
obj = myClass;
y = foo(obj,x);
end

Нестатические методы также известны как обычные методы. См. Методы и Функции (MATLAB).

Разрешение внешних функций во время симуляции

Генератор кода разрешает вызовы внешних функций — функции, которые не поддерживают генерацию кода — можно следующим образом:

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

Во время генерации кода генератор кода пытается определить, влияет ли внешняя функция на вывод функции, в которой это называется — например, путем возврата mxArrays выходной переменной (см. Работу с mxArrays). При условии, что вывод не изменяется, доходы генерации кода, но внешняя функция исключена из сгенерированного кода. В противном случае генератор кода выпускает ошибку компилятора.

Работа с mxArrays

Выводом внешней функции является mxArray — также вызвал массив MATLAB. Единственные допустимые операции для mxArrays:

Чтобы использовать mxArrays, возвращенный внешними функциями в других операциях, необходимо сначала преобразовать их в известные типы, как описано в Преобразовании mxArrays к Известным Типам.

function y = foo %#codegen
coder.extrinsic('rat');
[N D] = rat(pi);
y = min(N, D);

Function output 'y' cannot be of MATLAB type.

function y = foo %#codegen
coder.extrinsic('rat');
[N D] = rat(pi);
y = 0; % Define y as a scalar of type double
y = min(N,D);

Ограничения на внешние функции для генерации кода

Полная среда выполнения MATLAB не поддержана во время генерации кода. Поэтому следующие ограничения применяются при вызове функций MATLAB внешне:

Ограничьте на аргументах функции

Можно вызвать функции максимум с 64 входными параметрами и 64 выходными параметрами.