Boltz List Combiner¶
Combines multiple BOLTZ objects (sequences, constraints, templates, properties) into a single ordered list. Accepts up to 50 inputs and flattens any inputs that are already lists. If no inputs are provided, it raises an error.
Usage¶
Use this node to gather all BOLTZ components you’ve built into one list before assembling a final YAML or submitting for prediction. Typically, connect outputs from Boltz Sequence/Constraint/Template/Property builders; if any of those already output lists, they will be flattened into a single combined list.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| input_1 | True | * | First BOLTZ object or list of objects to include. Enables subsequent inputs after connection. | A single sequence object or a list like [sequence1, sequence2] |
| input_2 | False | * | Second BOLTZ object or list of objects. Hidden until input_1 is connected. | A constraint object or [constraint1, constraint2] |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| combined_list | * | A single flattened list containing all provided BOLTZ objects in the order they were connected. | [sequence1, sequence2, constraint1, templateA, propertyX] |
Important Notes¶
- Input fan-out: if an input provides a list, those items are appended individually; single objects are appended as-is.
- At least one input is required; otherwise the node raises an error.
- Inputs are revealed progressively: input_2 is hidden until input_1 is connected, and so on.
- The node does not validate object types; ensure you only combine valid BOLTZ objects intended for downstream nodes.
- Order is preserved based on input index, then the order within any list passed into that input.
- Maximum of 50 inputs; consider pre-combining if you need more.
Troubleshooting¶
- Error: 'At least one input is required' — Connect at least one BOLTZ object to input_1.
- Inputs after input_1 are not visible — Connect input_1 first; each subsequent input becomes available only after the previous is set.
- Output contains nested lists — This node flattens only the top-level input lists; ensure you do not pass lists-of-lists unless nesting is intended to remain inside items.
- Unexpected item order — The output list preserves the order of inputs (input_1 before input_2, etc.) and the internal order of any lists provided.
- Exceeded maximum inputs — Only input_1 through input_50 are processed; pre-merge items using upstream nodes if needed.