Get Latents From Batch Indexed (GetLatentsFromBatchIndexed) - ComfyUI-KJNodes

Get Latents From Batch Indexed ノードは、BCHW、BTCHW、BCTHW の3つの異なる潜在データフォーマットをサポートします。

Get Latents From Batch Indexed ノードは、潜在空間データを処理するためのツールです。その中核機能は、複数の潜在ベクトルを含むバッチから、ユーザーが指定したインデックス位置に基づいて、特定の1つまたは複数の潜在ベクトルを正確に選択し、それらを新しいバッチとして出力することです。

ノード機能

このノードは、BCHW、BTCHW、BCTHW の3つの異なる潜在データフォーマットをサポートします。ユーザーは latent_format パラメータで入力データの次元構造を指定し、ノード内部はこのフォーマットに基づいてバッチ次元を解析し、PyTorchのテンソルインデックス機能を使用して、入力された latents から indexes パラメータで指定された潜在ベクトルを抽出します。その中核メカニズムは、ユーザーが入力したカンマ区切りのインデックス文字列を整数リストに変換し、それに基づいてデータスライスを行うことです。

ノードパラメータ説明 - Get Latents From Batch Indexed

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`latents`	LATENT	はい	-	-	バッチの潜在ベクトルを含む入力データ。ノードはこのデータから指定されたインデックスのサンプルを抽出します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`latent_format`	COMBO	はい	BCHW	"BCHW", "BTCHW", "BCTHW"	入力潜在データのフォーマットを指定します。"BCHW"（バッチ、チャネル、高さ、幅）、"BTCHW"（バッチ、時間、チャネル、高さ、幅）、または "BCTHW"（バッチ、チャネル、時間、高さ、幅）のいずれかです。ノードはこのフォーマットに基づいてバッチが存在する次元を決定し、インデックス操作を行います。
`indexes`	STRING	はい	0, 1, 2	-	バッチ内で抽出する潜在ベクトルのインデックス位置を指定します。入力形式はカンマ区切りの整数文字列です（例："0, 2, 5"）。

出力 (Output)

パラメータ名	データ型	説明
LATENT	LATENT	選択されたインデックスに対応する潜在ベクトルのみを含む新しいバッチデータを出力します。

使用シナリオ

ビデオ生成や画像シーケンス処理のワークフローにおいて、このノードは非常に有用です。例えば、バッチ処理ノードを使用して複数のタイムステップ（フレーム）を含む潜在ベクトルシーケンスを生成した後、このノードを使用してシーケンス内の1、3、5フレーム目などを素早く抽出し、後続の個別編集や分析を行うことができます。これにより、生成コンテンツのきめ細かい制御が可能になります。

注意事項

入力するインデックス値は、入力バッチの有効範囲内の整数であり、カンマで区切られている必要があります。指定されたインデックスがバッチの実際のサイズを超えている場合、実行時エラーが発生する可能性があります。

Get Latents From Batch Indexed ノードソースコードリンク

Get Latents From Batch Indexed ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Get Latents From Batch Indexed(GetLatentsFromBatchIndexed)