XY Plot Node Documentation

Overview

The XY Plot node is a powerful tool within the Efficiency Nodes for ComfyUI, designed to streamline and optimize visualization and analysis of various parameters within your ComfyUI workflows. It facilitates the generation of grid plots by varying specified parameters for different UI components across X and Y axes, allowing users to explore and compare results effectively.

Node Functionality

Purpose

The XY Plot node enables the creation of parameterized plots on a grid, assisting users in visualizing how changes to specific variables affect workflow outcomes. By providing a structured comparison across multiple parameter values, users can easily understand and adjust their UI configurations for optimal performance and visual output.

Advantages

• Allows for exploring a wider range of parameter variations within a single plot.
• Simplifies comparison and analysis by organizing visual outputs on a grid.
• Supports various configurations, including Prompt S/R, model weights, and other feature settings.

Inputs

The XY Plot node accepts a set of parameters that define both the plotting behavior and the variables to be plotted across the grid:

1. Grid Spacing: Determines the distance between images in the grid, enhancing visibility and clarity.
2. XY Flip: Allows swapping of X and Y axes, enabling flexible parameter visualization.
3. Y Label Orientation: Configures the orientation of labels along the Y-axis to either Horizontal or Vertical, improving readability.
4. Cache Models: Dictates whether models should be cached for plotting, impacting performance and resource usage.
5. KSampler Output Image: Sets whether individual images or the entire plot is output from KSampler nodes.

Optional Inputs

• Dependencies: The node can take additional dependency connections to ensure correct configurations are used for parameters that require specific settings.
• X/Y Parameters: Accepts XY Input types that define the specific parameters to plot on the X and Y axes (e.g., Seeds, Steps, CFG Scale, VAE names).

Outputs

The primary output of the XY Plot node is a script object that coordinates with KSampler nodes to generate the grid plot:

1. Script: Facilitates the execution of multiple parameterized runs, drawing images on a grid according to the specified settings.

How to Use the XY Plot Node in Workflows

Example Usage

Incorporate the XY Plot node in your ComfyUI workflow for visual exploration. By adjusting inputs to define parameters of interest, users can directly visualize how different values affect workflow outputs. For instance, varying model strengths or VAE parameters over a range can quickly reveal optimal settings for desired results.

Steps for Use

1. Connect the XY Plot node to existing workflow components.
2. Specify inputs such as the parameters you wish to explore on both X and Y axes.
3. Define grid spacing and label orientations based on visualization needs.
4. Run the workflow, producing a grid plot that helps in effective evaluation of parameter impacts.

Special Features and Considerations

Features

• Flexible Parameterization: Supports a wide array of parameter types, providing extensive customization in grid plotting.
• Model Caching: Optimizes workflow performance by caching models, preventing reloading delays during plotting.

Considerations

• Ensure that dependencies are correctly configured when plotting certain types that rely on external configurations (e.g., Checkpoints, VAEs).
• Note potential performance impacts with high-complexity grid plots; appropriate grid spacing and caching settings can mitigate these effects.
• Supports advanced configurations such as XY Input nodes to dynamically define parameter ranges and types, enhancing workflow versatility.

For additional information on use cases and setup instructions, refer to the Efficiency Nodes Wiki for detailed guidance and community insights on leveraging the XY Plot node within ComfyUI.