RF Diffusion Denoiser Config¶
Builds a denoiser configuration dictionary to control how noise is applied during RF Diffusion sampling. It lets you independently scale translation (Cα) and rotation (frame) noise at the initial and final diffusion steps and choose how noise scales across steps (constant or linear). The result is intended to be plugged into the RF Diffusion node to fine-tune denoising behavior.
Usage¶
Use this node when you need finer control over the denoising schedule in RF Diffusion. Configure the noise scales and schedules here, then connect its output to the 'denoiser_config' input of the RF Diffusion node. Typical workflows tune these parameters to stabilize sampling or encourage exploration by adjusting initial and final noise magnitudes.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| noise_scale_ca | True | FLOAT | Translation noise scale at the initial step (t=T) for Cα coordinates. Controls how much positional noise is injected at the start. | 1.0 |
| final_noise_scale_ca | True | FLOAT | Translation noise scale at the final step (t=1) for Cα coordinates. Controls residual positional noise near the end. | 1.0 |
| ca_noise_schedule_type | True | ['linear', 'constant'] | Interpolation schedule between initial and final Cα noise scales. 'constant' keeps noise fixed; 'linear' interpolates across steps. | constant |
| noise_scale_frame | True | FLOAT | Rotation noise scale at the initial step (t=T) for frame orientations. Controls how much rotational noise is injected at the start. | 1.0 |
| final_noise_scale_frame | True | FLOAT | Rotation noise scale at the final step (t=1) for frame orientations. Controls residual rotational noise near the end. | 1.0 |
| frame_noise_schedule_type | True | ['linear', 'constant'] | Interpolation schedule between initial and final frame (rotation) noise scales. 'constant' keeps noise fixed; 'linear' interpolates across steps. | constant |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| denoiser_config | JSON | A configuration dictionary with denoiser parameters to feed into RF Diffusion. | {'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.8, 'frame_noise_schedule_type': 'linear'} |
Important Notes¶
- Ranges: All scale values must be between 0.0 and 1.0.
- Schedules: 'constant' uses the same noise at all steps; 'linear' interpolates between initial and final values.
- Targeted usage: This node does not perform generation; it only prepares configuration for the RF Diffusion node.
- Selective application: The denoiser settings are used only if this node's output is connected to the RF Diffusion node's 'denoiser_config' input.
- Defaults: Defaults keep both translation and rotation noise at 1.0 with 'constant' schedules.
Troubleshooting¶
- Config seems ignored: Ensure the 'denoiser_config' output is connected to the RF Diffusion node. Unconnected configs have no effect.
- Validation errors: Confirm all float values are within [0.0, 1.0] and schedule types are one of ['linear', 'constant'].
- Unstable or noisy outputs: Reduce 'noise_scale_ca' and/or 'noise_scale_frame', or lower the final scales to taper noise more strongly near the end.
- Too deterministic or low diversity: Increase initial scales (noise_scale_ca/frame) or use 'linear' schedules with higher starting values.