XY Plot(pipeXYPlot)

Description

The XY Plot node (pipeXYPlot) generates a grid of results by varying parameters along the X and Y axes. It is designed to work with Easy-Use pipelines (PIPE_LINE), taking a base pipeline as input and returning a pipeline that contains the plotted result. This is useful for parameter sweeps, comparing sampling settings, or visualising combinations of two variables.

Inputs

grid_spacing

• Type: INT
• Default: 0
• Range: 0 to 500 (step 5)

Padding, in pixels, between the cells of the output grid. 0 produces a tightly packed grid; larger values add visible gaps between each generated image.

output_individuals

• Type: COMBO
• Options: ["False", "True"]
• Default: "False"

When set to "True", the individual images generated for each point on the XY grid are preserved in the output pipeline alongside the combined grid. When "False", only the assembled grid is kept. This is useful if you want to process each variation separately rather than only as a single grid image.

flip_xy

• Type: COMBO
• Options: ["False", "True"]
• Default: "False"

Swaps the X and Y axes. When "True", the parameter selected for x_axis is plotted vertically and the parameter selected for y_axis is plotted horizontally.

x_axis

• Type: COMBO
• Default: "None"

The parameter to vary along the horizontal axis. The available options depend on the contents of the pipeline. Setting this to "None" disables the X axis; any value in x_values is then ignored.

x_values

• Type: STRING
• Default: ""

A comma-separated list of values for the selected x_axis. For example, 1,2,4,8 for step counts or 0.5,1.0 for CFG values. Whitespace around values is usually trimmed.

y_axis

• Type: COMBO
• Default: "None"

The parameter to vary along the vertical axis. The available options depend on the contents of the pipeline. Setting this to "None" disables the Y axis; any value in y_values is then ignored.

y_values

• Type: STRING
• Default: ""

A comma-separated list of values for the selected y_axis.

pipe

• Type: PIPE_LINE
• Optional: yes

An Easy-Use pipeline that provides the base model, conditioning, or other context used to run the XY variations. Connect the pipeline from a previous Easy-Use node; the XY Plot node will modify it and pass it on through its output.

Outputs

PIPE_LINE

• Type: PIPE_LINE

The input pipeline with the XY plot result attached. Connect this to downstream Easy-Use nodes to view, save, or further process the generated grid.

Usage Notes

• Choose an x_axis and/or y_axis, then enter the corresponding values as comma-separated strings. The node generates the cartesian product of the X and Y values.
• If only one axis is configured, the output is effectively a single row or column of images.
• Use grid_spacing to add breathing room between cells in the grid.
• Use flip_xy to change the orientation of the grid after you have already set up your axes.
• output_individuals is useful when each variation needs to be accessed independently, for example when sending results to a batch-save node or a comparison display.
• When an axis is set to "None", its corresponding values string is ignored, so you can safely leave it blank.