List Zip

Overview

Pairs two lists by matching item positions. It creates a correspondence table from a size sequence and a color sequence—first size + first color, and so on—so a downstream list_map expression can use both values at once.

Usage tips

• In a list_map after the zip, use a / b directly in expressions such as a + b. The standard flow combines two numeric sequences into one.
• Use cartesian_product when you need every combination. Zip creates only corresponding pairs.
• When the lengths differ, the result is truncated to the shorter list and extra items are discarded. Keeping candidate counts equal is safest.

Related nodes

• cartesian_product — every combination instead of pairs
• list_map — consume the zipped result
• list_enumerate — add indices to a single list only
• variant_range / seed_range — generate input lists

Read this first

• ListZip pairs items at the same index.
• Its length matches the shorter list.

Start with this example

Provide these two lists:

a = [10, 20, 30]
b = ["A", "B"]

The resulting entries value is:

[
  { "index": 0, "a": 10, "b": "A" },
  { "index": 1, "a": 20, "b": "B" }
]

The count is:

count = 2

How downstream nodes see it

When you feed these entries to ListMap or ListFilter, you can use these names directly in expressions:

• index
• a
• b

For example:

a + b
a * 10 == b

When to use it

• To associate a list of values with a list of labels
• To pair a seed list with another parameter list
• To group two candidate sequences by matching positions

Notes

• Extra items are discarded.
• A Palette is treated as List<Color>.