[Draft] Generation Features Table

[iwr-redmond]

Hi @Teriks, my goodness you've been doing a land-office business recently! An entirely new implementation of PatchMatch? That's slick as a whistle!

I've started a features table that you may wish to review and add to the version_5.0.0 documentation:

---

Generation features by --model-type

Model Type	ADetailer	FreeU	Hi-Diffusion	DeepCache	Microsoft RAS	TeaCache
sd	✅	✅	✅	✅	❌	❌
pix2pix	❌	❌	❌	✅	❌	❌
sdxl	✅	✅	✅	✅	❌	❌
kolors	✅	✅	✅	✅	❌	❌
if	❌	❌	❌	❌	❌	❌
ifs	❌	❌	❌	❌	❌	❌
ifs-img2img	❌	❌	❌	❌	❌	❌
sdxl-pix2pix	❌	❌	❌	✅	❌	❌
upscaler-x2	❌	❌	❌	❌	❌	❌
upscaler-x4	❌	❌	❌	✅	❌	❌
s-cascade	❌	❌	❌	❌	❌	❌
sd3	✅	❌	❌	❌	✅	❌
flux	✅	❌	❌	❌	❌	✅
flux-fill	❌	❌	❌	❌	❌	✅

Generation Feature Notes

Hi-Diffusion requires the --hi_diffusion_no_raunet option when inpainting (reference).

FreeU parameters differ by model type and can be specified using the --freeu_params option. The recommended parameters for SD1.4, SD1.5, SD2.1, and SDXL can be reviewed here. Kolors is compatible with FreeU's SDXL settings.

Faster generation speeds can be achieved by using DeepCache, Microsoft RAS, or TeaCache, but may lead to reduced image quality. The default values for each of these features are conservative, providing some speed increases without major impacts on quality.

The DeepCache branch ID and interval can be specified with the --deep_cache_branch_id and --deep_cache_interval options. Benchmarks for different parameters can be reviewed here.

Microsoft Region-Adaptive Sampling (RAS) has numerous configurable options that can be reviewed here. Note that the --ras_index_fusion parameter is not compatible with SD3.5.

The TeaCache threshold can be specified with the --tea_cache_rel_l1_threshold parameter. Information about this parameter can be reviewed here.

[Teriks]

Thank you, these tables are fairly tedious to create, though I am not sure a better way to present this information.

Some of the argument names need correcting, that's all I see at a glance

mainly all underscores should be -

And these are plural:

--deep-cache-branch-ids
--deep-cache-intervals
--tea-cache-rel-l1-thresholds

You could fork and create an edit & pull request to: https://github.com/Teriks/dgenerate/blob/version_5.0.0/FEATURE_TABLE.rst

If you wish to, otherwise I will get around to adding!

I will probably investigate --hi-diffusion-no-raunet with inpainting, perhaps that can just auto enable when inpainting for convenience if hi diffusion does not do that internally

[iwr-redmond]

I will probably investigate --hi-diffusion-no-raunet with inpainting, perhaps that can just auto enable when inpainting for convenience if hi diffusion does not do that internally

The current code is here, so perhaps it is already done? The original implementation was manual, and I didn't think to check the code.

You could fork and create an edit & pull request to: https://github.com/Teriks/dgenerate/blob/version_5.0.0/FEATURE_TABLE.rst

Can do.

[Teriks]

looks like it takes it out of the auto pipelines map, though, I have some custom pipelines such a the Kolors pipelines where it probably will not detect correctly since they are not in there. So probably best to just disable on my side

[iwr-redmond]

Agreed

[iwr-redmond]

Forgot the plurals - oops! Never mind, glad to be able to contribute a bit.

[Teriks]

Documentation is definitely something I appreciate help on