Insert Latent To Index (InsertLatentToIndex) - ComfyUI-KJNodes

Insert Latent To Index ノードは、2つの LATENT タイプの入力を受け取り、4D（B, C, H, W）および 5D（B, C, T, H, W）テンソルフォーマットをサポートします。

Insert Latent To Index ノードは、ある潜在表現（latent）バッチを別の潜在バッチ内の指定された位置に挿入するために使用されます。その中核機能は、ターゲットバッチ内の特定のインデックスにある潜在サンプルを置き換えることで、潜在空間の精密な編集と組み合わせを実現します。

ノード機能

このノードは2つの LATENT タイプの入力を受け取り、4D（B, C, H, W）および 5D（B, C, T, H, W）テンソルフォーマットをサポートします。その内部メカニズムは、PyTorch の torch.cat 関数を使用して、ソーステンソル（source）をターゲットテンソル（destination）の指定されたインデックス（index）の前に連結し、元のターゲットテンソルがそのインデックスに持っていたデータをスキップし、最終的に新しい組み合わされた潜在テンソルを出力します。

ノードパラメータ説明 - Insert Latent To Index

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`source`	LATENT	はい	-	-	source（入力パラメータ）：挿入するソース潜在表現バッチを提供します。
`destination`	LATENT	はい	-	-	destination（入力パラメータ）：変更されるターゲット潜在表現バッチを提供します。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`index`	INT	はい	0	-1 - 4096 (ステップ: 1)	index（入力パラメータ）：ソース潜在表現がターゲットバッチ内に挿入される位置を指定します。範囲は -1 から 4096 です。

出力 (Output)

パラメータ名	データ型	説明
LATENT	LATENT	LATENT（出力パラメータ）：マージされた新しい潜在表現バッチを出力します。

使用シナリオ

画像生成ワークフローにおいて、このノードはバッチ生成内の特定の1枚の画像の潜在表現を置き換えるために使用できます。例えば、一組の人物ポートレートを生成した後、その中の3枚目の画像を別のより満足のいく顔の特徴を持つものに置き換えたい場合、新しい顔の潜在表現を source として、元のバッチを destination として、index を 2 に設定することで置き換えを完了できます。

注意事項

使用時には、指定されたインデックス値がターゲット潜在バッチの有効な範囲内にある必要があり、そうでない場合ノードはエラーを報告します。4Dテンソルの場合、インデックスはバッチ次元（B）に対応します。5Dテンソルの場合、インデックスは時間次元（T）に対応します。

Insert Latent To Index ノードソースコードリンク

Insert Latent To Index ノードは ComfyUI-KJNodes ノードパッケージに由来します。

Insert Latent To Index(InsertLatentToIndex)