Squeezeformerを理解したい
Squeezeformerの詳細解説
1. 全体構造の概要
Squeezeformerは音声認識などのシーケンス処理のために設計された効率的なアーキテクチャです。入力データ形状は (batch_size, sequence_length, channel_size) となっており、例えば: - batch_size = 2 (2つのデータを同時処理) - sequence_length = 16 (時系列の長さ) - channel_size = 64 (各時点での特徴量の次元)
全体コード
import torch import torch.nn as nn class GLUMlp(nn.Module): def __init__(self, dim_expand, dim): super(GLUMlp, self).__init__() self.dense_1 = nn.Linear(dim, dim_expand) self.glu = GLU() self.dense_2 = nn.Linear(dim_expand // 2, dim) def forward(self, x): x = self.dense_1(x) x = self.glu(x) x = self.dense_2(x) return x class ScaleBias(nn.Module): def __init__(self, num_features): super(ScaleBias, self).__init__() self.scale = nn.Parameter(torch.ones(num_features)) self.bias = nn.Parameter(torch.zeros(num_features)) def forward(self, x): return self.scale * x + self.bias class GLU(nn.Module): def forward(self, x): a, b = x.chunk(2, dim=-1) return a * torch.sigmoid(b) class ECA(nn.Module): def __init__(self, kernel_size=5): super(ECA, self).__init__() self.conv = nn.Conv1d(1, 1, kernel_size=kernel_size, padding=(kernel_size - 1) // 2, bias=False) def forward(self, x): y = torch.mean(x, dim=-1, keepdim=True) y = self.conv(y.transpose(1, 2)) y = torch.sigmoid(y).transpose(1, 2) return x * y class Conv1DBlockSqueezeformer(nn.Module): def __init__(self, channel_size, kernel_size, dilation_rate=1, expand_ratio=4, se_ratio=0.25, activation='swish'): super(Conv1DBlockSqueezeformer, self).__init__() self.expand_ratio = expand_ratio self.activation = torch.nn.SiLU() expanded_dim = channel_size * expand_ratio # Linear層でチャンネル数を拡張 self.expand = nn.Linear(channel_size, expanded_dim) # Depthwise Convolution self.dwconv = nn.Conv1d(expanded_dim, expanded_dim, kernel_size, dilation=dilation_rate, padding=(kernel_size - 1) // 2, groups=expanded_dim) self.bn = nn.BatchNorm1d(expanded_dim) self.eca = ECA() # Projection層でチャンネル数を元に戻す self.project = nn.Linear(expanded_dim, channel_size) # FFN部分 self.ffn = GLUMlp(channel_size * 4, channel_size) self.layer_norm_2 = nn.LayerNorm(channel_size) self.scale_bias_1 = ScaleBias(channel_size) self.scale_bias_2 = ScaleBias(channel_size) def forward(self, x): # 最初のスキップ接続のために入力を保存 skip = x # チャンネル数を拡張 x = self.expand(x) x = self.activation(x) # Depthwise Convolution用にテンソルの次元を入れ替え x = x.permute(0, 2, 1) # (batch, sequence, channels) -> (batch, channels, sequence) x = self.dwconv(x) x = self.bn(x) x = x.permute(0, 2, 1) # (batch, channels, sequence) -> (batch, sequence, channels) # ECA attention x = self.eca(x) # チャンネル数を元に戻す x = self.project(x) x = self.scale_bias_1(x) # 最初のスキップ接続 x = skip + x # FFN部分 residual = x x = self.ffn(x) x = self.scale_bias_2(x) x = self.layer_norm_2(x + residual) return x
2. 各モジュールの詳細解説
2.1 GLU (Gated Linear Unit)
class GLU(nn.Module): def forward(self, x): a, b = x.chunk(2, dim=-1) return a * torch.sigmoid(b)
なぜGLUが必要か?
入力を2つに分割し、一方をゲート(門番)として使用
sigmoid(b)は0〜1の値を出力し、どの特徴を どれだけ通すか を制御
例え: 100個の特徴があるとき、重要な特徴は1に近い値、不要な特徴は0に近い値で乗算
2.2 GLUMlp (Gated Linear Unit MLP)
class GLUMlp(nn.Module): def __init__(self, dim_expand, dim): self.dense_1 = nn.Linear(dim, dim_expand) self.glu = GLU() self.dense_2 = nn.Linear(dim_expand // 2, dim)
なぜこの構造か?
dense_1: 特徴空間を拡大(例:64→256)
より豊かな表現を可能に
GLUで半分に分割されることを考慮して2倍の大きさに
GLU: 特徴の選択的な活性化
dense_2: 選択された特徴を元の次元に圧縮
GLUで半分になった次元(256→128)を元の次元(64)に
2.3 ECA (Efficient Channel Attention)
class ECA(nn.Module): def __init__(self, kernel_size=5): self.conv = nn.Conv1d(1, 1, kernel_size=kernel_size, padding=(kernel_size - 1) // 2, bias=False)
なぜECAが必要か?
チャンネル間の相関を効率的に捉える
torch.mean(): 各チャンネルの平均を計算 conv1d: 近隣チャンネル間の関係性を学習 sigmoid: 0〜1の重みに変換
計算効率が良い
従来のSENetと比べてパラメータ数が少ない kernel_size=5 は5つの近傍チャンネルだけを見る
2.4 ScaleBias
class ScaleBias(nn.Module): def __init__(self, num_features): self.scale = nn.Parameter(torch.ones(num_features)) self.bias = nn.Parameter(torch.zeros(num_features))
なぜScaleBiasが必要か?
各特徴量のスケールとバイアスを学習可能に
例: ある特徴が小さすぎる/大きすぎる場合に適正な範囲に調整
LayerNormとは異なり、バッチ全体ではなく個別に調整
3. メインの処理フロー (Conv1DBlockSqueezeformer)
3.1 Expansion Phase
skip = x # 元の入力を保存 x = self.expand(x) # チャンネル数を拡張 x = self.activation(x) # 非線形変換
なぜこの順序か?
skip保存: 後でスキップ接続するため
拡張: より豊かな特徴表現のため
活性化: 非線形性の導入
3.2 Convolution Phase
x = x.permute(0, 2, 1) # 次元入れ替え x = self.dwconv(x) # Depthwise畳み込み x = self.bn(x) # バッチ正規化 x = x.permute(0, 2, 1) # 次元を戻す
なぜこの順序か?
permute: Conv1dは(batch, channel, sequence)の形状を要求
dwconv: 各チャンネルを独立して処理
bn: 数値の安定化
permute: 元の形状に戻す
3.3 Attention & Projection Phase
x = self.eca(x) # チャンネル注意機構 x = self.project(x) # 次元圧縮 x = self.scale_bias_1(x) x = skip + x # スキップ接続
なぜこの順序か?
eca: 重要なチャンネルを強調
project: 情報を圧縮
scale_bias: 特徴量の調整
skip接続: 勾配消失を防ぎ、元の情報を保持
3.4 FFN Phase
residual = x x = self.ffn(x) x = self.scale_bias_2(x) x = self.layer_norm_2(x + residual)
なぜこの順序か?
residual保存: 2つ目のスキップ接続用
ffn: 最終的な特徴変換
scale_bias: 特徴量の再調整
layer_norm: 出力の正規化
4. 設計の利点
計算効率
Depthwise Convolutionで計算量削減
ECAで効率的な注意機構を実現
表現力
2段階のスキップ接続で深い層でも学習可能 拡張→処理→圧縮の流れで豊かな特徴表現
安定性
BatchNormとLayerNormで数値の安定化 ScaleBiasで細かな調整が可能
アーキテクチャ全体の処理
まず広い空間(拡張)で特徴を見つけやすくする
各特徴を個別に処理(Depthwise Conv)
重要な特徴に注目(Attention)
重要な情報を凝縮(Projection)
元の情報も保持(Skip Connection)
最終的な特徴抽出(FFN)
数値の安定化(LayerNorm)
これは、例えば次のような流れに似ています:
大きな紙に詳細なメモを取る(拡張)
メモの各部分を個別に見直す(Depthwise Conv)
重要な部分に蛍光ペンで印をつける(Attention)
要点をコンパクトにまとめる(Projection)
元のメモも残しておく(Skip Connection)
まとめた内容をさらに整理する(FFN)
全体を見やすく整える(LayerNorm)
各ステップの順序とその意図
広い空間での特徴探索(拡張): 最初に線形変換でチャンネル数を広げる(expand)ことで、特徴量の表現力を向上させます。この拡張により、後続の処理で複雑な特徴を捕捉しやすくなります。これを最初に行うことで、次に行うDepthwise Convolutionが十分に高次元な特徴を持つデータを扱えるようになります。
局所特徴の抽出(Depthwise Conv): 拡張後のデータに対してDepthwise Convolutionを適用することで、局所的なパターンを効率的に抽出します。ここでチャンネルごとに独立に畳み込みを行うため、計算効率が良く、かつ空間的な特徴を捉えやすいという利点があります。この時点でDepthwise Convを適用する理由は、チャンネルの拡張によって豊富な特徴表現が可能になっているためです。
重要な特徴への注目(ECA Attention): Depthwise Convolutionで得られた特徴量に対して、ECAを用いて重要な情報に重みを付けます。この順番でAttentionを導入することで、前段のConv層が捉えた特徴のうち、特に重要な部分を強調します。ここでAttentionを適用しなければ、後続のProjectionやSkip Connectionによる統合の前に、重要な特徴が反映されません。
情報の圧縮(Projection): 拡張されたチャンネル数を元のチャンネル数に戻します(project)。これにより、再び元の次元に収束させることで、後続の層での計算量やパラメータ数を抑えつつ、前段の処理で得た情報を保持します。このProjectionの前にECAがあるのは、ECAで強調された重要な特徴を適切に維持するためです。
元の情報も保持(Skip Connection): スキップ接続を用いて、元の入力データを保持しつつ、変換されたデータと統合します。これにより、元の情報を損なうことなく変換後の情報と合成することができ、特に学習の安定性が向上します。ここでスキップ接続を適用しない場合、前段の処理で変換されたデータのみが出力に反映され、学習が不安定になったり、元のデータが持つ情報が失われる可能性があります。
最終的な特徴抽出(FFN): FFN(Feed-Forward Network)で全体の特徴をさらに統合・整理します。ここではGLUMlpを用いることで、活性化関数と線形変換を組み合わせた処理を行い、複雑な関係をキャプチャします。スキップ接続後にFFNを置く理由は、スキップ接続によって統合されたデータ全体を最終的に整理する必要があるためです。
数値の安定化(LayerNorm): 最後にLayerNormを適用し、数値のスケールを整えます。これにより、全体の出力が安定し、学習がスムーズになります。LayerNormを最終段に置くことで、各ステップを経た後のデータの分布が整えられ、出力の安定性が確保されます。
CNN特徴抽出+GRU処理(可変長画像データの処理)
CNN特徴抽出+GRU処理(可変長画像データの処理)
この記事について
連続した画像データのembeddingについて、tensorの形状を確認しながらデータフローを理解する目的で実装を簡素にまとめています。
モデルの概要
このモデルは、画像のシーケンスを入力として扱い、それぞれの画像から抽出された特徴を合成して、最終的に特定のターゲットサイズの出力を生成するために設計されています。
- ベースモデル(EfficientNet-B0): 画像の特徴量を抽出
- GRU(Gated Recurrent Unit): 時系列データの処理
- 線形レイヤー(全結合層): 最終出力の生成
- プーリングレイヤー: 時系列データの集約
class CFG: target_size = 10 # 例として設定 class Model(nn.Module): def __init__(self, base_model='tf_efficientnet_b0_ns', pool="avg", pretrain=True): super(Model, self).__init__() self.model = timm.create_model(base_model, pretrained=pretrain, num_classes=0, in_chans=3) nc = self.model.num_features self.gru = nn.GRU(nc, 512, bidirectional=True, batch_first=True, num_layers=2) self.exam_predictor = nn.Linear(512*2, CFG.target_size) self.pool = nn.AdaptiveAvgPool1d(1) def forward(self, input1): shape = input1.size() print(f"Initial input shape: {shape}") batch_size = shape[0] n = shape[1] input1 = input1.view(-1, shape[2], shape[3], shape[4]) print(f"Reshaped input1: {input1.size()}") # e.g., (batch_size * n, C, H, W) x = self.model(input1) print(f"Output of base model: {x.size()}") # e.g., (batch_size * n, nc) x = x.view(batch_size, n, x.shape[1]) print(f"Reshaped for GRU input: {x.size()}") # e.g., (batch_size, n, nc) embeds, _ = self.gru(x) print(f"Output of GRU: {embeds.size()}") # e.g., (batch_size, n, 1024) embeds = self.pool(embeds.permute(0, 2, 1))[:,:,0] print(f"Output of pooling: {embeds.size()}") # e.g., (batch_size, 1024) y = self.exam_predictor(embeds) print(f"Final output: {y.size()}") # e.g., (batch_size, CFG.target_size) return y model = Model() dummy_input = torch.randn(2, 14, 3, 224, 224) # 例としてバッチサイズ2、シーケンス長10、チャンネル3、サイズ224x224のダミーデータ output = model(dummy_input) print(output.shape)
Initial input shape: torch.Size([2, 14, 3, 224, 224]) Reshaped input1: torch.Size([28, 3, 224, 224]) Output of base model: torch.Size([28, 1280]) Reshaped for GRU input: torch.Size([2, 14, 1280]) Output of GRU: torch.Size([2, 14, 1024]) Output of pooling: torch.Size([2, 1024]) Final output: torch.Size([2, 10]) torch.Size([2, 10])
LSTMのカスタムpoolingとtanhの理由
LSTMのカスタムpoolingとtanhの理由
CustomPoolerは時系列データに重みをつけてプーリングする層
class CustomPooler(nn.Module): def __init__(self, hidden_size): super(CustomPooler, self).__init__() # 全結合層のシーケンシャルモデルを定義 self.fc = nn.Sequential( nn.Linear(hidden_size, hidden_size, bias=True), # 特徴を隠れ層サイズに変換 nn.Tanh(), # 非線形変換で情報を圧縮 nn.Linear(hidden_size, 1, bias=False), # 各時刻に対するスカラー重みを計算 nn.Softmax(dim=1), # 重みを正規化して重要度を計算 ) def forward(self, x): _x = self.fc(x) # LSTMの出力に対して重みを計算 x = torch.sum(x * _x, dim=1) # 各時刻の特徴に重みをかけて合計し、1つのベクトルに集約 return x # 集約された特徴ベクトルを返す
1. CustomPoolerの目的
CustomPoolerは、LSTMの出力から時系列データの重要な特徴を集約する層です。具体的には、LSTMが生成した複数の時間ステップの特徴量に重みを付け、最終的に1つの特徴ベクトルにまとめます。この集約処理によって、モデルは時系列データの重要な部分を強調し、無視しても良い部分を減らすことができます。
2. Tanhの使用理由
CustomPooler内でnn.Tanh()を使用している理由は以下の通りです。
出力範囲の調整:
Tanhは-1から+1の範囲に出力を収束させるため、LSTMの出力が正と負の情報を含む場合でも、バランスの取れた出力を得ることができます。
非線形変換:
Tanhは非線形性を持つため、LSTMの出力を圧縮し、次の層でより多様なパターンを学習するのに役立ちます。
勾配消失の軽減:
Tanhは、ReLUよりも勾配消失問題が少ない場合があります。これは、特にLSTMのようなリカレントニューラルネットワークで重要です。
3. プーリング処理の流れ
CustomPoolerのforwardメソッドでは、以下の処理が行われます。
重みの計算:
_x = self.fc(x) # LSTMの出力に対して重みを計算
LSTMの出力xに対して全結合層を適用し、各時刻に対するスカラー重みを計算します。
特徴の集約:
x = torch.sum(x * _x, dim=1) # 各時刻の特徴に重みをかけて合計し、1つのベクトルに集約
計算された重み_xを用いて、各時刻の特徴xに重みを掛け、次元を減らして1つのベクトルに集約します。
まとめ
このCustomPoolerは、LSTMの出力から時系列データの重要な特徴を抽出するための重要なコンポーネントです。Tanhを使用することで、出力がバランスを持ち、学習プロセスが安定化します。これにより、モデルはデータの時間的な変化を適切に捉え、より効果的に学習することができます。
CNN+LSTM複合モデルの処理フロー
CNN+LSTM複合モデルの処理フローの理解
Reference
目的
- 連続する画像データの処理を行うモデル(LSTM+CNN)の構造を学ぶ
- RSNAの復習
実装
# 特徴抽出用のCNNモデルを定義 class FeatureExtractor(nn.Module): def __init__(self, n_channel, hidden_size): super(FeatureExtractor, self).__init__() # ConvNeXt Tinyの事前学習済みモデルを読み込み、クラス分類層を除去 self.backbone = timm.create_model( model_name='convnext_tiny.in12k_ft_in1k', # ConvNeXt Tinyモデル pretrained=True, # 事前学習済みモデルを使用 num_classes=0, # クラス分類層は不要 in_chans=n_channel # 入力チャンネル数を指定(例:1チャンネルのグレースケール画像用) ) # 順伝播処理の定義 def forward(self, x): x = self.backbone(x) # ConvNeXtで特徴を抽出 return x # 特徴マップを返す # CustomPoolerは時系列データに重みをつけてプーリングする層 class CustomPooler(nn.Module): def __init__(self, hidden_size): super(CustomPooler, self).__init__() # 全結合層のシーケンシャルモデルを定義 self.fc = nn.Sequential( nn.Linear(hidden_size, hidden_size, bias=True), # 特徴を隠れ層サイズに変換 nn.Tanh(), # 非線形変換で情報を圧縮 nn.Linear(hidden_size, 1, bias=False), # 各時刻に対するスカラー重みを計算 nn.Softmax(dim=1), # 重みを正規化して重要度を計算 ) def forward(self, x): _x = self.fc(x) # LSTMの出力に対して重みを計算 x = torch.sum(x * _x, dim=1) # 各時刻の特徴に重みをかけて合計し、1つのベクトルに集約 return x # 集約された特徴ベクトルを返す # カスタムモデルを定義 class CustomModel(nn.Module): def __init__(self, args, # ハイパーパラメータや設定を保持するオブジェクト n_channel=1, # 入力画像のチャンネル数(例:グレースケールで1) hidden_size=768, # 隠れ層のサイズ drop_rate=0.2 # ドロップアウト率 ): super(CustomModel, self).__init__() self.args = args # ハイパーパラメータを保存 self.hidden_size = hidden_size # 隠れ層サイズを保存 # CNNベースの特徴抽出器を初期化 self.cnn = FeatureExtractor( n_channel=n_channel, # 入力チャンネル数を指定 hidden_size=hidden_size, # 隠れ層サイズを指定 ) # 1つ目のLSTMを定義(双方向、バッチの最初の次元に対応) self.rnn1 = nn.LSTM( input_size=hidden_size, # LSTMへの入力はCNNの出力特徴マップ hidden_size=hidden_size//2, # 隠れ層サイズを半分にして双方向LSTM batch_first=True, # バッチが最初の次元に来るようにする bidirectional=True # 双方向LSTMにする ) # 重み付きプーリング層を初期化 self.pooler = CustomPooler( hidden_size=hidden_size, # 隠れ層サイズに基づくプーリング ) # 2つ目のLSTMを定義(1つ目のLSTMの後に適用) self.rnn2 = nn.LSTM( input_size=hidden_size, # 再度、隠れ層サイズの入力 hidden_size=hidden_size//2, # 双方向LSTMの隠れ層サイズを半分に batch_first=True, # バッチが最初の次元に来る bidirectional=True # 双方向に時系列データを処理 ) # 3つの出力層を定義、各々が異なる分類タスクを行う self.out1 = nn.Sequential( nn.Dropout(drop_rate), # ドロップアウトによる正則化 nn.Linear(hidden_size, args.n_class) # 隠れ層からクラス数に変換 ) self.out2 = nn.Sequential( nn.Dropout(drop_rate), # 2つ目の分類タスク nn.Linear(hidden_size, args.n_class) ) self.out3 = nn.Sequential( nn.Dropout(drop_rate), # 3つ目の分類タスク nn.Linear(hidden_size, args.n_class) ) def forward(self, x): print('1 :入力の形状 ',x.shape) _, _, d, h, w = x.shape # 入力の形状を取得(バッチ、チャネル、深さ、高さ、幅) x = x.reshape(-1, h, w) # 深さ方向にスライスを展開して2Dに変換 print('2 :深さ方向にスライスを展開して2Dに変換 ',x.shape) x = x.unsqueeze(1) # チャンネル次元を追加(例: グレースケールの場合は1チャンネル) print('3 :チャンネル次元を追加 ',x.shape) x = self.cnn(x) # CNNで特徴抽出 print('4 :CNNで特徴抽出 ',x.shape) x = x.reshape(-1, d, self.hidden_size) # 再度、時系列データに変換 print('5 :再度、時系列データに変換 ',x.shape) x, _ = self.rnn1(x) # LSTM1を適用して時系列データを処理 print('6 :LSTM1を適用して時系列データを処理 ',x.shape) x = self.pooler(x) # 重み付きプーリングで時系列全体を集約 print('7 :重み付きプーリングで時系列全体を集約 ',x.shape) x = x.reshape(-1, 25, self.hidden_size) # 25スライスの時系列として再度形状を変換 print('8 :25スライスの時系列として再度形状を変換 ',x.shape) x = x.reshape(-1, 5, 5, self.hidden_size) # 5x5のブロックに分けて再配置 print('9 :5x5のブロックに分けて再配置 ',x.shape) x = x.permute(0, 2, 1, 3) # 軸を入れ替えて再配置 print('10 :軸を入れ替えて再配置 ',x.shape) x = x.reshape(-1, 5, self.hidden_size) # 形状を再度変更して5スライスごとに print('11 :形状を再度変更して5スライスごとに ',x.shape) x, _ = self.rnn2(x) # 2つ目のLSTMを適用してさらなる時系列処理 print('12 :2つ目のLSTMを適用してさらなる時系列処理 ',x.shape) x = x.reshape(-1, 5, 5, self.hidden_size) # 再び5x5ブロックに分けて再配置 print('13 :再び5x5ブロックに分けて再配置 ',x.shape) x = x.permute(0, 2, 1, 3) # 再び軸を入れ替え print('14 :再び軸を入れ替え ',x.shape) x = x.reshape(-1, 25, self.hidden_size) # 再度25スライスとして展開 print('15 :再度25スライスとして展開 ',x.shape) # 各スライスの部分に対応する出力を得る x1 = x[:, 0:5] # 最初の5スライス print('x1 :最初の5スライス ',x1.shape) x2 = x[:, 5:15] # 次の10スライス print('x2 :次の10スライス ',x2.shape) x3 = x[:, 15:25] # 最後の10スライス print('x3 :最後の10スライス ',x3.shape) x1 = self.out1(x1) # 1つ目の分類出力 print('x1 :1つ目の分類出力 ',x1.shape) x2 = self.out2(x2) # 2つ目の分類出力 print('x2 :2つ目の分類出力 ',x2.shape) x3 = self.out3(x3) # 3つ目の分類出力 print('x2 :3つ目の分類出力 ',x2.shape) x = torch.cat([x1, x2, x3], dim=1) # 3つの出力を結合 print('x :3つの出力を結合 ',x.shape) return x # 最終的な出力を返す # ハイパーパラメータやデバイスの設定を行う class Args: n_class = 3 # クラス数 batch_size = 2 # バッチサイズ device = 'cuda' if torch.cuda.is_available() else 'cpu' # デバイス設定 args = Args() # ダミーデータの作成 (バッチサイズ=2, チャンネル数=25, 深さ=5, 高さ=128, 幅=128) dummy_input = torch.randn(2, 25, 5, 128, 128).to(args.device) # ダミーデータの作成(ランダムな値の5スライス画像) # モデルの初期化 model = CustomModel(args=args).to(args.device) # モデルを初期化してデバイスに転送 # モデルにダミーデータを流し込んで順伝播を実行 output = model(dummy_input) # 出力の形状を表示 print(f"Output shape: {output.shape}") # 結果の出力形状を確認
1 :入力の形状 torch.Size([2, 25, 5, 128, 128]) 2 :深さ方向にスライスを展開して2Dに変換 torch.Size([250, 128, 128]) 3 :チャンネル次元を追加 torch.Size([250, 1, 128, 128]) 4 :CNNで特徴抽出 torch.Size([250, 768]) 5 :再度、時系列データに変換 torch.Size([50, 5, 768]) 6 :LSTM1を適用して時系列データを処理 torch.Size([50, 5, 768]) 7 :重み付きプーリングで時系列全体を集約 torch.Size([50, 768]) 8 :25スライスの時系列として再度形状を変換 torch.Size([2, 25, 768]) 9 :5x5のブロックに分けて再配置 torch.Size([2, 5, 5, 768]) 10 :軸を入れ替えて再配置 torch.Size([2, 5, 5, 768]) 11 :形状を再度変更して5スライスごとに torch.Size([10, 5, 768]) 12 :2つ目のLSTMを適用してさらなる時系列処理 torch.Size([10, 5, 768]) 13 :再び5x5ブロックに分けて再配置 torch.Size([2, 5, 5, 768]) 14 :再び軸を入れ替え torch.Size([2, 5, 5, 768]) 15 :再度25スライスとして展開 torch.Size([2, 25, 768]) x1 :最初の5スライス torch.Size([2, 5, 768]) x2 :次の10スライス torch.Size([2, 10, 768]) x3 :最後の10スライス torch.Size([2, 10, 768]) x1 :1つ目の分類出力 torch.Size([2, 5, 3]) x2 :2つ目の分類出力 torch.Size([2, 10, 3]) x2 :3つ目の分類出力 torch.Size([2, 10, 3]) x :3つの出力を結合 torch.Size([2, 25, 3]) Output shape: torch.Size([2, 25, 3])
全体の処理の流れ
まず入力データの形状について:
入力形状: (2, 25, 5, 128, 128)
バッチサイズ=2 チャンネル=25 深さ=5 高さ=128 幅=128
データの再構成と処理の流れを段階的に説明します:
第1段階: 入力データの準備
x.reshape(-1, h, w) # 形状: (250, 128, 128)
25チャンネル×5枚の画像(深さ方向)を一枚ずつに分解 つまり、2(バッチ)×25×5=250枚の独立した画像として扱う
第2段階: CNN処理
各画像をCNNで特徴抽出 出力は各画像から抽出された768次元の特徴ベクトル
第3段階: 時系列データへの変換
x.reshape(-1, d, self.hidden_size) # 形状: (50, 5, 768)
250枚の画像を、もとの構造に合わせて再構成 50個のグループ(2バッチ×25チャンネル)に分け、各グループは5枚の時系列データとして扱う
第4段階: LSTM1と重み付きプーリング
self.rnn1(x) # LSTM処理 self.pooler(x) # 重み付きプーリング
5枚の時系列データを1つの特徴ベクトルに集約 各時点(5枚)の重要度を学習し、重み付き平均を計算
第5段階: 25スライスへの再構成
x.reshape(-1, 25, self.hidden_size) # 形状: (2, 25, 768)
バッチごとに25個の特徴ベクトルを持つ形に変換
第6段階: 5×5の行列への変換とLSTM2
x.reshape(-1, 5, 5, self.hidden_size) # 5×5の行列に変換 x.permute(0, 2, 1, 3) # 軸の入れ替え x.reshape(-1, 5, self.hidden_size) # LSTM2用に再構成
25個の特徴を5×5の行列として扱う 行と列の関係性を捉えるため、両方向から処理
第7段階: 最終出力の生成
25個の特徴を3つのグループに分割:
最初の5個 → 1つ目の分類タスク 次の10個 → 2つ目の分類タスク 最後の10個 → 3つ目の分類タスク
reshapeによる整合性についての疑問
入力データの構造
- 入力データの形状は
(batch_size, channels, depth, height, width)。batch_size: サンプル数channels: 画像のチャネル数(例: グレースケールなら1、RGBなら3)depth: 深さ(時系列スライス数に対応)height, width: 各スライスの2D画像の高さと幅
処理の意図
深さ方向のスライスを2D画像としてCNNで処理:
- コード部分:
python x = x.reshape(-1, h, w) # 深さ方向にスライスを展開して2Dに変換 x = x.unsqueeze(1) # チャンネル次元を追加(例: グレースケールの場合は1チャンネル) x = self.cnn(x) # CNNで特徴抽出 - 意図:
- 深さ方向にある各スライスを2D画像とみなして、それぞれCNNに通す準備をします。
reshape(-1, h, w)は、「バッチの各サンプルのスライスをすべて展開」し、1つの大きなバッチとして扱います。- これにより、CNNで時系列の順序に依存しない空間的な特徴を抽出することができます。
- 疑問:「
-1を使ってバッチを展開しても、他のデータと混ざってしまわないか?」- 答え:
- CNN部分は空間的特徴の抽出に専念しており、時系列依存は考慮されていないため問題ありません。
- その後、データは元の時系列に戻され、LSTMで適切に処理されます。
- 答え:
- コード部分:
時系列の再構築とLSTMによる処理:
- コード部分:
python x = x.reshape(-1, d, self.hidden_size) # 再度、時系列データに変換 x, _ = self.rnn1(x) # LSTM1を適用して時系列データを処理 - 意図:
- CNNで特徴抽出が終わったら、再度時系列構造に戻します。このとき、各スライスに対応する特徴量をもとに、LSTMが時系列依存を処理します。
reshape(-1, depth, hidden_size)で、元の時系列構造(スライス数)に戻してから、LSTMで時系列依存をモデル化します。
- 疑問:「展開後、時系列の順序や独立性が保持されるか?」
- 答え:
- CNNで処理した後、再び時系列構造に戻しているため、時系列依存が正しく処理されます。バッチ間での混ざりはなく、独立した時系列として扱われます。
- 答え:
- コード部分:
reshape(-1, h, w) の役割
- 説明:
reshape(-1, h, w)は、深さ方向のスライスを一時的に展開して2D画像として扱うために行います。この処理を通じて、各スライスにCNNを適用することができ、時系列情報が失われるわけではありません。
- よくある疑問:
- 「バッチ次元を展開すると、データが混ざってしまわないか?」
- 答え:
- CNN部分では、スライス間の関係や時系列依存は考慮されないため、スライスごとの空間的特徴を個別に抽出することが目的です。
- LSTMなどの時系列処理の前に、再び元の時系列構造に戻すため、時系列情報が損なわれることはありません。
最終的な流れのまとめ
CNNで空間的特徴を抽出:
- 各スライスを2D画像としてCNNに通すために、
reshape(-1, h, w)でスライスを展開。 - CNNにより、空間的な特徴が抽出される。
- 各スライスを2D画像としてCNNに通すために、
時系列構造に戻してLSTMで時系列処理:
- CNNで得られた特徴を時系列構造に再度変換。
- LSTMでスライス間の時系列依存を処理。
結論:
- CNNで空間的特徴を抽出した後、時系列構造に戻すことで、時系列の依存関係を考慮した処理が可能になります。時系列の順序やデータの独立性が保持されており、データが混ざることはありません。
カスタム損失入門:PyTorch による自作の損失関数
カスタム損失関数の定義と使用方法
1. はじめに
機械学習、特に深層学習において、損失関数(Loss Function)は学習プロセスの中心的な役割を果たします。モデルの性能を評価し、最適化の方向性を決定するのが損失関数の役割です。多くの場合、平均二乗誤差(MSE)や交差エントロピーなどの標準的な損失関数で十分ですが、特定の問題や要件に対しては、カスタム損失関数を定義する必要があることがあります。
この記事では、PyTorchを使用してカスタム損失関数を定義し、使用する方法について詳しく説明します。
2. カスタム損失関数が必要な理由
カスタム損失関数を使用する主な理由は以下の通りです:
- 特定のタスクに対する最適化:標準的な損失関数では捉えきれない問題固有の特性を反映させる。
- 複数の目的の組み合わせ:異なる側面を同時に最適化する必要がある場合。
- 制約条件の組み込み:モデルの出力に特定の制約を課したい場合。
- 不均衡データへの対応:クラス不均衡問題などに対処する場合。
3. PyTorchでのカスタム損失関数の定義
PyTorchでは、nn.Moduleを継承するか、単純な関数としてカスタム損失関数を定義できます。以下では両方の方法を紹介します。
3.1 nn.Moduleを使用した定義
import torch import torch.nn as nn class CustomLoss(nn.Module): def __init__(self, weight=None, size_average=True): super(CustomLoss, self).__init__() def forward(self, inputs, targets): # ここに損失計算のロジックを実装 loss = torch.mean((inputs - targets)**2) return loss ### 3.2 関数として定義
def custom_loss(inputs, targets): # ここに損失計算のロジックを実装 loss = torch.mean((inputs - targets)**2) return loss
## 4. カスタム損失関数の使用例 ここでは、重み付き平均二乗誤差(Weighted MSE)を実装する例を示します。
import torch import torch.nn as nn
class WeightedMSELoss(nn.Module): def init(self, weight): super(WeightedMSELoss, self).init() self.weight = weight
def forward(self, inputs, targets):
return torch.mean(self.weight * (inputs - targets) ** 2)
使用例
weight = torch.tensor([1.0, 2.0, 3.0]) # 各要素の重みを指定 criterion = WeightedMSELoss(weight)
inputs = torch.randn(3, requires_grad=True) targets = torch.randn(3)
loss = criterion(inputs, targets) loss.backward()
print(f"Inputs: {inputs}") print(f"Targets: {targets}") print(f"Loss: {loss.item()}")
## 5. 訓練ループでのカスタム損失関数の使用 カスタム損失関数を定義したら、通常の訓練ループで以下のように使用できます:
import torch import torch.optim as optim
モデルとオプティマイザの定義
model = YourModel() optimizer = optim.Adam(model.parameters(), lr=0.001)
カスタム損失関数のインスタンス化
criterion = WeightedMSELoss(weight=torch.tensor([1.0, 2.0, 3.0]))
訓練ループ
for epoch in range(num_epochs): for batch in dataloader: inputs, targets = batch
# フォワードパス
outputs = model(inputs)
# 損失計算
loss = criterion(outputs, targets)
# バックワードパスと最適化
optimizer.zero_grad()
loss.backward()
optimizer.step()
print(f"Epoch [{epoch+1}/{num_epochs}], Loss: {loss.item():.4f}")
## 6. 注意点とベストプラクティス 微分可能性:カスタム損失関数は微分可能である必要があります。PyTorchの自動微分システムと互換性があることを確認してください。 数値安定性:ゼロ除算や極端に大きな/小さな値を避けるため、数値的に安定した実装を心がけてください。 バッチ処理:損失関数はバッチ処理に対応できるようにしてください。 GPU互換性:損失関数がGPU上で効率的に動作することを確認してください。 テスト:様々な入力に対して損失関数の動作を十分にテストしてください。
torch関数:深層学習でよく使うtorch関数まとめ
pytorch関数の復習
torch.Tensor.reshape(-1)
処理
一次元tensorへの変換
用途
reshape関数は、テンソルの形状を変更するために使用されます。-1を指定することで、テンソルをフラットな1次元テンソルに変換します。他の次元のサイズが自動的に計算されます。
saample code
# 2x2テンソルを作成 tensor = torch.tensor([[1, 2], [3, 4]]) # テンソルの形状変更 reshaped_tensor = tensor.reshape(-1) print(tensor) print(reshaped_tensor) tensor([[1, 2], [3, 4]]) tensor([1, 2, 3, 4])
torch.argumax
処理
テンソル内の最大値のインデックスを取得
用途
argmax関数は、指定された次元に沿ってテンソル内の最大値のインデックスを返します。この関数は、分類問題において最も確からしいクラスを特定するなどの用途に使えます。
sample code
# 2x4テンソルを作成 tensor = torch.tensor([[1, 3, 2, 4], [6, 5, 8, 7]]) # 行ごと(次元0)に最大値のインデックスを取得 max_indices_dim0 = torch.argmax(tensor, dim=0) # 列ごと(次元1)に最大値のインデックスを取得 max_indices_dim1 = torch.argmax(tensor, dim=1) print(tensor) print(max_indices_dim0) print(max_indices_dim1) tensor([[1, 3, 2, 4], [6, 5, 8, 7]]) tensor([1, 1, 1, 1]) tensor([3, 2])
torch.stack
処理
複数のテンソルを新しい次元に沿って結合
用途
stack関数は、同じ形状を持つ複数のテンソルを指定された次元に沿って新しいテンソルとして結合します。これは新しい高次元のテンソルを作成する際に便利です。
sample code
# 2つの1x3テンソルを作成 tensor1 = torch.tensor([1, 2, 3]) tensor2 = torch.tensor([4, 5, 6]) # 次元0に沿って結合 stacked_tensor_dim0 = torch.stack([tensor1, tensor2], dim=0) # 次元1に沿って結合 stacked_tensor_dim1 = torch.stack([tensor1, tensor2], dim=1) print(tensor1) print(tensor2) print(stacked_tensor_dim0) print(stacked_tensor_dim1) # 出力 # tensor([1, 2, 3]) # tensor([4, 5, 6]) # tensor([[1, 2, 3], # [4, 5, 6]]) # tensor([[1, 4], # [2, 5], # [3, 6]])
torch.nn.functional.interpolate
処理
テンソルを指定したサイズ、スケール、またはモードに基づいて補間し、リサイズを行う。
用途
interpolate 関数は、画像や特徴マップなどのテンソルを拡大・縮小するために使用されます。補間モードを選択することで、最も適したリサイズ方法を指定できます(例: 最近傍法、双線形補間など)。
sample code
import torch import torch.nn.functional as F # 1x1x2x2のテンソルを作成(1チャンネル、2x2サイズの画像) input_tensor = torch.tensor([[[[1.0, 2.0], [3.0, 4.0]]]]) # サイズを4x4にリサイズ(双線形補間) resized_tensor = F.interpolate(input_tensor, size=(4, 4), mode='bilinear', align_corners=False) # スケールを2倍にリサイズ(最近傍法) scaled_tensor = F.interpolate(input_tensor, scale_factor=2, mode='nearest') print("Original Tensor:") print(input_tensor) print("Resized Tensor (bilinear, 4x4):") print(resized_tensor) print("Scaled Tensor (nearest, 2x2 -> 4x4):") print(scaled_tensor) # 出力 # Original Tensor: # tensor([[[[1., 2.], # [3., 4.]]]]) # Resized Tensor (bilinear, 4x4): # tensor([[[[1.0000, 1.3333, 1.6667, 2.0000], # [1.6667, 2.0000, 2.3333, 2.6667], # [2.3333, 2.6667, 3.0000, 3.3333], # [3.0000, 3.3333, 3.6667, 4.0000]]]]) # Scaled Tensor (nearest, 2x2 -> 4x4): # tensor([[[[1., 1., 2., 2.], # [1., 1., 2., 2.], # [3., 3., 4., 4.], # [3., 3., 4., 4.]]]])
torch.cat
処理
複数のテンソルを指定した次元に沿って連結する。
用途
cat 関数は、同じサイズのテンソルを指定した次元に沿って結合し、一つの大きなテンソルを作成します。バッチ処理やテンソルの結合に便利です。
sample code
import torch # 2つの1x3テンソルを作成 tensor1 = torch.tensor([[1, 2, 3]]) tensor2 = torch.tensor([[4, 5, 6]]) # 次元0に沿って連結(縦に結合) concatenated_dim0 = torch.cat([tensor1, tensor2], dim=0) # 次元1に沿って連結(横に結合) concatenated_dim1 = torch.cat([tensor1, tensor2], dim=1) print("Concatenated along dim 0:") print(concatenated_dim0) print("Concatenated along dim 1:") print(concatenated_dim1) # 出力 # Concatenated along dim 0: # tensor([[1, 2, 3], # [4, 5, 6]]) # Concatenated along dim 1: # tensor([[1, 2, 3, 4, 5, 6]])
torch.stack と torch.cat の使い分け
概要
違いと使い分け
torch.stack:
torch.cat:
具体例
import torch # 同じ形状を持つテンソルを作成 tensor1 = torch.tensor([[1, 2], [3, 4]]) tensor2 = torch.tensor([[5, 6], [7, 8]]) # torch.stack: 次元を増やして結合 stacked = torch.stack([tensor1, tensor2], dim=0) print("torch.stack result:") print(stacked) # 出力: 次元が1つ増える # tensor([[[1, 2], # [3, 4]], # [[5, 6], # [7, 8]]]) # torch.cat: 既存の次元に沿って連結 concatenated = torch.cat([tensor1, tensor2], dim=0) print("\ntorch.cat result:") print(concatenated) # 出力: 行方向に連結され、次元数は変わらない # tensor([[1, 2], # [3, 4], # [5, 6], # [7, 8]])
torch.cuda.amp.GradScaler
処理
自動混合精度 (AMP) でのトレーニングにおいて勾配スケーリングを行い、勾配のアンダーフローを防ぐ。
用途
GradScaler は、浮動小数点数の16ビット (FP16) と32ビット (FP32) の混合精度を使用してトレーニングを行う際に、勾配のスケーリングを管理します。これにより、数値的に不安定な計算での勾配アンダーフローを防ぎつつ、計算速度の向上が可能になります。
sample code
import torch import torch.cuda.amp as amp # モデル、オプティマイザを定義 model = torch.nn.Linear(10, 10).cuda() optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) scaler = amp.GradScaler() # ダミー入力とラベルを作成 data = torch.randn(16, 10).cuda() target = torch.randn(16, 10).cuda() # トレーニングループ for epoch in range(5): optimizer.zero_grad() # 混合精度のforwardパス with amp.autocast(): output = model(data) loss = torch.nn.functional.mse_loss(output, target) # 勾配のスケーリングを適用してbackward scaler.scale(loss).backward() # スケーリングを適用した勾配でステップを実行 scaler.step(optimizer) # 次のイテレーションのためにスケーラを更新 scaler.update() print(f'Epoch {epoch}, Loss: {loss.item()}')
torch.view
処理
テンソルのサイズや次元を変更する。
用途
view 関数は、テンソルの要素数を保持したまま、新しい形状に変換します。テンソルのリシェイプ時に使用され、特定の形状でデータを扱いたい場合に便利です。新しいサイズの要素数が元のテンソルと一致している必要があります。
sample code
import torch # 1x6のテンソルを作成 tensor = torch.tensor([1, 2, 3, 4, 5, 6]) # 2x3のテンソルにリシェイプ reshaped_tensor = tensor.view(2, 3) # -1を使用して自動的にサイズを計算 auto_reshaped_tensor = tensor.view(3, -1) print("Original Tensor:") print(tensor) print("Reshaped Tensor (2x3):") print(reshaped_tensor) print("Auto Reshaped Tensor (3x2):") print(auto_reshaped_tensor) # 出力 # Original Tensor: # tensor([1, 2, 3, 4, 5, 6]) # Reshaped Tensor (2x3): # tensor([[1, 2, 3], # [4, 5, 6]]) # Auto Reshaped Tensor (3x2): # tensor([[1, 2], # [3, 4], # [5, 6]])
torch.unsqueeze
処理
指定された次元に1次元を挿入する(新しい次元を追加する)。
用途
unsqueeze 関数は、テンソルに新しい次元を追加する際に使用されます。たとえば、2Dテンソルを3Dに拡張したり、バッチ次元を追加したい場合に便利です。
sample code
import torch # 1x3のテンソルを作成 tensor = torch.tensor([1, 2, 3]) # 次元0に新しい次元を挿入(1x3 -> 1x1x3) unsqueezed_dim0 = torch.unsqueeze(tensor, dim=0) # 次元1に新しい次元を挿入(1x3 -> 1x3x1) unsqueezed_dim1 = torch.unsqueeze(tensor, dim=1) print("Original Tensor:") print(tensor) print("Unsqueezed Tensor (dim 0):") print(unsqueezed_dim0) print("Unsqueezed Tensor (dim 1):") print(unsqueezed_dim1) # 出力 # Original Tensor: # tensor([1, 2, 3]) # Unsqueezed Tensor (dim 0): # tensor([[1, 2, 3]]) # Unsqueezed Tensor (dim 1): # tensor([[1], # [2], # [3]])
torch.mean
処理
テンソルの要素の平均を計算する。
用途
mean 関数は、テンソル全体、または特定の次元に沿った平均を計算するために使用されます。テンソルのデータを要約したり、正規化のために利用されます。
sample code
import torch # 2x3のテンソルを作成 tensor = torch.tensor([[1.0, 2.0, 3.0], [4.0, 5.0, 6.0]]) # 全体の平均を計算 mean_all = torch.mean(tensor) # 次元0に沿った平均を計算(列ごと) mean_dim0 = torch.mean(tensor, dim=0) # 次元1に沿った平均を計算(行ごと) mean_dim1 = torch.mean(tensor, dim=1) print("Original Tensor:") print(tensor) print("Mean of all elements:") print(mean_all) print("Mean along dimension 0 (columns):") print(mean_dim0) print("Mean along dimension 1 (rows):") print(mean_dim1) # 出力 # Original Tensor: # tensor([[1., 2., 3.], # [4., 5., 6.]]) # Mean of all elements: # tensor(3.5000) # Mean along dimension 0 (columns): # tensor([2.5000, 3.5000, 4.5000]) # Mean along dimension 1 (rows): # tensor([2., 5.])
継承によるデータセット実装
継承を活用した複雑なデータセット実装
データサイエンスや機械学習のプロジェクトでは、複雑なデータセットを扱うことがよくあります。このような場合、継承を使ってデータセットのクラスを分けて実装することで、コードの再利用性と保守性を高めることができます。本記事では、継承を活用した複雑なデータセット実装の方法について、具体的な例を交えて説明します。
1. 基本的なデータセットクラス
まず、すべてのデータセットに共通する基本的な機能を持つ基底クラスを作成します。
import pandas as pd from abc import ABC, abstractmethod class BaseDataset(ABC): def __init__(self, data_path): self.data_path = data_path self.data = None @abstractmethod def load_data(self): pass @abstractmethod def preprocess(self): pass def get_data(self): if self.data is None: self.load_data() self.preprocess() return self.data
このBaseDatasetクラスは、データの読み込みと前処理のための抽象メソッドを定義しています。get_dataメソッドは、データがまだ読み込まれていない場合に読み込みと前処理を行います。 2. 特定のデータセット用のクラス 次に、BaseDatasetを継承して、特定のデータセット用のクラスを作成します。例として、CSVファイルから読み込むデータセットと、JSONファイルから読み込むデータセットを実装してみましょう。
class CSVDataset(BaseDataset): def load_data(self): self.data = pd.read_csv(self.data_path) def preprocess(self): # CSVデータセット特有の前処理を行う self.data.dropna(inplace=True) self.data['date'] = pd.to_datetime(self.data['date']) class JSONDataset(BaseDataset): def load_data(self): self.data = pd.read_json(self.data_path) def preprocess(self): # JSONデータセット特有の前処理を行う self.data = self.data.transpose() self.data.reset_index(inplace=True)
これらのクラスは、それぞれのデータ形式に応じた読み込みと前処理の方法を実装しています。
3. より複雑なデータセット
さらに複雑なデータセットの場合、追加の機能や特殊な処理が必要になることがあります。そのような場合も、継承を活用して実装することができます。
class TimeSeriesDataset(CSVDataset): def __init__(self, data_path, time_column, value_column): super().__init__(data_path) self.time_column = time_column self.value_column = value_column def preprocess(self): super().preprocess() # 時系列データ特有の前処理 self.data.set_index(self.time_column, inplace=True) self.data.sort_index(inplace=True) def resample(self, freq): # 時系列データのリサンプリング return self.data[self.value_column].resample(freq).mean() class MultiSourceDataset(BaseDataset): def __init__(self, csv_path, json_path): super().__init__(None) # data_pathは使用しない self.csv_dataset = CSVDataset(csv_path) self.json_dataset = JSONDataset(json_path) def load_data(self): csv_data = self.csv_dataset.get_data() json_data = self.json_dataset.get_data() self.data = pd.merge(csv_data, json_data, on='id') def preprocess(self): # 結合したデータに対する追加の前処理 self.data.fillna(0, inplace=True)
TimeSeriesDatasetクラスはCSVDatasetを継承し、時系列データ特有の機能を追加しています。MultiSourceDatasetクラスは、複数のデータソースを組み合わせる場合の例です。
4. データセットの使用例
これらのデータセットクラスは、以下のように使用することができます。
# CSVデータセットの使用 csv_dataset = CSVDataset('data.csv') csv_data = csv_dataset.get_data() # 時系列データセットの使用 ts_dataset = TimeSeriesDataset('timeseries.csv', 'date', 'value') ts_data = ts_dataset.get_data() daily_data = ts_dataset.resample('D') # 複数ソースのデータセットの使用 multi_dataset = MultiSourceDataset('data1.csv', 'data2.json') combined_data = multi_dataset.get_data()