潜在変数テンソルの保存 (Save Latent Tensor)

LatentArtifact を PyTorch の .pt ファイルとしてディスクに書き出します。デバッグやオフラインのテストフィクスチャ作成に有用です。

カテゴリ: ModularDiffusion/IO

概要 (TL;DR)

デコードされた画像ではなく、raw 潜在変数テンソルそのものを保存します。ワークフローに再読み込みする場合は、torch.load(...) で .pt を読み込んで LatentArtifact にラップします（またはカスタムコード内で直接使用します）。
出力ポート（saved_path）には解決された絶対パスが出力されるため、ログ出力ノードやメタデータノードにチェーン接続できます。

Generate Media Latents → [Save Latent Tensor]
                       └→ Decode Media Latent → Save Image

名前	型	必須	備考
`latent_tensor`	`LatentArtifact`	はい	保存する潜在変数テンソル。

名前	型	備考
`saved_path`	str	テンソルが書き込まれた絶対パス。

名前	型	デフォルト	備考
`file_path`	str	`debug/latent.pt`	出力ファイルパス。相対パスはワークスペースディレクトリを基準に解決されます。親フォルダは自動的に作成されます。

テンソルは保存前に detach され CPU に転送されます: 任意のデバイスで安全にリロードできます。
raw テンソル以外のメタデータは保存されません: 潜在変数のアンパックに使用される source_shape などの情報が必要な場合は、別途記録してください。
.pt ファイルのサイズ: 1024×1024 の SDXL 潜在変数は約 4 MB ですが、LTX などの動画潜在変数は数百 MB に達する場合があります。