Задайте данные Переменного Размера для генерации кода

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

МетодСмотрите

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

Используйте матричного конструктора с непостоянными размерностями
Присвойте несколько, постоянные размеры к той же переменной перед использованием (чтения) переменной.Присвойте несколько размеров той же переменной
Задайте все экземпляры переменной, чтобы быть переменным размером.Задайте Данные Переменного Размера Явным образом при помощи coder.varsize

Используйте матричного конструктора с непостоянными размерностями

Можно задать матрицу переменного размера при помощи конструктора с непостоянными размерностями. Например:

function s = var_by_assign(u) %#codegen
y = ones(3,u);
s = numel(y);

Если вы не используете динамическое выделение памяти, необходимо также добавить assert оператор, чтобы обеспечить верхние границы для размерностей. Например:

function s = var_by_assign(u) %#codegen
assert (u < 20);
y = ones(3,u);
s = numel(y);

Присвойте несколько размеров той же переменной

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

Когда генератор кода использует динамическое выделение памяти, он не проверяет на верхние границы. Это принимает, что данные переменного размера неограниченны.

Выведение верхних границ от повторных определений с различными формами

function s = var_by_multiassign(u) %#codegen
if (u > 0)
    y = ones(3,4,5);
else
    y = zeros(3,1);
end
s = numel(y);

Когда генератор кода использует статическое выделение, он выводит тот y матрица с тремя измерениями:

  • Первая размерность фиксируется в размере 3

  • Второе измерение является переменным размером с верхней границей 4

  • Третья размерность является переменным размером с верхней границей 5

Когда генератор кода использует динамическое выделение, он анализирует размерности y по-другому:

  • Первая размерность фиксируется в размере 3.

  • Вторые и третьи размерности неограниченны.

Задайте Данные Переменного Размера Явным образом при помощи coder.varsize

Чтобы явным образом задать данные переменного размера, используйте функцию coder.varsize. Опционально, можно также задать, какие размерности варьируются наряду со своими верхними границами. Например:

  • Задайте B как переменный размер 2-мерный массив, где каждая размерность имеет верхнюю границу 64.

    coder.varsize('B', [64 64]);

  • Задайте B как массив переменного размера:

    coder.varsize('B');

    Когда вы предоставляете только первый аргумент, coder.varsize принимает что все размерности B может варьироваться и что верхней границей является size(B).

Если сигнал ввода или вывода блока MATLAB Function является переменным размером в Портах и Менеджере данных, необходимо указать, что сигнал является переменным размером. Необходимо также обеспечить верхние границы. Вы не должны использовать coder.varsize с соответствующей переменной ввода или вывода в блоке MATLAB Function. Однако, если вы задаете верхние границы с coder.varsize, они должны совпадать с верхними границами в Портах и Менеджере данных.

Задайте, какие размерности варьируются

Можно использовать функцию coder.varsize задавать, какие размерности варьируются. Например, следующий оператор задает B как массив, первая размерность которого фиксируется в 2, но чье второе измерение может вырасти до размера 16:

coder.varsize('B',[2, 16],[0 1])
.

Третий аргумент задает, какие размерности варьируются. Этот аргумент должен быть логическим вектором или двойным вектором, содержащим только нули и единицы. Размерности, которые соответствуют нулям или false имейте фиксированный размер. Размерности, которые соответствуют единицам или true отличаться по размеру. coder.varsize обычно размерности обработок размера 1, как зафиксировано. Смотрите Задают Матрицы Переменного Размера с Размерностями Singleton.

Для сигнала ввода или вывода, если вы задаете верхние границы с coder.varsize в блоке MATLAB Function они должны совпадать с верхними границами в Портах и Менеджере данных.

Позвольте переменной расти после определения фиксированных размерностей

Функциональный var_by_if задает матричный Y с фиксированными размерностями 2 на 2 перед первым использованием (где оператор Y = Y + u чтения от Y). Однако coder.varsize задает Y как матрица переменного размера, позволяя ему изменить размер на основе логики решения в else пункт:

function Y = var_by_if(u) %#codegen
if (u > 0)
    Y = zeros(2,2);
    coder.varsize('Y');
    if (u < 10)
        Y = Y + u;
    end
else
    Y = zeros(5,5);
end

Без coder.varsize, генератор кода выводит Y быть фиксированным размером, матрицей 2 на 2. Это генерирует ошибку несоответствия размера.

Задайте матрицы Переменного Размера с размерностями Singleton

Одноэлементная размерность является размерностью для который size(A,dim) = 1. Размерности Singleton фиксируются в размере когда:

  • Вы задаете размерность с верхней границей 1 дюйма coder.varsize выражения.

    Например, в этой функции, Y ведет себя как вектор с одной размерностью переменного размера:

    function Y = dim_singleton(u) %#codegen
    Y = [1 2];
    coder.varsize('Y', [1 10]);
    if (u > 0)
        Y = [Y 3];
    else
        Y = [Y u];
    end
    

  • Вы инициализируете данные переменного размера одноэлементными размерностями при помощи матричных выражений конструктора или матричных функций.

    Например, в этой функции, X и Y ведите себя как векторы, где только их вторые измерения являются переменным размером.

    function [X,Y] = dim_singleton_vects(u) %#codegen
    Y = ones(1,3);
    X = [1 4];
    coder.varsize('Y','X');
    if (u > 0)
        Y = [Y u];
    else
        X = [X u];
    end

Можно заменить это поведение при помощи coder.varsize указывать явным образом, что одноэлементные размерности варьируются. Например:

function Y = dim_singleton_vary(u) %#codegen
Y = [1 2];
coder.varsize('Y', [1 10], [1 1]);
if (u > 0)
    Y = [Y Y+u];
else
    Y = [Y Y*u];
end

В этом примере, третьем аргументе coder.varsize вектор из единиц, указывая что каждая размерность Y отличается по размеру.

Задайте поля структуры Переменного Размера

Чтобы задать поля структуры как массивы переменного размера, используйте двоеточие (:) как выражение индекса. Двоеточие (:) указывает, что всеми элементами массива является переменный размер. Например:

function y=struct_example() %#codegen

d = struct('values', zeros(1,0), 'color', 0);
data = repmat(d, [3 3]);
coder.varsize('data(:).values');

for i = 1:numel(data)
    data(i).color = rand-0.5;
    data(i).values = 1:i;
end

y = 0;
for i = 1:numel(data)
    if data(i).color > 0
        y = y + sum(data(i).values);
    end
end

Выражение coder.varsize('data(:).values') задает поле values в каждом элементе матричного data быть переменным размером.

Вот другие примеры:

  • coder.varsize('data.A(:).B')

    В этом примере, data скалярная переменная, которая содержит матричный A. Каждый элемент матричного A содержит поле B переменного размера.

  • coder.varsize('data(:).A(:).B')

    Это выражение задает поле B в каждом элементе матричного A в каждом элементе матричного data быть переменным размером.

Смотрите также

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте