XY Inputs: Controlnet //EasyUse(XYplot_Control_Net)

Description

Generates an X/Y input set for sweeping ControlNet parameters. It lets an XY Plot node test different ControlNet settings—strength, start percent, or end percent—while keeping the other ControlNet parameters fixed. The node uses one ControlNet model and one input image, and produces evenly spaced samples between the specified first and last values.

Inputs

Required

• control_net_name (COMBO): The ControlNet model to use. The dropdown lists the ControlNet models available in the current workflow/environment. If the optional control_net input is connected, that loaded model is used instead.

• image (IMAGE): The ControlNet input image. The same image is used for every generated sample in this XY run.

• target_parameter (COMBO): The ControlNet parameter to sweep. The available choices are the three parameters that have first/last value pairs below: strength, start_percent, and end_percent.

• batch_count (INT, default 3, min 1, max 30): The number of values to generate for the sweep. A larger count produces a finer grid but requires more samples when rendered by XY Plot.

Sweep range

• first_strength / last_strength (FLOAT, default 0 / 1, min 0, max 10, step 0.01): Start and end values used when target_parameter is strength. Conventional ControlNet strength range is 0 to 1, but higher values are accepted.

• first_start_percent / last_start_percent (FLOAT, default 0 / 1, min 0, max 1, step 0.01): Start and end values used when target_parameter is start_percent. start_percent is the denoising step (as a fraction from 0 to 1) at which the ControlNet begins applying.

• first_end_percent / last_end_percent (FLOAT, default 0 / 1, min 0, max 1, step 0.01): Start and end values used when target_parameter is end_percent. end_percent is the denoising step at which the ControlNet stops applying.

Constant parameter values

These values apply to the parameters that are not being swept:

• strength (FLOAT, default 1, min 0, max 10, step 0.01): The fixed ControlNet strength used when another parameter is selected as target_parameter.

• start_percent (FLOAT, default 0, min 0, max 1, step 0.01): The fixed start percent used when another parameter is selected.

• end_percent (FLOAT, default 1, min 0, max 1, step 0.01): The fixed end percent used when another parameter is selected.

Optional

• control_net (CONTROL_NET, optional): An already-loaded ControlNet object. Connect this when you want to use an existing loaded/modified model instead of loading by control_net_name.

Outputs

• X_Y (X_Y): The generated XY data for downstream plotting. Plug this output into an XY Plot node's XY input.

Usage Notes

• Decide which single ControlNet parameter to test and set target_parameter to the matching option. The corresponding first/last pair is used to create batch_count evenly spaced values. The first and last values are inclusive, and intermediate values are evenly spaced.

• The plain parameters provide the non-swept values. For example, if target_parameter is start_percent, the sweep is controlled by first_start_percent and last_start_percent, while strength and end_percent stay fixed at their plain input values.

• start_percent and end_percent use fractions of the denoising process: 0 is the beginning, 1 is the end. The end percent should normally be greater than or equal to the start percent for a valid ControlNet influence window.

• The input image is not varied by this node. If you need to compare ControlNet behavior across different reference images, use a separate mechanism before this node or perform multiple XY runs.

• The node only builds the X/Y data; it does not run sampling itself. Use it together with an XY Plot node to render the grid.