Documentation for the "Join XY Inputs of Same Type" Node

Overview

The "Join XY Inputs of Same Type" node is part of the Efficiency Nodes collection for ComfyUI. This node is designed to combine two XY inputs of the same type into a single output, allowing for more flexible and dynamic workflow setups in ComfyUI.

Purpose

This node aims to streamline workflows by enabling users to merge two separate sets of XY inputs, provided they are of the same type. This is particularly useful when you want to test a range of configurations in a single workflow, making it easier to compare results across multiple parameters without manually adjusting inputs.

Inputs

Required Inputs

1. XY_1: The first XY input that the node will process. This input should be of a type that is compatible with the second XY input.

2. XY_2: The second XY input that the node will process. This input should be of the same type as the first XY input.

Outputs

XY Output

• The node produces one output called "X or Y," which is an XY input combining the values from both input connections. This combined output can then be used in subsequent nodes in a ComfyUI workflow to plot or apply parameters across multiple dimensions.

How to Use in ComfyUI Workflows

1. Setting Up Inputs: Connect two XY inputs of the same type to XY_1 and XY_2. Ensure that both inputs are properly configured before merging.

2. Integration: After combining the inputs, use the resulting output in other nodes to apply changes across dimensions or visualize the combined data in a plot. This can be particularly useful in workflows where you want to compare results using different settings or parameters.

3. Comparative Analysis: The node is ideal for use cases where comparing different parameters is essential. By joining XY inputs, you can efficiently analyze the effects of changing specific variables without needing separate workflows for each parameter set.

Special Features or Considerations

• Matching Types: Before using this node, ensure that the two inputs you intend to combine are of the same type. The node does not support mismatched inputs, and an error will be thrown if the types do not align.

• Handling of Special Types: For certain types like "Seeds++ Batch" or prompt search and replace (S/R), the node handles specific concatenation rules to ensure the combined inputs are structurally consistent and meaningful.

• Efficiency in Workflow: Using this node can significantly reduce the number of manual adjustments required in a multi-dimensional workflow, particularly in complex projects that leverage extensive parameter testing.

For more detailed examples and usage scenarios, you may refer to the Efficiency Nodes Wiki on GitHub.