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

Пример: Повторное использование типа вывода вложенной структуры в качестве типа ввода

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

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

function [out] = myConstructor(a, b)
% create a variable-sized array with upper bounds of 100-by-100
coder.varsize('myStruct.f1.f2.f3.f4', [100 100], [1 1]);
% define the nested structure type
myStruct = struct('f1', struct('f2', struct('f3', struct('f4', zeros(a,b) ))));
% specify the name of the structure and one of its fields
coder.cstructname(myStruct.f1.f2.f3,'squiggle_f3');
coder.cstructname(myStruct,'squiggle');
out = myStruct;

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

function x = useConstructor(x, n)
xz = x.f1.f2.f3.f4;
b = zeros(size(xz,1),1);
for i = 1:n
    xz = [(xz + pi), b];
end
x.f1.f2.f3.f4 = xz;

Создание кода для myConstructor и useConstructor и рассматривать их как несколько функций точки входа, необходимо указать типы ввода для обеих функций. Укажите типы ввода для myConstructor используя два целых числа. Для useConstructor, укажите тип ввода в качестве типа вывода из myConstructor с помощью coder.OutputType:

v = coder.OutputType('myConstructor');
codegen myConstructor -args {5,1} useConstructor -args {v,3} -report -config:lib

В сгенерированном коде интерфейсы функций выровнены. Две функции точки входа используют одно и то же определение типа для squiggle. Созданный код для конструктора можно использовать для создания типа ввода для созданного кода для useConstructor.

Пример: Определение типа ввода вручную без использования coder.OutputType

Если вы не используете coder.OutputType для определения типа ввода для useConstructor, необходимо указать тип ввода с помощью coder.typeof и coder.StructType свойства класса:

% MATLAB type definition for squiggle
myStruct = struct('f1', struct('f2', struct('f3', struct('f4', zeros(2) ))));
t = coder.typeof(myStruct);
t.Fields.f1.Fields.f2.Fields.f3.Fields.f4 = coder.typeof(zeros(2), [100 100], [1 1]);
t.Fields.f1.Fields.f2.Fields.f3.TypeName = 'squiggle_f3';
t.TypeName = 'squiggle';

Чтобы создать статический код библиотеки, введите:

codegen myConstructor -args {5,1} useConstructor -args {t,3} -report -config:lib

Как и в первом примере, интерфейсы функций выровнены. Однако создание и ведение определения типа для squiggle является трудоемким. Изменения, внесенные в определение типа, должны быть реплицированы в двух местах: myConstructor функция и текущая переменная рабочей области t. Эти изменения могут оказаться несинхронизированными, особенно при работе со сложными определениями типов. Использовать coder.OutputType помощь в процессе разработки.

Пример: Создание конструктора и использование coder.OutputType Передача типа вывода

Рассмотрим функцию useSparse который выполняет операцию на входном сигнале разреженной матрицы.

function out = useSparse(in)
%#codegen
out = in*2;

При создании кода для useSparse, необходимо вручную создать соответствующий тип ввода в C/C + +. Чтобы автоматизировать и упростить построение типа, напишите конструктор для разреженной матрицы.

function A = makeSparse(i,j,v,m,n)
%#codegen
A = sparse(i,j,v,m,n);

Для создания кода используйте coder.OutputType для передачи выходных данных конструктора в качестве входных данных в useSparse. Определите входной аргумент как матрицу 3 на 5.

t = coder.OutputType('makeSparse');
S = round(rand(3,5));
[m,n] = size(S);
[i,j,v] = find(S);
i = coder.typeof(i,[inf 1]); % allow number of nonzero entries to vary
codegen makeSparse -args {i,i,i,m,n} useSparse -args {t} -report

С помощью сгенерированного кода C/C + + можно выполнить вызовmakeSparse для генерации входных данных в useSparse. coder.OutputType функция упрощает создание и выравнивание интерфейса для отдельных функций точки входа, которые относятся к общей кодовой базе.