addParameter

Добавьте параметр в ONNXParameters объект

Синтаксис

params = addParameter(params,name,value,type)

params = addParameter(params,name,value,type,NumDimensions)

Описание

params = addParameter(params,name,value,type) добавляет сетевой параметр, заданный nameЗначение, и type к ONNXParameters объект params. Возвращенный params объект содержит параметры модели входного параметра params вместе с добавленным параметром, сложенным последовательно. Добавленный параметр name должно быть уникальным, непустым, и отличаться от названий параметра в params.

params = addParameter(params,name,value,type,NumDimensions) добавляет сетевой параметр, заданный nameЗначениеВвод, и NumDimensions к params.

Примеры

свернуть все

Добавьте параметры в импортированную функцию модели ONNX

Этот пример использует:

Скрипт Open Live Script

Импортируйте сеть, сохраненную в формате ONNX как функция, и измените сетевые параметры.

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

Импортируйте simplenet3fc.onnx использование importONNXFunction, который возвращает ONNXParameters объект, который содержит сетевые параметры. Функция также создает новую функцию модели в текущей папке, которая содержит сетевую архитектуру. Задайте имя функции модели как simplenetFcn.

params = importONNXFunction('simplenet3fc.onnx','simplenetFcn');

A function containing the imported ONNX network has been saved to the file simplenetFcn.m.
To learn how to use this function, type: help simplenetFcn.

Отобразите параметры, которые обновляются во время обучения (params.Learnables) и параметры, которые остаются неизменными во время обучения (params.Nonlearnables).

params.Learnables

ans = struct with fields:
    imageinput_Mean: [1×1 dlarray]
             conv_W: [5×5×1×20 dlarray]
             conv_B: [20×1 dlarray]
    batchnorm_scale: [20×1 dlarray]
        batchnorm_B: [20×1 dlarray]
             fc_1_W: [24×24×20×20 dlarray]
             fc_1_B: [20×1 dlarray]
             fc_2_W: [1×1×20×20 dlarray]
             fc_2_B: [20×1 dlarray]
             fc_3_W: [1×1×20×10 dlarray]
             fc_3_B: [10×1 dlarray]

params.Nonlearnables

ans = struct with fields:
            ConvStride1004: [2×1 dlarray]
    ConvDilationFactor1005: [2×1 dlarray]
           ConvPadding1006: [4×1 dlarray]
            ConvStride1007: [2×1 dlarray]
    ConvDilationFactor1008: [2×1 dlarray]
           ConvPadding1009: [4×1 dlarray]
            ConvStride1010: [2×1 dlarray]
    ConvDilationFactor1011: [2×1 dlarray]
           ConvPadding1012: [4×1 dlarray]
            ConvStride1013: [2×1 dlarray]
    ConvDilationFactor1014: [2×1 dlarray]
           ConvPadding1015: [4×1 dlarray]

Сеть имеет параметры, которые представляют три полносвязных слоя. Можно добавить полносвязный слой в исходных параметрах params между слоями fc_2 и fc_3. Новый слой может увеличить точность классификации.

Видеть параметры сверточных слоев fc_2 и fc_3, откройте функциональный simplenetFcn модели.

open simplenetFcn

Прокрутите вниз к определениям слоя в функциональном simplenetFcn. Код ниже показов определения для слоев fc_2 и fc_3.

% Conv:
[weights, bias, stride, dilationFactor, padding, dataFormat, NumDims.fc_2] = prepareConvArgs(Vars.fc_2_W, Vars.fc_2_B, Vars.ConvStride1010, Vars.ConvDilationFactor1011, Vars.ConvPadding1012, 1, NumDims.fc_1, NumDims.fc_2_W);
Vars.fc_2 = dlconv(Vars.fc_1, weights, bias, 'Stride', stride, 'DilationFactor', dilationFactor, 'Padding', padding, 'DataFormat', dataFormat);

% Conv:
[weights, bias, stride, dilationFactor, padding, dataFormat, NumDims.fc_3] = prepareConvArgs(Vars.fc_3_W, Vars.fc_3_B, Vars.ConvStride1013, Vars.ConvDilationFactor1014, Vars.ConvPadding1015, 1, NumDims.fc_2, NumDims.fc_3_W);
Vars.fc_3 = dlconv(Vars.fc_2, weights, bias, 'Stride', stride, 'DilationFactor', dilationFactor, 'Padding', padding, 'DataFormat', dataFormat);

Назовите новый слой fc_4, потому что каждое добавленное название параметра должно быть уникальным. addParameter функция всегда добавляет новый параметр последовательно в params.Learnables или params.Nonlearnables структура. Порядок слоев в функциональном simplenetFcn модели определяет порядок, в котором выполняются слоя сети. Имена и порядок параметров не влияют на порядок выполнения.

Добавьте новый полносвязный слой fc_4 теми же параметрами как fc_2.

params = addParameter(params,'fc_4_W',params.Learnables.fc_2_W,'Learnable');
params = addParameter(params,'fc_4_B',params.Learnables.fc_2_B,'Learnable');
params = addParameter(params,'fc_4_Stride',params.Nonlearnables.ConvStride1010,'Nonlearnable');
params = addParameter(params,'fc_4_DilationFactor',params.Nonlearnables.ConvDilationFactor1011,'Nonlearnable');
params = addParameter(params,'fc_4_Padding',params.Nonlearnables.ConvPadding1012,'Nonlearnable');

Отобразите обновленные learnable и nonlearnable параметры.

params.Learnables

ans = struct with fields:
    imageinput_Mean: [1×1 dlarray]
             conv_W: [5×5×1×20 dlarray]
             conv_B: [20×1 dlarray]
    batchnorm_scale: [20×1 dlarray]
        batchnorm_B: [20×1 dlarray]
             fc_1_W: [24×24×20×20 dlarray]
             fc_1_B: [20×1 dlarray]
             fc_2_W: [1×1×20×20 dlarray]
             fc_2_B: [20×1 dlarray]
             fc_3_W: [1×1×20×10 dlarray]
             fc_3_B: [10×1 dlarray]
             fc_4_W: [1×1×20×20 dlarray]
             fc_4_B: [20×1 dlarray]

params.Nonlearnables

ans = struct with fields:
            ConvStride1004: [2×1 dlarray]
    ConvDilationFactor1005: [2×1 dlarray]
           ConvPadding1006: [4×1 dlarray]
            ConvStride1007: [2×1 dlarray]
    ConvDilationFactor1008: [2×1 dlarray]
           ConvPadding1009: [4×1 dlarray]
            ConvStride1010: [2×1 dlarray]
    ConvDilationFactor1011: [2×1 dlarray]
           ConvPadding1012: [4×1 dlarray]
            ConvStride1013: [2×1 dlarray]
    ConvDilationFactor1014: [2×1 dlarray]
           ConvPadding1015: [4×1 dlarray]
               fc_4_Stride: [2×1 dlarray]
       fc_4_DilationFactor: [2×1 dlarray]
              fc_4_Padding: [4×1 dlarray]

Измените архитектуру функции модели, чтобы отразить изменения в params таким образом, можно использовать сеть для предсказания новыми параметрами или переобучить сеть. Откройте функциональный simplenetFcn модели. Затем добавьте полносвязный слой fc_4 между слоями fc_2 и fc_3, и измените входные данные операции dlconv свертки для слоя fc_3 к Vars.fc_4.

open simplenetFcn

Код ниже показов новый слой fc_4 в его положении, а также слоях fc_2 и fc_3.

% Conv:
[weights, bias, stride, dilationFactor, padding, dataFormat, NumDims.fc_2] = prepareConvArgs(Vars.fc_2_W, Vars.fc_2_B, Vars.ConvStride1010, Vars.ConvDilationFactor1011, Vars.ConvPadding1012, 1, NumDims.fc_1, NumDims.fc_2_W);
Vars.fc_2 = dlconv(Vars.fc_1, weights, bias, 'Stride', stride, 'DilationFactor', dilationFactor, 'Padding', padding, 'DataFormat', dataFormat);

% Conv
[weights, bias, stride, dilationFactor, padding, dataFormat, NumDims.fc_4] = prepareConvArgs(Vars.fc_4_W, Vars.fc_4_B, Vars.fc_4_Stride, Vars.fc_4_DilationFactor, Vars.fc_4_Padding, 1, NumDims.fc_2, NumDims.fc_4_W);
Vars.fc_4 = dlconv(Vars.fc_2, weights, bias, 'Stride', stride, 'DilationFactor', dilationFactor, 'Padding', padding, 'DataFormat', dataFormat);

% Conv:
[weights, bias, stride, dilationFactor, padding, dataFormat, NumDims.fc_3] = prepareConvArgs(Vars.fc_3_W, Vars.fc_3_B, Vars.ConvStride1013, Vars.ConvDilationFactor1014, Vars.ConvPadding1015, 1, NumDims.fc_4, NumDims.fc_3_W);
Vars.fc_3 = dlconv(Vars.fc_4, weights, bias, 'Stride', stride, 'DilationFactor', dilationFactor, 'Padding', padding, 'DataFormat', dataFormat);

Входные параметры

свернуть все

`params` — Сетевые параметры
`ONNXParameters` объект

Сетевые параметры в виде ONNXParameters объект. params содержит сетевые параметры импортированной модели ONNX™.

`name` — Имя параметра
вектор символов | строковый скаляр

Имя параметра в виде вектора символов или строкового скаляра.

Пример: 'conv2_W'

Пример: 'conv2_Padding'

`value` — Значение параметра
числовой массив | вектор символов | строковый скаляр

Значение параметра в виде числового массива, вектора символов или строкового скаляра. Скопировать существующий слой сети (сохраненный в params), скопируйте значения параметров слоя сети.

Пример: params.Learnables.conv1_W

Пример: params.Nonlearnables.conv1_Padding

Типы данных: single | double | char | string

`type` — Тип параметра
`'Learnable'` | `'Nonlearnable'` | `'State'`

Тип параметра в виде 'Learnable', 'Nonlearnable', или 'State'.

Значение 'Learnable' задает параметр, который обновляется сетью во время обучения (например, веса и смещение свертки).
Значение 'Nonlearnable' задает параметр, который остается неизменным во время сетевого обучения (например, дополняя).
Значение 'State' задает параметр, который содержит информацию, которую помнит сеть между итерациями и обновленную через несколько учебных пакетов.

Типы данных: char | string

`NumDimensions` — Количество размерностей для каждого параметра
структура

Количество размерностей для каждого параметра в виде структуры. NumDimensions включает запаздывание одноэлементных размерностей.

Пример: params.NumDimensions.conv1_W

Пример 4

Выходные аргументы

свернуть все

`params` — Сетевые параметры
`ONNXParameters` объект

Сетевые параметры, возвращенные как ONNXParameters объект. params содержит сетевые параметры, обновленные addParameter.

Введенный в R2020b

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

addParameter

Синтаксис

Описание

Примеры

Добавьте параметры в импортированную функцию модели ONNX

Входные параметры

`params` — Сетевые параметры
`ONNXParameters` объект

`name` — Имя параметра
вектор символов | строковый скаляр

`value` — Значение параметра
числовой массив | вектор символов | строковый скаляр

`type` — Тип параметра
`'Learnable'` | `'Nonlearnable'` | `'State'`

`NumDimensions` — Количество размерностей для каждого параметра
структура

Выходные аргументы

`params` — Сетевые параметры
`ONNXParameters` объект

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

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

Поддержка

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

addParameter

Синтаксис

Описание

Примеры

Добавьте параметры в импортированную функцию модели ONNX

Входные параметры

params — Сетевые параметры ONNXParameters объект

name — Имя параметра вектор символов | строковый скаляр

value — Значение параметра числовой массив | вектор символов | строковый скаляр

type — Тип параметра 'Learnable' | 'Nonlearnable' | 'State'

NumDimensions — Количество размерностей для каждого параметра структура

Выходные аргументы

params — Сетевые параметры ONNXParameters объект

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

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

Поддержка

`params` — Сетевые параметры
`ONNXParameters` объект

`name` — Имя параметра
вектор символов | строковый скаляр

`value` — Значение параметра
числовой массив | вектор символов | строковый скаляр

`type` — Тип параметра
`'Learnable'` | `'Nonlearnable'` | `'State'`

`NumDimensions` — Количество размерностей для каждого параметра
структура

`params` — Сетевые параметры
`ONNXParameters` объект