Shuffle Image Batch(ShuffleImageBatch)

Shuffle Image Batch ノードは、技術的には形状が (B, H, W, C) の4次元テンソルを入力として受け取ります。ここで、B、H、W、C はそれぞれバッチサイズ、画像の高さ、幅、チャネル数を表します。

Shuffle Image Batch ノードは、画像バッチの順序をランダムにシャッフルするためのツールです。その中核機能は、複数の画像を含むバッチを受け取り、それらの画像をランダムな順序で並べ替えることです。これは、画像処理パイプラインにランダム性を導入し、固定された順序によって生じる可能性のあるパターンを回避するのに役立ちます。

ノード機能

このノードは、技術的には形状が (B, H, W, C) の4次元テンソルを入力として受け取ります。ここで、B、H、W、C はそれぞれバッチサイズ、画像の高さ、幅、チャネル数を表します。ノード内部では、PyTorch の torch.randperm 関数を使用し、ユーザーが提供するシード値に基づいてランダムな順列インデックスを生成します。その後、このインデックスに従ってバッチ次元上の画像を並べ替え、形状は変わらないが画像の順序がシャッフルされた新しいバッチを出力します。

ノードパラメータ説明 - Shuffle Image Batch

接続入力 (Inputs)

コントロールパラメータ (Parameters)

出力

使用シナリオ

具体的なアプリケーションでは、このノードはデータ拡張や多様なプレビュー画像ギャラリーの作成によく使用されます。例えば、バッチで画像を生成するパイプラインにおいて、複数のジェネレーターの出力をマージした後、このノードで順序をシャッフルし、その後続のプレビューやフィルターノードに送ることで、異なる生成条件下での結果をより公平に比較したり、トレーニングセット用にランダム化されたサンプルを準備したりすることができます。

注意事項

このノードは、バッチ内の画像の順序のみを変更し、個々の画像のピクセルコンテンツは一切変更しないことに注意してください。そのランダム性は完全にシードパラメータによって制御され、同じシードを使用すると常に同じシャッフル順序が得られます。

Shuffle Image Batch ノードソースコードリンク

Shuffle Image Batch ノードは ComfyUI-KJNodes ノードパッケージに含まれています。