permuteLayer

並べ替え層

R2025a 以降

説明

並べ替え層は、データの次元を並べ替えます。

作成

構文

layer = permuteLayer(dimorder)

layer = permuteLayer(dimorder,Name=name)

説明

layer = permuteLayer(dimorder) は、並べ替え層を作成し、DimensionOrder プロパティを設定します。

layer = permuteLayer(dimorder,Name=name) は、名前と値の引数を使用して、オプションの Name プロパティも設定します。

プロパティ

並べ替え

DimensionOrder — 次元の順序

正の整数の行ベクトル

このプロパティは、作成後、読み取り専用になります。

次元の順序。正の整数から成る行ベクトルとして指定します。

この層は、層の出力データの次元 i が層の入力データの次元 DimensionOrder(i) と一致するように入力データを並べ替えます。層の入力データに DimensionOrder で指定されたよりも多くの次元がある場合、この層は追加の次元を変更しません。

PermuteLayer はこのプロパティを double として保存します。

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

層

Name — 層の名前

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

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

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

データ型: char | string

NumInputs — 入力の数

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

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

層への入力の数。1 として格納されます。この層は単一の入力のみを受け入れます。

データ型: double

InputNames — 入力名

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

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

入力名。{'in'} として格納されます。この層は単一の入力のみを受け入れます。

データ型: cell

NumOutputs — 出力の数

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

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

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

データ型: double

OutputNames — 出力名

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

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

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

データ型: cell

例

並べ替え層の作成

4 次元データの 1 次元目と 3 次元目を入れ替える並べ替え層を作成します。

layer = permuteLayer([3 2 1 4])

layer = 
  PermuteLayer with properties:

              Name: ''

   Hyperparameters
    DimensionOrder: [3 2 1 4]

アルゴリズム

層の入力形式と出力形式

層配列内または層グラフ内の層は、形式を整えた dlarray オブジェクトとして後続の層にデータを渡します。dlarray オブジェクトの形式は文字列で、各文字はデータ内の対応する次元を表します。この形式には次の文字が 1 つ以上含まれています。

• "S" — 空間

• "C" — チャネル

• "B" — バッチ

• "T" — 時間

• "U" — 指定なし

たとえば、4 次元配列として表された 2 次元イメージ データがあり、最初の 2 つの次元がイメージの空間次元に対応し、3 番目の次元がイメージのチャネルに対応し、4 番目の次元がバッチ次元に対応している場合、このイメージ データは "SSCB" (空間、空間、チャネル、バッチ) という形式で記述できます。

PermuteLayer オブジェクトは、形式を整えていない入力データ、または "U" (指定なし) 次元のみを含む形式の入力データをサポートします。入力の形式が整えられていない場合、出力の形式も整えられません。それ以外の場合、出力は "U" (指定なし) 次元のみの形式になります。

複素数

PermuteLayer オブジェクトは、複素数値の入力と出力をサポートします。この層は、複素数値の入力に対して実数値の入力に対する演算と同じように基となる演算を適用します。この層は、結果が複素数となった場合は複素数値のデータを出力します。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

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

• コード生成において、層の入力データは形式を整えた dlarray オブジェクトでなければなりません。

GPU コード生成

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

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

• GPU コード生成において、層の入力データは形式を整えた dlarray オブジェクトでなければなりません。

バージョン履歴

R2025a で導入

参考

reshapeLayer | dlnetwork | trainingOptions | trainnet | functionLayer | crop2dLayer | crop3dLayer | complexToRealLayer | realToComplexLayer

トピック

• 分類用のシンプルな深層学習ニューラル ネットワークの作成
• 回帰用の畳み込みニューラル ネットワークの学習
• MATLAB による深層学習
• 深層学習層の一覧