Boltz Property Builder¶
Creates a Boltz-compatible property specification object. Currently supports configuring affinity prediction by specifying the binder (ligand) chain ID. The node validates inputs and produces a properties payload ready to be combined into a Boltz YAML configuration.
Usage¶
Use this node when you need to request property predictions (e.g., affinity) for a modeled complex. Connect it alongside sequence/template/constraint builders, then merge outputs with a Boltz List/YAML Combiner before sending to a Boltz Predict or Partial Diffusion node. Provide the chain ID of the ligand/binder involved in the prediction.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| property_type | True | CHOICE | Type of property to predict. Currently only 'affinity' is supported. | affinity |
| binder_chain | True | STRING | Chain ID of the binder (ligand) in the complex for which the property will be predicted. | B |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| properties | * | A list containing a Boltz property object. For affinity, it specifies the binder chain to be used during prediction. | [{'affinity': {'binder': 'B'}}] |
Important Notes¶
- Only 'affinity' is supported: Other property types are not accepted and will result in an error.
- Binder chain is mandatory: The binder_chain input must be a non-empty string corresponding to a valid chain in your complex.
- Output is a list: The node returns a list of property objects, enabling easy merging with other Boltz objects via a List or YAML Combiner.
- Downstream compatibility: Designed for integration into Boltz YAML configurations consumed by prediction nodes.
Troubleshooting¶
- Error: 'Binder chain ID is required': Provide a non-empty binder_chain value that matches your ligand chain ID (e.g., 'B').
- Error: 'Unsupported property type': Ensure property_type is set to 'affinity'. No other values are supported.
- Predictions ignore property settings: Confirm the properties output is merged into the final YAML via a List/YAML Combiner before sending to the prediction node.
- Chain mismatch issues: Verify that the binder_chain matches the chain IDs defined in your sequence or template inputs.