Main Content

setL2Factor

계층의 학습 가능한 파라미터에 대한 L2 정규화 인자 설정

페이지 내 모두 축소

구문

layerUpdated = setL2Factor(layer,parameterName,factor)
layerUpdated = setL2Factor(layer,parameterPath,factor)
netUpdated = setL2Factor(net,layerName,parameterName,factor)
netUpdated = setL2Factor(net,parameterPath,factor)

설명

예제

layerUpdated = setL2Factor(layer,parameterName,factor)는 layer에서 이름이 parameterName인 파라미터에 대한 L2 정규화 인자를 factor로 설정합니다.

내장 계층의 경우, 상응하는 속성을 사용하여 L2 정규화 인자를 직접 설정할 수 있습니다. 예를 들어, convolution2dLayer 계층의 경우, 구문 layer = setL2Factor(layer,'Weights',factor)는 layer.WeightL2Factor = factor와 동일합니다.

layerUpdated = setL2Factor(layer,parameterPath,factor)는 경로 parameterPath로 지정된 파라미터에 대한 L2 정규화 인자를 설정합니다. 파라미터가 사용자 지정 계층의 dlnetwork 객체에 있는 경우 이 구문을 사용하십시오.

netUpdated = setL2Factor(net,layerName,parameterName,factor)는 지정된 dlnetwork 객체에 대해 이름이 layerName인 계층에서 이름이 parameterName인 파라미터에 대한 L2 정규화 인자를 설정합니다.

netUpdated = setL2Factor(net,parameterPath,factor)는 경로 parameterPath로 지정된 파라미터에 대한 L2 정규화 인자를 설정합니다. 파라미터가 중첩 계층에 있는 경우 이 구문을 사용하십시오.

예제

모두 축소

라이브 스크립트 열기

계층의 학습 가능한 파라미터에 대한 L2 정규화 인자를 설정하고 가져옵니다.

이 예제에 지원 파일로 첨부되어 있는 사용자 지정 계층 preluLayer를 포함하는 계층 배열을 만듭니다. 이 계층에 액세스하려면 이 예제를 라이브 스크립트로 여십시오.

사용자 지정 계층 preluLayer를 넣어 계층 배열을 만듭니다.

layers = [ ...
    imageInputLayer([28 28 1])
    convolution2dLayer(5,20)
    batchNormalizationLayer
    preluLayer
    fullyConnectedLayer(10)
    softmaxLayer
    classificationLayer];

preluLayer의 학습 가능한 파라미터 Alpha에 대한 L2 정규화 인자를 2로 설정합니다. 

layers(4) = setL2Factor(layers(4),"Alpha",2);

업데이트된 L2 정규화 인자를 표시합니다.

factor = getL2Factor(layers(4),"Alpha")
factor = 2
라이브 스크립트 열기

중첩 계층의 학습 가능한 파라미터에 대한 L2 정규화 인자를 설정하고 가져옵니다.

이 예제에 지원 파일로 첨부되어 있는 사용자 지정 계층 residualBlockLayer를 사용하여 잔차 블록 계층을 만듭니다. 이 파일에 액세스하려면 이 예제를 라이브 스크립트로 여십시오.

numFilters = 64;
layer = residualBlockLayer(numFilters)
layer = 
  residualBlockLayer with properties:

       Name: ''

   Learnable Parameters
    Network: [1x1 dlnetwork]

   State Parameters
    No properties.

  Show all properties

중첩 신경망의 계층을 봅니다.

layer.Network.Layers
ans = 
  7x1 Layer array with layers:

     1   'conv_1'        2-D Convolution       64 3x3 convolutions with stride [1  1] and padding 'same'
     2   'groupnorm_1'   Group Normalization   Group normalization
     3   'relu_1'        ReLU                  ReLU
     4   'conv_2'        2-D Convolution       64 3x3 convolutions with stride [1  1] and padding 'same'
     5   'groupnorm_2'   Group Normalization   Group normalization
     6   'add'           Addition              Element-wise addition of 2 inputs
     7   'relu_2'        ReLU                  ReLU

setL2Factor 함수를 사용하여, 계층 'conv_1'의 학습 가능한 파라미터 'Weights'에 대한 L2 정규화 인자를 2로 설정합니다.

factor = 2;
layer = setL2Factor(layer,'Network/conv_1/Weights',factor);

getL2Factor 함수를 사용하여, 업데이트된 L2 정규화 인자를 가져옵니다.

factor = getL2Factor(layer,'Network/conv_1/Weights')
factor = 2
라이브 스크립트 열기

dlnetwork 객체의 학습 가능한 파라미터에 대한 L2 정규화 인자를 설정하고 가져옵니다.

dlnetwork 객체를 만듭니다.

layers = [
    imageInputLayer([28 28 1],'Normalization','none','Name','in')
    convolution2dLayer(5,20,'Name','conv')
    batchNormalizationLayer('Name','bn')
    reluLayer('Name','relu')
    fullyConnectedLayer(10,'Name','fc')
    softmaxLayer('Name','sm')];

lgraph = layerGraph(layers);

dlnet = dlnetwork(lgraph);

setL2Factor 함수를 사용하여, 컨벌루션 계층의 학습 가능한 파라미터 'Weights'에 대한 L2 정규화 인자를 2로 설정합니다.

factor = 2;
dlnet = setL2Factor(dlnet,'conv','Weights',factor);

getL2Factor 함수를 사용하여, 업데이트된 L2 정규화 인자를 가져옵니다.

factor = getL2Factor(dlnet,'conv','Weights')
factor = 2
라이브 스크립트 열기

dlnetwork 객체에 있는 중첩 계층의 학습 가능한 파라미터에 대한 L2 정규화 인자를 설정하고 가져옵니다.

이 예제에 지원 파일로 첨부되어 있는 사용자 지정 계층 residualBlockLayer를 포함하는 dlnetwork 객체를 만듭니다. 이 파일에 액세스하려면 이 예제를 라이브 스크립트로 여십시오.

inputSize = [224 224 3];
numFilters = 32;
numClasses = 5;

layers = [
    imageInputLayer(inputSize,'Normalization','none','Name','in')
    convolution2dLayer(7,numFilters,'Stride',2,'Padding','same','Name','conv')
    groupNormalizationLayer('all-channels','Name','gn')
    reluLayer('Name','relu')
    maxPooling2dLayer(3,'Stride',2,'Name','max')
    residualBlockLayer(numFilters,'Name','res1')
    residualBlockLayer(numFilters,'Name','res2')
    residualBlockLayer(2*numFilters,'Stride',2,'IncludeSkipConvolution',true,'Name','res3')
    residualBlockLayer(2*numFilters,'Name','res4')
    residualBlockLayer(4*numFilters,'Stride',2,'IncludeSkipConvolution',true,'Name','res5')
    residualBlockLayer(4*numFilters,'Name','res6')
    globalAveragePooling2dLayer('Name','gap')
    fullyConnectedLayer(numClasses,'Name','fc')
    softmaxLayer('Name','sm')];

dlnet = dlnetwork(layers);

dlnetwork 객체의 Learnables 속성은 신경망의 학습 가능한 파라미터를 포함하는 테이블입니다. 테이블은 중첩 계층의 파라미터를 개별 행에 포함합니다. 계층 "res1"의 학습 가능한 파라미터를 봅니다.

learnables = dlnet.Learnables;
idx = learnables.Layer == "res1";
learnables(idx,:)
ans=8×3 table
    Layer              Parameter                     Value       
    ______    ____________________________    ___________________

    "res1"    "Network/conv_1/Weights"        {3x3x32x32 dlarray}
    "res1"    "Network/conv_1/Bias"           {1x1x32    dlarray}
    "res1"    "Network/groupnorm_1/Offset"    {1x1x32    dlarray}
    "res1"    "Network/groupnorm_1/Scale"     {1x1x32    dlarray}
    "res1"    "Network/conv_2/Weights"        {3x3x32x32 dlarray}
    "res1"    "Network/conv_2/Bias"           {1x1x32    dlarray}
    "res1"    "Network/groupnorm_2/Offset"    {1x1x32    dlarray}
    "res1"    "Network/groupnorm_2/Scale"     {1x1x32    dlarray}

setL2Factor 함수를 사용하여, 계층 "res1"에 대해 계층 'conv_1'의 학습 가능한 파라미터 'Weights'에 대한 L2 정규화 인자를 2로 설정합니다.

factor = 2;
dlnet = setL2Factor(dlnet,'res1/Network/conv_1/Weights',factor);

getL2Factor 함수를 사용하여, 업데이트된 L2 정규화 인자를 가져옵니다.

factor = getL2Factor(dlnet,'res1/Network/conv_1/Weights')
factor = 2

입력 인수

모두 축소

입력 계층으로, 스칼라 Layer 객체로 지정됩니다.

파라미터 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파라미터에 대한 L2 정규화 인자로, 음이 아닌 스칼라로 지정됩니다.

이 인자에 전역 L2 정규화 인자를 곱하여 지정된 파라미터에 대한 L2 정규화 인자가 결정됩니다. 예를 들어, factor가 2인 경우, 지정된 파라미터에 대한 L2 정규화 인자는 전역 L2 정규화 인자의 2배입니다. 전역 L2 정규화 인자는 trainingOptions 함수를 사용하여 지정할 수 있습니다.

예: 2

중첩 계층의 파라미터 경로로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 중첩 계층은 그 자체가 계층 그래프를 학습 가능한 파라미터로 정의하는 사용자 지정 계층입니다.

setL2Factor에 대한 입력값이 중첩 계층인 경우 파라미터 경로는 "propertyName/layerName/parameterName" 형식을 갖습니다. 여기서,

  • propertyName은 dlnetwork 객체를 포함하는 속성의 이름입니다.

  • layerName은 dlnetwork 객체에 있는 계층의 이름입니다.

  • parameterName은 파라미터의 이름입니다.

중첩 계층의 수준이 여러 개인 경우, "propertyName1/layerName1/.../propertyNameN/layerNameN/parameterName" 형식을 사용하여 각 수준을 지정하십시오. 여기서 propertyName1과 layerName1은 setL2Factor 함수에 대한 입력값의 계층에 대응되고, 그 이후 부분은 더 깊은 수준에 대응됩니다.

예: setL2Factor에 대한 계층 입력값의 경우, 경로 "Network/conv1/Weights"는 layer.Network로 지정된 dlnetwork 객체에서 이름이 "conv1"인 계층의 "Weights" 파라미터를 지정합니다.

setL2Factor에 대한 입력값이 dlnetwork 객체이고 원하는 파라미터가 중첩 계층에 있는 경우, 파라미터 경로는 "layerName1/propertyName/layerName/parameterName" 형식을 갖습니다. 여기서,

  • layerName1은 입력값 dlnetwork 객체에 있는 계층의 이름입니다.

  • propertyName은 dlnetwork 객체를 포함하는 계층의 속성입니다.

  • layerName은 dlnetwork 객체에 있는 계층의 이름입니다.

  • parameterName은 파라미터의 이름입니다.

중첩 계층의 수준이 여러 개인 경우, "layerName1/propertyName1/.../layerNameN/propertyNameN/layerName/parameterName" 형식을 사용하여 각 수준을 지정하십시오. 여기서 layerName1과 propertyName1은 setL2Factor 함수에 대한 입력값의 계층에 대응되고, 그 이후 부분은 더 깊은 수준에 대응됩니다.

예: setL2Factor에 대한 dlnetwork 입력값의 경우, 경로 "res1/Network/conv1/Weights"는 layer.Network로 지정된 dlnetwork 객체에서 이름이 "conv1"인 계층의 "Weights" 파라미터를 지정합니다. 여기서 layer는 입력 신경망 net에서 이름이 "res1"인 계층입니다.

데이터형: char | string

신경망으로, dlnetwork 객체로 지정됩니다.

계층 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

데이터형: char | string

출력 인수

모두 축소

업데이트된 계층으로, Layer로 반환됩니다.

업데이트된 신경망으로, dlnetwork로 반환됩니다.

버전 내역

R2017b에 개발됨

참고 항목

| | | |

도움말 항목