nodes/da2el-ai-D2-nodes-ComfyUI
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
da2el-ai-D2-nodes-ComfyUI/docs/en/node_xy.md
T
da2el-aiandClaude Opus 5.5 9cd412e79f docs: document LIST/ARRAY renaming and D2 List Converter and bump to 43.0.0 
Add a 2026.11.04 notice to README explaining that many node inputs and
outputs were renamed or reordered and need reconnecting, and update the
ja/en/zh node docs and changelog for LIST/ARRAY, x / y_items, the new
D2 List Converter and the deprecated list nodes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 01:16:42 +09:00

11 KiB
Raw Permalink Blame History

English | 日本語 | 繁体中文

Node

TIPS

  • I've written an article summarizing how to use XY Plot, so please refer to it as well.

  • Please refer to the sample workflow.

  • The processing order is x_items > y_items. When the order matters, such as for prompt rewriting, make sure it is arranged as x > y.

  • All of x_items is processed before moving on to the next y_items. For heavy processes such as loading a Checkpoint, it is recommended to use y_items.

  • Nodes that output lists have the following three outputs.

    • x / y_items: Newline-separated text. Connect it to x_items / y_items of D2 XY Plot
    • LIST: Outputs items one by one (ComfyUI's list). The connected node runs once per item. Connect it to ComfyUI's built-in Start Loop (List mode) to loop
    • ARRAY: Outputs the array as a single value (ComfyUI's built-in Array type). It can be converted to other formats with D2 List Converter

🍅 XY Plot Node

D2 XY Plot Easy / Easy Mini

  • A node that creates XY Plots with simplified workflow limited to KSampler parameters
  • Easy Mini is a node that excludes rarely used outputs and has a smaller size

Input

  • positive / negative / seed / steps / cfg / sampler_name / scheduler / denoise
    • Settings to pass to KSampler
  • ckpt_name
    • Checkpoint model to pass to D2 Checkpoint Loader
  • unet_name
    • Diffusion model to pass to D2 Load Diffusion Model
  • ckpt_type
    • Selects whether to use ckpt_name or unet_name
    • stable_diffusion: Uses ckpt_name for the ckpt_name output
    • diffusion: Uses unet_name for the ckpt_name output
  • x_type / y_type
    • Specify items to execute in XY Plot
    • When STRING, INT, or FLOAT is specified, output will be from x_other, y_other
  • x_items / y_items
    • XY Plot modification contents
    • Since it's newline-separated text, input from other nodes is possible
  • auto_queue
    • true: Automatically executes Queue the required number of times
    • false: Manually execute Queue
  • Reset index
    • Reset index with this button when stopped midway

Output

  • xy_pipe
    • Collectively outputs parameters used in D2 KSampler
  • grid_pipe
    • Collectively outputs parameters x_annotation y_annotation status used in D2 Grid Image
  • positive / negative / seed / steps / cfg / sampler_name / scheduler / denoise
    • Parameters to pass to KSampler
  • ckpt_name
    • Model name selected by ckpt_type (ckpt_name if stable_diffusion, unet_name if diffusion)
  • ckpt_type
    • Outputs the ckpt_type selected in the input as-is
  • x_other / y_other
    • Outputs from here when x_type y_type is set to STRING INT FLOAT
  • x_annotation / y_annotation
    • Header text to connect to D2 XY Grid Image
  • status
    • Control signal to connect to D2 XY Grid Image
  • index
    • Current processing count

D2 XY Plot

  • Node for creating versatile XY Plot workflows
  • X/Y inputs are simple newline-separated text for easy combination with other nodes

Input

  • x_type / y_type
    • Specify data type of x_items y_items from STRING INT FLOAT
  • x_title / y_title
    • Text to add to header text
  • x_items / y_items
    • XY Plot change contents
    • Newline-separated text that can be input using other nodes
  • auto_queue
    • true: Automatically execute required number of Queues
    • false: Manually execute Queue
  • Reset index
    • Reset index with this button when stopped midway

Output

  • X / Y
    • Elements retrieved from x_items y_items
  • x_annotation / y_annotation
    • Header text to connect to D2 XY Grid Image
  • status
    • Control signal to connect to D2 XY Grid Image
  • index
    • Current processing count

D2 XY Grid Image

  • Grid image creation node used with D2 XY Plot

Input

  • x_annotation / y_annotation
    • Header text for grid image
  • status
    • Control text from D2 XY Plot
    • INIT: Initialize
    • FINISH: Output grid image
    • {empty string}: Other states
  • font_size
    • Header text font size
  • grid_gap
    • Gap between images
  • swap_dimensions
    • true: Vertical grid
    • false: Horizontal grid
  • grid_only
    • true: Output only grid image
    • false: Output individual images too

Output

  • image
    • Outputs the generated grid image
  • memo
    • Outputs a text list of the generation parameters

memo output

Outputs a text list of the parameters compared in the XY Plot. It is intended to be connected to memo_text of D2 Save Image Eagle.

-----------
X: positive
black hair,
blonde hair,
silver hair,

-----------
Y: steps
20
15
10

D2 XY List Collector

  • A node that accumulates data into an array along with the loop execution of D2 XY Plot / D2 XY Plot Easy / D2 XY Plot Easy Mini, and outputs the whole array on the last run
  • Downstream nodes are not executed while accumulating
  • If D2 XY Plot has only one item, FINISH never occurs, so nothing is output

Input

  • data
    • Data to add to the array
  • skip_empty
    • true: Empty values such as an empty string or 0 are not added to the array
    • false: Empty values are added as they are
  • xy_status
    • Control text from D2 XY Plot
    • INIT: Initialize the array
    • FINISH: Output the array
    • {empty string}: Other states
  • grid_pipe
    • Connect grid_pipe of D2 XY Plot Easy / D2 XY Plot Easy Mini
    • Used instead of xy_status. D2 XY Plot Easy Mini does not output status, so connect this one

Output

  • LIST
    • Outputs the accumulated data one by one. The connected node runs once per item
  • ARRAY
    • Outputs the accumulated data as an array
  • Both accept any data type

D2 XY Prompt SR

  • Search and replace input text to pass to D2 XY Plot
  • Can output as list

Input

  • prompt
    • Prompt. Can include newlines
  • search_txt
    • Search target text. Can include multiple words
    • Cannot use newlines
  • replace
    • Replacement text
    • OK to include "," as it's separated by newlines

Output

  • x / y_items
    • Connect to D2 XY Plot
  • LIST / ARRAY
    • Outputs the replaced text (see TIPS)

D2 XY Prompt SR2

  • Search and replace prompts received from D2 XY Plot before passing to KSampler
  • Use this to recreate Stable Diffusion webui A1111's Prompt S/R

Input

  • x_y
    • Replacement text received from D2 XY Plot
  • prompt
    • Target text for replacement
  • search
    • Search text. Can include multiple words
    • Cannot use newlines

D2 XY Seed

  • Outputs random number when -1 is specified
  • Other numbers are output as-is
  • Must set x/y_type to INT on D2 XY Plot side
  • Outputs are x / y_items / LIST / ARRAY (see TIPS)

D2 XY Seed2

  • A node that outputs a specified number of seed values
  • Outputs are x / y_items / LIST / ARRAY (see TIPS)

input

  • initial_number
    • This value is used as a reference when mode is set to increment, decrement, or fixed
  • count
    • Number of seed values to generate
  • mode
    • fixed: Outputs only the initial_number
    • increment: Adds 1 to initial_number for each value
    • decrement: Subtracts 1 from initial_number for each value
    • randomize: Outputs random numbers regardless of initial_number

D2 XY Checkpoint List / D2 XY Lora List

Removed. Please use D2 XY Model List instead.

D2 XY Model List

  • A node that passes Checkpoint/Lora to D2 XY Plot
  • Useful when you want to get a large list of models but don't want to select them one by one in D2 Checkpoint List
  • Click get_list to retrieve the model list, then edit it to keep only the ones you need
  • Outputs are x / y_items / LIST / ARRAY (see TIPS)

input

  • model_type
    • checkpoints, loras, diffusion_models, samplers, schedulers, upscaler, bbox_segm, controlnet
  • filter
    • Enter text to filter
    • Regular expressions are supported
    • When including \ in search text, write it as \\
  • get_list
    • Button to retrieve model list

D2 XY Upload Image

  • A node for uploading multiple image files at once
  • Files can be uploaded to a temporary folder by drag and drop
  • The paths of uploaded files are displayed in the text area
  • Designed to be connected to D2 Load Image via D2 XY Plot Easy
  • Outputs are x / y_items / LIST / ARRAY (see TIPS) and the file count image_count

D2 XY Folder Images

  • Node to pass file paths from specified folder to D2 XY Plot
  • Despite the name "Images", it is not limited to images. By setting extension, it can handle any kind of file, such as text or video
  • Set include_subfolders to true to also include files in subfolders (you can also write ** directly in folder)
  • extension can specify multiple extensions comma-separated, like *.png, *.jpg, *.webp
  • Outputs are x / y_items / LIST / ARRAY (see TIPS) and the file count image_count

D2 XY Annotation

  • Used to add headers when not using D2 XY Plot or when doing special XY Plot

D2 XY List To Plot

Deprecated. Please use D2 List Converter instead.

D2 XY String To Plot

  • Converts multiline text to be compatible with D2 XY Plot / D2 XY Plot Easy
  • Used when you want to perform XY Plot comparisons of entire prompts
  • When using with D2 XY Plot Easy for prompt comparison, set x/y_type to STRING and connect x/y_other to the positive input of D2 KSampler
  • x / y_items outputs each text with its line breaks removed. LIST / ARRAY output the text with line breaks kept (see TIPS)
Reference in New Issue View Git Blame Copy Permalink