RF Diffusion Denoiser Config¶
Builds a denoiser configuration for RF Diffusion runs. It controls how much noise is applied to translations (C-alpha) and rotations (frame) at the start and end of the denoising process, and how those values change over the denoising schedule.
Usage¶
Use this node when you want explicit control over the denoising behavior in RF Diffusion. Configure the translation and rotation noise scales and choose a schedule type (constant or linear), then connect its output to the denoiser_config input of the RF Diffusion node. If you do not need custom denoiser behavior, you can skip this node and RF Diffusion will use its defaults.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| noise_scale_ca | True | FLOAT | Initial-step (t=T) translation noise scale applied to C-alpha coordinates. | 1.0 |
| final_noise_scale_ca | True | FLOAT | Final-step (t=1) translation noise scale applied to C-alpha coordinates. | 1.0 |
| ca_noise_schedule_type | True | ['linear', 'constant'] | Schedule for interpolating translation noise between initial and final values. | constant |
| noise_scale_frame | True | FLOAT | Initial-step (t=T) rotation noise scale (frame noise). | 1.0 |
| final_noise_scale_frame | True | FLOAT | Final-step (t=1) rotation noise scale (frame noise). | 1.0 |
| frame_noise_schedule_type | True | ['linear', 'constant'] | Schedule for interpolating rotation noise between initial and final values. | constant |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| denoiser_config | JSON | Configuration dictionary for RF Diffusion denoiser containing the specified noise scales and schedules. | {'noise_scale_ca': 1.0, 'final_noise_scale_ca': 0.8, 'ca_noise_schedule_type': 'linear', 'noise_scale_frame': 1.0, 'final_noise_scale_frame': 0.7, 'frame_noise_schedule_type': 'linear'} |
Important Notes¶
- Noise scale bounds: All noise scales are constrained between 0.0 and 1.0.
- Schedules: 'constant' uses the same value throughout; 'linear' interpolates from the initial value to the final value over the denoising steps.
- Pass-through behavior: The node validates via UI constraints and returns the values as provided; no additional transformation is applied.
- Integration: Connect the output to the 'denoiser_config' input of the RF Diffusion node to take effect; otherwise defaults are used.
- Translation vs rotation: 'ca' parameters affect coordinate translations, while 'frame' parameters affect rotations.
Troubleshooting¶
- Unexpectedly weak or strong denoising: Reduce or increase the final_noise_scale_* values. For a smoother transition, choose 'linear' instead of 'constant'.
- No effect on results: Ensure this node's output is connected to the RF Diffusion node's 'denoiser_config' input and that the RF Diffusion run uses that configuration.
- Validation errors when setting values: Keep noise scales within [0.0, 1.0] and select one of the allowed schedule types ('constant' or 'linear').