RF Diffusion Symmetry Config¶
Builds a symmetry configuration for RFDiffusion-based protein generation. Validates and normalizes the symmetry type and bundles additional symmetry-related options into a single JSON object for downstream use. Empty symmetry is converted to no symmetry (None).
Usage¶
Use this node when you want to enforce symmetry during RF Diffusion protein generation. Connect its output to the symmetry_config input of the main RF Diffusion generation node within your workflow. Typical use: select a symmetry (e.g., c2, d5, tetrahedral), optionally adjust radius and toggles, then pass the resulting configuration to guide symmetric complex design.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| symmetry | True | STRING | Type of symmetry to sample. Accepts cyclic (cn, e.g., c2), dihedral (dn, e.g., d5), or one of 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. Minimum is 1. | 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 steps of the diffusion process (self-conditioning). | true |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| symmetry_config | JSON | A JSON configuration object containing the processed symmetry settings to be merged into RF Diffusion inference configuration. | {"symmetry": "c3", "recenter": true, "radius": 12, "model_only_neighbors": false, "symmetric_self_cond": true} |
Important Notes¶
- Symmetry formats: Only '', cn (e.g., c2), dn (e.g., d5), tetrahedral, octahedral, icosahedral are accepted.
- Empty symmetry: An empty string is converted to null, meaning no symmetry is applied.
- Validation: Invalid symmetry strings raise an error; ensure correct format and spelling.
- Radius constraint: Radius must be at least 1.
- Defaults: Defaults are recenter=true, radius=10, model_only_neighbors=false, symmetric_self_cond=true.
Troubleshooting¶
- Invalid symmetry error: Ensure the value is '', cn/dn (e.g., c2, d5), or tetrahedral/octahedral/icosahedral. Use lowercase; spaces are not allowed.
- No symmetry applied: If symmetry is left empty, it is intentionally set to null (no symmetry). Provide a valid symmetry string to enable.
- Unexpected geometry: Adjust 'radius' to change placement distance of subunits; larger values spread subunits further from the center.
- Performance concerns: If modeling full assemblies is slow, set 'model_only_neighbors' to true to focus on local interactions.
- Symmetry during diffusion: If results appear asymmetrical mid-process, ensure 'symmetric_self_cond' is true to enforce symmetry throughout sampling.