UltralyticsDetector (Pipe)(ultralyticsDetectorForDetailerFix)

説明

UltralyticsDetector (Pipe) ノードは、Ultralytics YOLO モデルからバウンディングボックス検出器を作成し、Easy-Use DetailerFix パイプラインで使用するための PIPE_LINE としてパッケージ化します。EasyUse/Fix カテゴリに属し、検出されたオブジェクトが後で行われる fix ステージによって修復または微調整されるワークフロー向けに設計されています。このノードは修復自体は行わず、パイプライン pipe の一部として検出器の設定を提供するだけです。

入力

model_name

• タイプ: COMBO
• 必須: True

読み込む Ultralytics 検出モデルを選択します。ドロップダウンには、ComfyUI で利用可能な Ultralytics モデルが一覧表示されます。画像内のオブジェクトを特定するために使用するモデルを選択してください。

bbox_threshold

• タイプ: FLOAT
• 必須: True
• デフォルト: 0.5
• 最小: 0
• 最大: 1
• ステップ: 0.01

検出されたバウンディングボックスの信頼度しきい値です。この値を超える信頼度を持つ検出のみが保持されます。しきい値を上げると誤検出が減り、下げると検出候補が増えます。

bbox_dilation

• タイプ: INT
• 必須: True
• デフォルト: 10
• 最小: -512
• 最大: 512
• ステップ: 1

detailer fix で使用される前に、検出された各バウンディングボックスをこのピクセル数だけ拡張します。正の値は検出されたオブジェクトの周囲のボックスを拡大し、有用なコンテキストを追加します。負の値はボックスを縮小するため、検出器が大きすぎるボックスを返す場合に役立ちます。

bbox_crop_factor

• タイプ: FLOAT
• 必須: True
• デフォルト: 3.0
• 最小: 1.0
• 最大: 10.0
• ステップ: 0.1

fix ステージ用にクロップを準備するときに、検出されたバウンディングボックスをどの程度拡大するかを制御します。値が大きいほど周囲のコンテキストが多く提供され、値が小さいほどクロップが元のバウンディングボックスに近くなります。

出力

• PIPE_LINE: 設定済みの Ultralytics バウンディングボックス検出器とその設定を含むパイプラインオブジェクトです。これを後続の DetailerFix / 修復ノードの pipe 入力に接続します。

使用上の注意

• これは画像処理を行うノードではなく、検出器プロバイダーです。画像やマスクは返しません。検出器の設定をパイプライン pipe に配置します。
• bbox_threshold はおよそ 0.5 から始め、検出漏れや誤検出に応じて調整してください。
• bbox_dilation を使用して、fix ステージでオブジェクトが十分に含まれるようにバウンディングボックスを調整します。検出されたボックスが大きすぎる場合は、負の dilation も使用できます。
• bbox_crop_factor は、修正領域に含まれる周囲のコンテキストの量を制御します。値が大きいほど多くのコンテキストが含まれますが、fix ステージが処理する領域も大幅に広くなる可能性があります。
• 典型的な Easy-Use DetailerFix グラフでは、このノードの PIPE_LINE を fix ノードに接続し、fix ステージで処理する画像を渡します。