Boltz Property Builder¶
Creates property specifications to include in a Boltz YAML configuration. Currently supports affinity prediction by specifying which chain is the binder (typically a ligand). Outputs a properties list ready to be merged with sequences, constraints, and templates.
Usage¶
Use this node when you want to request additional properties (e.g., affinity) during structure prediction. Provide the binder chain ID (matching the ligand chain in your sequences), then combine the resulting properties with sequences (and optionally constraints/templates) using Boltz List Combiner and feed them into the Boltz YAML Combiner before running prediction.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| property_type | True | enum['affinity'] | Which property to compute. Only 'affinity' is supported. | affinity |
| binder_chain | True | STRING | Chain ID of the binder (usually a ligand) to evaluate affinity for. Must correspond to a ligand chain defined in the sequences. | L |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| properties | * | A list of property entries to be included under 'properties' in the Boltz YAML. For affinity, each entry specifies the binder chain. | [{'affinity': {'binder': 'L'}}] |
Important Notes¶
- Only 'affinity' property is supported by this node.
- Binder chain ID is required and must match a ligand chain defined in the sequences.
- To actually compute affinity, your YAML must include at least one ligand sequence; the downstream prediction will validate this.
- The output should be combined with other BOLTZ objects using Boltz List Combiner and then passed to the Boltz YAML Combiner.
Troubleshooting¶
- Error: 'Binder chain ID is required' — Provide a non-empty binder_chain matching your ligand chain (e.g., 'L').
- Error: 'Unsupported property type' — The node currently supports only 'affinity'. Select 'affinity'.
- Downstream error: 'Affinity prediction requires at least one ligand sequence' — Ensure your sequences include a ligand entry with the same chain ID as 'binder_chain'.