resnetLayers

(非推奨) 2 次元残差ネットワークの作成

R2021b 以降

resnetLayers は推奨されません。代わりに関数 resnetNetwork を使用してください。詳細については、バージョン履歴を参照してください。

構文

lgraph = resnetLayers(inputSize,numClasses)

lgraph = resnetLayers(___,Name=Value)

説明

lgraph = resnetLayers(inputSize,numClasses) は、inputSize で指定されたイメージ入力サイズおよび numClasses で指定されたクラス数をもつ 2 次元残差ネットワークを作成します。

lgraph = resnetLayers(___,Name=Value) は、前述の構文に含まれるいずれかの入力引数を指定する 1 つ以上の名前と値の引数を使用して、残差ネットワークを作成します。たとえば、InitialNumFilters=32 は、最初の畳み込み層で 32 個のフィルターを指定します。

ヒント

事前学習済みの ResNet ニューラル ネットワークを読み込むには、関数 imagePretrainedNetwork を使用します。

例

残差ネットワークの作成

残差ネットワークを作成します。

ボトルネック アーキテクチャをもつ残差ネットワークを作成します。

imageSize = [224 224 3];
numClasses = 10;

lgraph = resnetLayers(imageSize,numClasses)

lgraph = 
  LayerGraph with properties:

     InputNames: {'input'}
    OutputNames: {'output'}
         Layers: [177x1 nnet.cnn.layer.Layer]
    Connections: [192x2 table]

このネットワークは、ResNet-50 残差ネットワークと等価です。

入力引数

inputSize — ネットワークの入力イメージのサイズ

2 要素ベクトル | 3 要素ベクトル

ネットワークの入力イメージのサイズ。次のいずれかとして指定します。

• [height, width] の形式の 2 要素ベクトル。

• [height, width, depth] の形式の 3 要素ベクトル。ここで、depth はチャネル数です。RGB イメージの場合は depth を 3 に設定し、グレースケール イメージの場合は 1 を設定します。マルチスペクトル イメージおよびハイパースペクトル イメージの場合、depth をチャネル数に設定します。

height および width の値は initialStride * poolingStride * 2^D 以上でなければなりません。ここで、D はダウンサンプリング ブロックの数です。引数 InitialStride を使用して、初期ストライドを設定します。InitialPoolingLayer が "none" に設定されている場合、プーリング ストライドは 1 になり、そうでない場合は 2 になります。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

numClasses — クラス数

1 より大きい整数

イメージ分類ネットワークのクラス数。1 より大きい整数として指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: InitialFilterSize=[5,5],InitialNumFilters=32,BottleneckType="none" は、初期フィルター サイズを 5×5 ピクセルに指定し、32 個の初期フィルターと、ボトルネック コンポーネントをもたないネットワーク アーキテクチャを指定します。

最初の層

InitialFilterSize — 最初の畳み込み層のフィルター サイズ

7 (既定値) | 正の整数 | 正の整数から成る 2 要素ベクトル

最初の畳み込み層のフィルター サイズ。次のいずれかとして指定します。

• 正の整数。フィルターの高さと幅は同じになります。たとえば、5 を指定すると、高さが 5、幅が 5 のフィルターが生成されます。

• [height, width] の形式の 2 要素ベクトル。たとえば、初期フィルター サイズとして [1 5] を指定すると、高さが 1、幅が 5 のフィルターが生成されます。

例: InitialFilterSize=[5,5]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

InitialNumFilters — 最初の畳み込み層のフィルター数

64 (既定値) | 正の整数

最初の畳み込み層のフィルター数。正の整数として指定します。初期フィルター数は、残差ネットワークに含まれる最初の畳み込み層の出力におけるチャネル (特徴マップ) の数を決定します。

例: InitialNumFilters=32

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

InitialStride — 最初の畳み込み層のストライド

2 (既定値) | 正の整数 | 正の整数から成る 2 要素ベクトル

最初の畳み込み層のストライド。次として指定します。

• 正の整数。ストライドの高さと幅は同じになります。たとえば、3 を指定すると、高さが 3、幅が 3 のストライドが生成されます。

• [height, width] の形式の 2 要素ベクトル。たとえば、初期ストライドとして [1 2] を指定すると、高さが 1、幅が 2 のストライドが生成されます。

ストライドは、入力を垂直方向および水平方向に走査するステップ サイズを定義します。

例: InitialStride=[3,3]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

InitialPoolingLayer — 最初のプーリング層

"max" (既定値) | "average" | "none"

最初の残差ブロックの前に使用する最初のプーリング層。次のいずれかとして指定します。

• "max" — 最初の残差ブロックの前に最大プーリング層を使用します。詳細については、maxPooling2dLayer を参照してください。

• "average" — 最初の残差ブロックの前に平均プーリング層を使用します。詳細については、averagePooling2dLayer を参照してください。

• "none" — 最初の残差ブロックの前にプーリング層を使用しません。

例: InitialPoolingLayer="average"

データ型: char | string

ネットワーク アーキテクチャ

ResidualBlockType — 残差ブロックのタイプ

"batchnorm-before-add" (既定値) | "batchnorm-after-add"

残差ブロックのタイプ。次のいずれかとして指定します。

• "batchnorm-before-add" — 残差ブロックの加算層の前にバッチ正規化層を追加します[1]。

• "batchnorm-after-add" — 残差ブロックの加算層の後にバッチ正規化層を追加します[2]。

引数 ResidualBlockType は、標準残差ブロックおよびダウンサンプリング残差ブロックにおけるバッチ正規化層の位置を指定します。詳細については、詳細を参照してください。

例: ResidualBlockType="batchnorm-after-add"

データ型: char | string

BottleneckType — ブロックのボトルネックのタイプ

"downsample-first-conv" (既定値) | "none"

ブロックのボトルネックのタイプ。次のいずれかとして指定します。

• "downsample-first-conv" — ダウンサンプリング残差ブロックの最初の畳み込み層でダウンサンプリングを実行するボトルネック残差ブロックを使用します。ストライドは 2 を使用します。ボトルネック残差ブロックは、チャネルの次元をダウンサンプリングするための 1 行 1 列の層、3 行 3 列の畳み込み層、およびチャネルの次元をアップサンプリングするための 1 行 1 列の層の 3 つの畳み込み層で構成されています。

  最後の畳み込み層におけるフィルター数は、最初の 2 つの畳み込み層におけるフィルター数の 4 倍になります。詳細については、NumFilters を参照してください。

• "none" — ボトルネック残差ブロックを使用しません。残差ブロックは、2 つの 3 行 3 列の畳み込み層で構成されています。

ボトルネック残差ブロックは、3 行 3 列の畳み込みの前に 1 行 1 列の畳み込みを実行し、チャネル数を 4 分の 1 に減らします。ボトルネック ブロックがあるネットワークとボトルネック ブロックがないネットワークの計算量は同程度ですが、残差結合で伝播される特徴の合計数は、ボトルネック ユニットを使用する場合の方が 4 倍多くなります。そのため、ボトルネックを使用するとネットワークの効率が向上します[1]。各残差ブロックの層の詳細については、詳細を参照してください。

例: BottleneckType="none"

データ型: char | string

StackDepth — 各スタックに含まれる残差ブロックの数

[3 4 6 3] (既定値) | 正の整数のベクトル

各スタックに含まれる残差ブロックの数。正の整数のベクトルとして指定します。たとえば、スタックの深さが [3 4 6 3] の場合、ネットワークには、それぞれ 3 つのブロック、4 つのブロック、6 つのブロック、3 つのブロックから成る 4 つのスタックが含まれます。

引数 NumFilters を使用して、各スタックの畳み込み層のフィルターの数を指定します。StackDepth の値には、NumFilters の値と同じ数の要素が含まれていなければなりません。

例: StackDepth=[9 12 69 9]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

NumFilters — 各スタックに含まれる畳み込み層のフィルターの数

[64 128 256 512] (既定値) | 正の整数のベクトル

各スタックに含まれる畳み込み層のフィルターの数。正の整数のベクトルとして指定します。

• BottleneckType を "downsample-first-conv" に設定した場合、各スタックの各ブロックに含まれる最初の 2 つの畳み込み層には、いずれも NumFilters の値で設定された数のフィルターが含まれています。最後の畳み込み層は、最初の 2 つの畳み込み層の 4 倍の数のフィルターをもちます。

  たとえば、NumFilters を [4 5] に設定し、BottleneckType を "downsample-first-conv" に設定したとします。最初のスタックでは、各ブロックに含まれる最初の 2 つの畳み込み層は 4 つのフィルターをもち、各ブロックに含まれる最後の畳み込み層は 16 個のフィルターをもちます。2 番目のスタックでは、各ブロックに含まれる最初の 2 つの畳み込み層は 5 つのフィルターをもち、最後の畳み込み層は 20 個のフィルターをもちます。

• BottleneckType を "none" に設定した場合、各スタックに含まれる畳み込み層には、NumFilters の値で設定された数のフィルターが含まれています。

NumFilters の値には、StackDepth の値と同じ数の要素が含まれていなければなりません。

NumFilters の値は、最初の残差ブロックに含まれる残差結合上の層を決定します。次のいずれかの条件が満たされた場合、残差結合上に畳み込み層が存在します。

• BottleneckType="downsample-first-conv" (既定) および InitialNumFilters が、NumFilters に含まれる最初の要素数の 4 倍に等しくない。

• BottleneckType="none" および InitialNumFilters が、NumFilters に含まれる最初の要素に等しくない。

各残差ブロックの層の詳細については、詳細を参照してください。

例: NumFilters=[32 64 126 256]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Normalization — データ正規化

"zerocenter" (既定値) | "zscore"

データが入力層を通じて順伝播されるたびに適用するデータ正規化。次のいずれかとして指定します。

• "zerocenter" — 平均を減算します。この平均は学習時に計算されます。

• "zscore" — 平均値を減算し、標準偏差で除算します。この平均と標準偏差は学習時に計算されます。

例: Normalization="zscore"

データ型: char | string

出力引数

lgraph — 残差ネットワーク

layerGraph オブジェクト

残差ネットワーク。layerGraph オブジェクトとして返されます。

詳細

残差ネットワーク

残差ネットワーク (ResNets) は深層ネットワークの一種で、"残差結合" ("スキップ" 結合または "ショートカット" 結合とも呼ばれる) をもつ基本ブロックで構成されます。この結合を使用すると、入力が主分岐の畳み込みユニットをスキップすることができ、ネットワーク内によりシンプルなパスを実装することができます。残差結合によって、パラメーターの勾配がネットワークの最後の層からより初期の層へとよりスムーズに流れるようになり、学習の初期の段階で勾配が消えてしまうという問題を軽減することができます。

残差ネットワークの構造には柔軟性があります。主なコンポーネントは、"残差ブロック" 内に組み込まれた残差結合です。残差ブロックのグループは "スタック" と呼ばれます。ResNet アーキテクチャは、初期層、それに続く残差ブロックを含むスタック、および最終層で構成されています。ネットワークは次の 3 種類の残差ブロックをもちます。

• 初期残差ブロック — このブロックは、最初のスタックの開始点に出現します。初期残差ブロックの残差結合に含まれる層は、ブロックが活性化サイズを保持するか、ダウンサンプリングを行うかを決定します。

• 標準残差ブロック — このブロックは、各スタック内の最初のダウンサンプリング残差ブロックの後に複数回出現します。標準残差ブロックは活性化サイズを保持します。

• ダウンサンプリング残差ブロック — このブロックは、各スタックの開始点に 1 回出現します。ダウンサンプリング ブロックの最初の畳み込みユニットは、係数 2 で空間次元をダウンサンプリングします。

標準的なスタックは、ダウンサンプリング残差ブロックと、それに続く m 個の標準残差ブロック (m は正の整数) をもちます。最初のスタックは、初期残差ブロックで始まる唯一のスタックです。

初期残差ブロック、標準残差ブロック、ダウンサンプリング残差ブロックには、"ボトルネック" ブロックまたは非ボトルネック ブロックを使用できます。ボトルネック残差ブロックは、3 行 3 列の畳み込みの前に 1 行 1 列の畳み込みを実行し、チャネル数を 4 分の 1 に減らします。ボトルネック ブロックがあるネットワークとボトルネック ブロックがないネットワークの計算量は同程度ですが、残差結合で伝播される特徴の合計数は、ボトルネック ユニットを使用する場合の方が 4 倍多くなります。そのため、ボトルネック ブロックを使用するとネットワークの効率が向上します。

各ブロック内部の層は、設定するブロックのタイプとオプションによって決まります。

ブロックの層

名前	最初の層	初期残差ブロック	標準残差ブロック (BottleneckType="downsample-first-conv")	標準残差ブロック (BottleneckType="none")	ダウンサンプリング残差ブロック	最後の層
説明	残差ネットワークは、以下の順序で並んだ以下の層で始まります。 imageInputLayer convolution2dLayer batchNormalizationLayer reluLayer (オプション) プーリング層 (最大、平均、またはなし) オプションのプーリング層を設定するには、引数 InitialPoolingLayer を使用します。	初期残差ブロックの主分岐は、標準残差ブロックと同じ層をもちます。 InitialNumFilters および NumFilters の値は、残差結合上の層を決定します。次のいずれかの条件が満たされた場合、残差結合は、[1,1] のフィルターおよび [1,1] のストライドがある畳み込み層をもちます。 BottleneckType="downsample-first-conv" (既定) および InitialNumFilters が、NumFilters に含まれる最初の要素数の 4 倍に等しくない。 BottleneckType="none" および InitialNumFilters が、NumFilters に含まれる最初の要素に等しくない。 ResidualBlockType が "batchnorm-before-add" に設定されている場合、残差結合にはバッチ正規化層も含まれます。	ボトルネック ユニットをもつ標準残差ブロックには、以下の層が以下の順序で含まれます。 [1,1] のフィルターおよび [1,1] のストライドをもつ convolution2dLayer batchNormalizationLayer reluLayer [3,3] のフィルターおよび [1,1] のストライドをもつ convolution2dLayer batchNormalizationLayer reluLayer [1,1] のフィルターおよび [1,1] のストライドをもつ convolution2dLayer batchNormalizationLayer additionLayer reluLayer 標準ブロックには、前のブロックの出力から加算層への残差結合が含まれます。 加算層の位置を設定するには、引数 ResidualBlockType を使用します。	ボトルネック ユニットをもたない標準残差ブロックには、以下の層が以下の順序で含まれます。 [3,3] のフィルターおよび [1,1] のストライドをもつ convolution2dLayer batchNormalizationLayer reluLayer [3,3] のフィルターおよび [1,1] のストライドをもつ convolution2dLayer batchNormalizationLayer additionLayer reluLayer 標準ブロックには、前のブロックの出力から加算層への残差結合が含まれます。 加算層の位置を設定するには、引数 ResidualBlockType を使用します。	ダウンサンプリング残差ブロックは (ボトルネックがある、またはボトルネックがない) 標準ブロックと同じですが、残差結合上の最初の畳み込み層と加算層に [2,2] のストライドをもちます。 残差結合上の層は、ResidualBlockType の値によって決まります。 ResidualBlockType が "batchnorm-before-add" に設定されている場合、2 番目の分岐には、[1,1] のフィルター、[2,2] のストライド、および batchNormalizationLayer をもつ convolution2dLayer が含まれます。 ResidualBlockType が "batchnorm-after-add" に設定されている場合、2 番目の分岐には、[1,1] のフィルター、[2,2] のストライドをもつ convolution2dLayer が含まれます。 ダウンサンプリング ブロックは、入力の高さと幅を半分にし、チャネルの数を増やします。	残差ネットワークは、以下の順序で並んだ以下の層で終了します。 globalAveragePooling2dLayer fullyConnectedLayer softmaxLayer classificationLayer
可視化の例		ボトルネックをもたず、加算層の前にバッチ正規化層があるネットワークの初期残差ブロックの例。	ボトルネックをもち、加算層の前にバッチ正規化層があるネットワークの標準残差ブロックの例。	ボトルネックをもたず、加算層の前にバッチ正規化層があるネットワークの標準残差ブロックの例。	ボトルネックをもたず、加算層の前にバッチ正規化層があるネットワークのダウンサンプリング残差ブロックの例。

畳み込み層と全結合層の重みを初期化するには、He 重み初期化メソッドを使用します[3]。詳細については、convolution2dLayer を参照してください。

ヒント

• 小さなイメージを扱うには、InitialPoolingLayer オプションを "none" に設定し、初期プーリング層を削除してダウンサンプリングの量を減らします。

• 残差ネットワークには、通常、ResNet-"X" という名前が付けられています。ここで、"X" はネットワークの "深さ" です。ネットワークの深さは、入力層から出力層までのパスにある逐次畳み込み層または全結合層の最大数として定義されます。ネットワークの深さを計算するには、次の式を使用します。

  $$\text{depth = }\{\begin{array}{c}1+2{\displaystyle \sum }_{i=1}^N{s}_i+1\text{ If no bottleneck}\\ 1+3{\displaystyle \sum }_{i=1}^N{s}_i+1\text{ If bottleneck}\end{array}\text{ ,}$$

  ここで、s_i はスタック i の深さです。

  深さが同じネットワークに異なるネットワーク アーキテクチャを使用できます。たとえば、ボトルネックをもつ (またはもたない) ResNet-14 アーキテクチャを作成できます。

  resnet14Bottleneck = resnetLayers([224 224 3],10, ...
  StackDepth=[2 2], ...
  NumFilters=[64 128]);
  
  resnet14NoBottleneck = resnetLayers([224 224 3],10, ...
  BottleneckType="none", ...
  StackDepth=[2 2 2], ...
  NumFilters=[64 128 256]);

  ボトルネック アーキテクチャと非ボトルネック アーキテクチャの間の関係は、ボトルネックをもつネットワークとボトルネックをもたないネットワークの深さの違いにも現れています。

  resnet50Bottleneck = resnetLayers([224 224 3],10);
  
  resnet34NoBottleneck = resnetLayers([224 224 3],10, ... 
  BottleneckType="none");
  

参照

[1] He, Kaiming, Xiangyu Zhang, Shaoqing Ren, and Jian Sun. “Deep Residual Learning for Image Recognition.” Preprint, submitted December 10, 2015. https://arxiv.org/abs/1512.03385.

[2] He, Kaiming, Xiangyu Zhang, Shaoqing Ren, and Jian Sun. “Identity Mappings in Deep Residual Networks.” Preprint, submitted July 25, 2016. https://arxiv.org/abs/1603.05027.

[3] He, Kaiming, Xiangyu Zhang, Shaoqing Ren, and Jian Sun. "Delving Deep into Rectifiers: Surpassing Human-Level Performance on ImageNet Classification." In Proceedings of the 2015 IEEE International Conference on Computer Vision, 1026–1034. Washington, DC: IEEE Computer Vision Society, 2015.

拡張機能

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

コード生成で残差ネットワークを使用できます。まず、関数 resnetLayers を使用してネットワークを作成します。その後、関数 trainNetwork を使用してネットワークに学習させます。ネットワークに学習させて評価したら、GPU Coder™ を使用して DAGNetwork オブジェクトのコードを生成できます。

バージョン履歴

R2021b で導入

R2024a: 非推奨

R2024a 以降、resnetLayers は非推奨となりました。代わりに resnetNetwork を使用してください。

resnetLayers のサポートを削除する予定はありません。ただし、resnetNetwork は次の利点がある dlnetwork オブジェクトを返すため、代わりにこのオブジェクトを使うことを推奨します。

• dlnetwork オブジェクトは、ネットワークの構築、予測、組み込み学習、可視化、圧縮、検証、およびカスタム学習ループをサポートする統合されたデータ型です。

• dlnetwork オブジェクトは、ユーザーが作成したり外部のプラットフォームからインポートしたりできる、さまざまなネットワーク アーキテクチャをサポートしています。

• 関数 trainnet は dlnetwork オブジェクトをサポートしているため、損失関数を簡単に指定できます。組み込みの損失関数を選択するか、カスタム損失関数を指定できます。

• dlnetwork オブジェクトを使用した学習と予測は、通常、LayerGraph と trainNetwork を使用したワークフローよりも高速です。

関数 resnetNetwork の構文および引数は、関数 resnetLayers と同じです。関数 resnetLayers の代表的な使用法と、代わりに関数 resnetNetwork を使用するためのコードの更新方法を、次の表に示します。

非推奨	推奨
lgraph = resnetLayers(inputSize,numClasses);	net = resnetNetwork(inputSize,numClasses);
lgraph = resnetLayers(inputSize,numClasses,BottleneckType="none");	net = resnetNetwork(inputSize,numClasses,BottleneckType="none");

参考

resnetNetwork | resnet3dNetwork | trainnet | trainingOptions | dlnetwork

トピック

• イメージ分類用の残差ネットワークの学習
• 事前学習済みの深層ニューラル ネットワーク
• カスタム学習ループを使用したネットワークの学習