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

Значения свойств по умолчанию

MATLAB Coder присваивает следующие значения по умолчанию для свойств входных параметров первичной функции.

Определение Значений по умолчанию для Полей Структуры.  В большинстве случаев, когда вы явным образом не задаете значения для свойств, MATLAB Coder использует значения по умолчанию за исключением полей структуры. Единственный способ назвать поле в структуре состоит в том, чтобы установить по крайней мере одно из своих свойств. Поэтому вы можете должны быть задать значения по умолчанию для свойств полей структуры. Для примеров смотрите Класс Определения и Размер Скалярной Структуры и Определения Класса и Размера Массива структур.

Определение Значения по умолчанию fimath Значения для MEX-функций.  MEX-функции, сгенерированные с MATLAB Coder, используют значение fimath по умолчанию в действительности во время компиляции. Если вы не задаете значение fimath по умолчанию, MATLAB Coder использует значение по умолчанию MATLAB fimath. Заводская настройка MATLAB имеет следующие свойства:

RoundingMethod: Nearest
OverflowAction: Saturate
ProductMode: FullPrecision
SumMode: FullPrecision
CastBeforeSum: true

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

Например, предположите, что вы задаете следующую функцию MATLAB test:

function y = test %#codegen
y = fi(0);

Функциональный test создает объект fi, явным образом не задавая объект fimath. Поэтому test полагается на объект fimath по умолчанию в действительности во время компиляции. В посдказке MATLAB сгенерируйте MEX-функцию text_mex, чтобы использовать заводскую настройку значения по умолчанию MATLAB fimath:

codegen test
% codegen generates a MEX function, test_mex, 
% in the current folder

Затем, запустите test_mex, чтобы отобразить значение по умолчанию MATLAB значение fimath:

test_mex
 
ans =
 
     0

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 15

Теперь создайте локальный MATLAB значение fimath. таким образом, вы больше не используете настройку по умолчанию:

F = fimath('RoundingMethod','Floor');

Наконец, очистите MEX-функцию из памяти и повторно выполните его:

clear test_mex
test_mex

Несоответствие обнаруживается и вызывает ошибку:

??? This function was generated with a different default
fimath than the current default.

Error in ==> test_mex

Поддерживаемые классы

Следующая таблица представляет имена классов, поддержанные MATLAB Coder.

Параметр командной строки-args

Функция codegen обеспечивает параметр командной строки -args для определения свойств первичных (точка входа) входные параметры функции как массив ячеек значений в качестве примера или типов. Массив ячеек может быть переменным или литеральным массивом постоянных значений. Используя эту опцию, вы задаете свойства входных параметров в то же время, что и вы генерируете код для функции MATLAB с codegen.

Можно передать выходной тип от одной функции точки входа как вход другому. Смотрите Передачу Функция Точки входа Вывод как Вход. Для получения информации об определении входных параметров массива ячеек смотрите, Задают Входные параметры Массива ячеек в Командной строке.

Если у вас есть тестовая функция или скрипт, который вызывает функцию MATLAB точки входа с необходимыми типами, можно использовать coder.getArgTypes, чтобы определить типы входных параметров функции. coder.getArgTypes возвращает массив ячеек объектов coder.Type, которые можно передать codegen с помощью опции -args. Смотрите Specifying General Properties Первичных входных параметров для codegen.

Правила для Использования-args опции

При использовании параметра командной строки -args, чтобы задать свойства на примере, следуйте этим правилам:

Определение свойств первичных входных параметров на примере в командной строке

Рассмотрите функцию MATLAB, которая добавляет ее два входных параметров:

function y = mcf(u,v)
%#codegen
y = u + v;

Следующие примеры показывают, как задать различные свойства первичных входных параметров u и v на примере в командной строке:

Определение свойств первичных входных параметров фиксированной точки на примере в командной строке

Чтобы сгенерировать MEX-функцию или код C/C++ для фиксированной точки код MATLAB, необходимо установить программное обеспечение Fixed-Point Designer™.

Рассмотрите функцию MATLAB, которая вычисляет квадратный корень из номера фиксированной точки:

%#codegen
function y = sqrtfi(x)
y = sqrt(x);

Чтобы задать свойства первичного входа x фиксированной точки на примере, выполните эти шаги:

Вызов функций с постоянными входными параметрами

Генератор кода компилирует входные параметры постоянной функции в сгенерированный код. В сгенерированном C или Коде С++, функциональные подписи не содержат постоянные входные параметры. По умолчанию подписи MEX-функции содержат постоянные входные параметры. Когда вы вызываете MEX-функцию, необходимо обеспечить значения, которые совпадают со значениями времени компиляции. Можно управлять, включает ли подпись MEX-функции постоянные входные параметры и проверяет ли MEX-функция значения, что вы предусматриваете постоянные входные параметры. Смотрите, что Постоянный Вход Регистрируется в MEX-функциях.

Определение структуры как постоянный вход

Предположим, что вы задаете структуру tmp в рабочем пространстве MATLAB, чтобы задать размерности матрицы:

tmp = struct('rows', 2, 'cols', 3);

Следующая функция MATLAB rowcol принимает, что вход p структуры задает матричный y:

function y = rowcol(u,p) %#codegen
y = zeros(p.rows,p.cols) + u;

Следующий пример показывает, как указать, что первичный входной параметр, u является двойным скалярным вводом переменной и первичным входным параметром p, является постоянной структурой:

codegen rowcol -args {0,coder.Constant(tmp)}

Определение входа вектора Переменного Размера