PyTorch torch.nn.TransformerEncoder 関数

PyTorch torch.nn 参考手册PyTorch torch.nn リファレンスマニュアル


torch.nn.TransformerEncoderPyTorch の Transformer エンコーダーモジュールです。

複数の TransformerEncoderLayer で構成され、入力シーケンスを処理するために使用されます。

関数定義

torch.nn.TransformerEncoder(encoder_layer, num_layers, norm=None)

パラメータ

  • encoder_layer: エンコーダーレイヤー
  • num_layers: レイヤー数

使用例

例 1: 基本的な使い方

実例

import torch
import torch.nn as nn

# 単一のエンコーダーレイヤー
encoder_layer = nn.TransformerEncoderLayer(d_model=512, nhead=8, batch_first=True)

# 完全なエンコーダー
transformer_encoder = nn.TransformerEncoder(encoder_layer, num_layers=6)

# 入力
x = torch.randn(32, 100, 512)  # batch, seq, d_model
output = transformer_encoder(x)

print("入力形状:", x.shape)
print("出力形状:", output.shape)

例 2: テキスト分類

実例

import torch
import torch.nn as nn

class TransformerClassifier(nn.Module):
    def __init__(self, vocab_size, d_model=256, nhead=4, num_layers=4):
        super(TransformerClassifier, self).__init__()
        self.embedding = nn.Embedding(vocab_size, d_model)
        self.pos_encoder = nn.Parameter(torch.randn(1, 512, d_model) * 0.1)

        encoder_layer = nn.TransformerEncoderLayer(d_model, nhead, batch_first=True)
        self.encoder = nn.TransformerEncoder(encoder_layer, num_layers)
        self.fc = nn.Linear(d_model, 10)

    def forward(self, x):
        # 簡単な位置エンコーディング
        x = self.embedding(x) + self.pos_encoder[:, :x.size(1), :]
        x = self.encoder(x)
        # 最初の token を取得
        return self.fc(x[:, 0, :])

model = TransformerClassifier(10000)
x = torch.randint(0, 10000, (32, 100))
output = model(x)

print("出力形状:", output.shape)

使用シーン

  • BERT: エンコーダーの基礎
  • テキスト分類
  • 特徴抽出

PyTorch torch.nn 参考手册PyTorch torch.nn リファレンスマニュアル

その他の拡張