RF Diffusion Symmetry Config¶
Builds a symmetry configuration for RF Diffusion runs. It validates and formats the symmetry selection (e.g., cyclic, dihedral, or polyhedral), and bundles key options like recentring, placement radius, neighbor-only modeling, and symmetric self-conditioning into a single config object.
Usage¶
Use this node when you want to enforce symmetry in protein design. Connect its output to the symmetry_config input of the RF Diffusion node. Choose the symmetry type (e.g., c3, d5, tetrahedral) and adjust options like recentring, radius, and whether to only model neighboring subunits.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| symmetry | True | STRING | Type of symmetry to sample. Accepted: cn (e.g., c2, c3), dn (e.g., d5), or tetrahedral, octahedral, icosahedral. Leave empty to disable symmetry. | c3 |
| recenter | True | BOOLEAN | If true, repositions the complex so its center aligns with the origin. | True |
| radius | True | INT | Distance from the symmetry center to where symmetric subunits are placed. | 12 |
| model_only_neighbors | True | BOOLEAN | If true, model only neighboring subunits of the asymmetric unit rather than the full assembly. | False |
| symmetric_self_cond | True | BOOLEAN | If true, enforces symmetry during intermediate diffusion steps (self-conditioning). | True |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| symmetry_config | RFDIFFUSION_SYMMETRY_CONFIG | Validated symmetry configuration to connect into the RF Diffusion node. | {'symmetry': 'c3', 'recenter': True, 'radius': 12, 'model_only_neighbors': False, 'symmetric_self_cond': True} |
Important Notes¶
- Symmetry must be either cn/dn format (e.g., c2, d5) or one of tetrahedral, octahedral, icosahedral. Any other value will raise an error.
- Leaving symmetry empty sets it to None, effectively disabling symmetry constraints.
- This node prepares configuration only; it does not perform generation. Connect its output to the symmetry_config input of the RF Diffusion node.
- Radius controls subunit placement relative to the symmetry center; ensure it is compatible with your intended assembly scale.
- model_only_neighbors reduces modeled scope to neighbors around the asymmetric unit; use when full assemblies are unnecessary.
Troubleshooting¶
- Invalid symmetry value: Ensure the value matches cn (e.g., c3), dn (e.g., d5), or tetrahedral/octahedral/icosahedral. Example fix: change 'c-3' to 'c3'.
- No symmetry applied unexpectedly: If symmetry is blank or only whitespace, it is treated as None (disabled). Enter a valid value like 'c2' to enable.
- Unexpected assembly size/placement: Adjust the radius input to better match the intended size and spacing of subunits.
- Generated config not affecting results: Confirm the symmetry_config output is connected to the RF Diffusion node and no downstream node overrides symmetry settings.