resize3dLayer

3 次元サイズ変更層

説明

3 次元サイズ変更層は、指定された高さ、幅、および深さ、または参照入力特徴マップのサイズに合わせて、スケール係数により、3 次元入力のサイズを変更します。この層を使用するには Deep Learning Toolbox™ が必要です。

作成

構文

layer = resize3dLayer("Scale",scale)

layer = resize3dLayer("OutputSize",outputSize)

layer = resize3dLayer("EnableReferenceInput",tf)

layer = resize3dLayer(___,Name,Value)

説明

layer = resize3dLayer("Scale",scale) は、3 次元サイズ変更層を作成し、Scale プロパティを scale で指定されたスケール係数として設定します。

layer = resize3dLayer("OutputSize",outputSize) は、3 次元サイズ変更層を作成し、OutputSize プロパティを outputSize で指定された高さ、幅、および深さに設定します。

layer = resize3dLayer("EnableReferenceInput",tf) は、3 次元サイズ変更層を作成し、EnableReferenceInput プロパティを tf で指定された boolean に設定します。この値を true として指定した場合、層は、参照特徴マップを受け入れる入力を追加し、参照特徴マップのサイズに合わせて入力のサイズを変更します。

layer = resize3dLayer(___,Name,Value) は、名前と値の引数を使用して、オプションの Method、GeometricTransformMode、NearestRoundingMode、および Name の各プロパティも設定します。複数の名前と値の引数を指定できます。

例: layer = resize3dLayer("OutputSize",[128 128 36],"Method","trilinear") は、三重線形内挿を使用して入力のサイズを 128×128×36 ピクセルに変更する 3 次元サイズ変更層を作成します。

プロパティ

サイズ変更

Scale — 入力をサイズ変更するスケール係数

正の数値の 3 要素の行ベクトル

入力をサイズ変更するスケール係数。正の数値の 3 要素の行ベクトルとして指定します。スケール係数はそれぞれ行、列、および平面の次元用です。層を作成する場合、Scale をスカラーとして指定して、すべての次元に同じ値を使用できます。

OutputSize — サイズ変更した入力の出力サイズ

正の整数の 3 要素の行ベクトル

サイズ変更した入力の出力サイズ。[nrows ncols nplanes] 形式の正の整数の 3 要素行ベクトルとして指定します。2 つの要素を NaN として指定できます。その場合、層は値を自動的に計算し、入力のアスペクト比を維持します。

EnableReferenceInput — 参照特徴マップを入力として追加するかどうか

false または 0 | true または 1

参照特徴マップを入力として層に追加するかどうか。数値か logical 0 (false) または 1 (true) として指定します。この値を true として指定した場合、層は、参照特徴マップの高さ、幅、および深さに合わせて入力の高さ、幅、および深さを変更します。このサイズ変更操作によって入力のチャネル数が変わることはありません。

参照特徴マップを有効にした場合、層への入力の名前は 'in1' および 'ref' になります。ここで、'ref' は参照特徴マップの名前です。connectLayers (Deep Learning Toolbox) または disconnectLayers (Deep Learning Toolbox) を使用して層の結合または切り離しを行うときには、入力名を使用します。

Method — 内挿法

"nearest" (既定値) | "trilinear"

内挿法。最近傍内挿では "nearest"、三重線形内挿では "trilinear" として指定します。

GeometricTransformMode — 幾何学的変換モード

"half-pixel" (既定値) | "asymmetric"

入力空間から出力空間へ点をマッピングする幾何学的変換モード。"half-pixel" または "asymmetric" として指定します。

NearestRoundingMode — 最近傍内挿の丸めモード

"round" (既定値) | "floor" | "onnx-10"

最近傍内挿の丸めモード。次のいずれかとして指定します。

• "round" — MATLAB^® 関数 round と同じ丸め動作を使用します。

• "floor" — MATLAB 関数 floor と同じ丸め動作を使用します。

• "onnx-10" — ONNX™ (Open Neural Network Exchange) opset 10 Resize 演算子のサイズ変更動作を再現します。

このプロパティは、Method プロパティが "nearest" である場合に有効です。

層

Name — 層の名前

'' (既定値) | 文字ベクトル | string スカラー

層の名前。文字ベクトルまたは string スカラーとして指定します。Layer 配列入力の場合、trainnet (Deep Learning Toolbox) 関数および dlnetwork (Deep Learning Toolbox) 関数は、名前のない層に自動的に名前を割り当てます。

Resize3DLayer オブジェクトは、このプロパティを文字ベクトルとして格納します。

データ型: char | string

NumInputs — 入力の数

1 (既定値) | 2

層の入力の数。EnableReferenceInput プロパティが false の場合は 1 として指定し、EnableReferenceInput プロパティが true の場合は 2 として指定します。

データ型: double

InputNames — 入力名

{'in'} (既定値) | {'in','ref'}

層の入力名。EnableReferenceInput プロパティが false の場合は {'in'} として指定し、EnableReferenceInput プロパティが true の場合は {'in','ref'} として指定します。

データ型: cell

NumOutputs — 出力の数

読み取り専用: 1 (既定値)

この プロパティ は読み取り専用です。

層からの出力の数。1 として格納されます。この層には単一の出力のみがあります。

データ型: double

OutputNames — 出力名

読み取り専用: {'out'} (既定値)

この プロパティ は読み取り専用です。

出力名。{'out'} として格納されます。この層には単一の出力のみがあります。

データ型: cell

例

スケール係数を指定した 3 次元サイズ変更層の作成

3 次元サイズ変更層を作成します。水平方向と垂直方向のスケール係数を 2、深さ方向のスケール係数を 4 と指定します。

layer = resize3dLayer('Scale',[2 2 4])

layer = 
  Resize3DLayer with properties:

                      Name: ''
                     Scale: [2 2 4]
                OutputSize: []
      EnableReferenceInput: 0
                    Method: 'nearest'
    GeometricTransformMode: 'half-pixel'
       NearestRoundingMode: 'round'

   Learnable Parameters
    No properties.

   State Parameters
    No properties.

  Show all properties

出力サイズを指定した 3 次元サイズ変更層の作成

名前が 'resize224'、出力サイズが [224 224 224] の 3 次元サイズ変更層を作成します。

layer = resize3dLayer('OutputSize',[224 224 224],'Name','resize224')

layer = 
  Resize3DLayer with properties:

                      Name: 'resize224'
                     Scale: []
                OutputSize: [224 224 224]
      EnableReferenceInput: 0
                    Method: 'nearest'
    GeometricTransformMode: 'half-pixel'
       NearestRoundingMode: 'round'

   Learnable Parameters
    No properties.

   State Parameters
    No properties.

  Show all properties

参照ポートをもつ 3 次元サイズ変更層の作成

dlnetwork オブジェクトを作成します。

net = dlnetwork;

参照入力特徴マップを受け入れる 3 次元サイズ変更層を含む層の配列を作成します。層をネットワークに追加します。

layers = [
    image3dInputLayer([32 32 32 3],Name="image")
    resize3dLayer(EnableReferenceInput=true,Name="resize")]

layers = 
  2×1 Layer array with layers:

     1   'image'    3-D Image Input   32×32×32×3 images with 'zerocenter' normalization
     2   'resize'   Resize            nnet.cnn.layer.Resize3DLayer

net = addLayers(net,layers);

connectLayers 関数を使用して、参照特徴マップを提供する層の出力に 3 次元サイズ変更層の "ref" 入力を接続します。この例は、"ref" 入力がイメージ入力層の出力にも接続されるという自明な接続を示しています。

net = connectLayers(net,"image","resize/ref");

三重線形内挿を使用した 3 次元サイズ変更層の作成

名前が 'rescale0.5' で、スケール係数が一律 0.5 の 3 次元サイズ変更層を作成します。内挿法を三重線形内挿として指定します。

layer = resize3dLayer('Scale',0.5,'Method','trilinear','Name','rescale0.5')

layer = 
  Resize3DLayer with properties:

                      Name: 'rescale0.5'
                     Scale: [0.5000 0.5000 0.5000]
                OutputSize: []
      EnableReferenceInput: 0
                    Method: 'trilinear'
    GeometricTransformMode: 'half-pixel'
       NearestRoundingMode: 'round'

   Learnable Parameters
    No properties.

   State Parameters
    No properties.

  Show all properties

参照

[1] Open Neural Network Exchange. https://github.com/onnx/.

[2] ONNX. https://onnx.ai/.

バージョン履歴

R2020b で導入

R2021a: 特徴マップに合わせたデータのサイズ変更のサポート

resize2dLayer 層は、この層に接続された 2 番目の入力特徴マップのサイズに合わせた入力のサイズ変更をサポートするようになりました。このサイズ変更モードを使用するには、層の EnableReferenceInput プロパティを true に指定します。

参考

resize2dLayer | averagePooling3dLayer (Deep Learning Toolbox) | transposedConv3dLayer (Deep Learning Toolbox) | dlresize | importNetworkFromONNX (Deep Learning Toolbox)

トピック

• MATLAB による深層学習 (Deep Learning Toolbox)
• 畳み込みニューラル ネットワークの層の指定 (Deep Learning Toolbox)
• 深層学習層の一覧 (Deep Learning Toolbox)