stylegan3/docs/configs.md

Training configurations

This document provides guidelines for selecting appropriate training options for various scenarios, as well as an extensive list of recommended configurations.

Example

In the remainder of this document, we summarize each configuration as follows:

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN3‑T	18.47	12.29	4.3	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=8.2 --mirror=1

This corresponds to the following command line:

# Train StyleGAN3-T for AFHQv2 using 8 GPUs.
python train.py --outdir=~/training-runs --cfg=stylegan3-t --data=~/datasets/afhqv2-512x512.zip \
  --gpus=8 --batch=32 --gamma=8.2 --mirror=1

Explanation of the columns:

• Config: StyleGAN3-T (translation equiv.), StyleGAN3-R (translation and rotation equiv.), or StyleGAN2. Reflects the value of --cfg.
• s/kimg: Raw training speed, measured separately on Tesla V100 and A100 using our recommended Docker image. The number indicates how many seconds, on average, it takes to process 1000 images from the training set. The number tends to vary slightly over the course of training; typically by no more than ±20%.
• GPU mem: Maximum GPU memory usage observed during training, reported in gigabytes per GPU. The above example uses 8 GPUs, which means that the total GPU memory usage is around 34.4 GB.
• Options: Command line options for train.py, excluding --outdir and --data.

Total training time

In addition the raw s/kimg number, the training time also depends on the --kimg and --metric options. --kimg controls the total number of training iterations and is set to 25000 by default. This is long enough to reach convergence in typical cases, but in practice the results should already look quite reasonable around 5000 kimg. --metrics determines which quality metrics are computed periodically during training. The default is fid50k_full, which increases the training time slightly; typically by no more than 5%. The automatic computation can be disabled by specifying --metrics=none.

In the above example, the total training time on V100 is approximately 18.47 s/kimg * 25000 kimg * 1.05 ≈ 485,000 seconds ≈ 5 days and 14 hours. Disabling metric computation (--metrics=none) reduces this to approximately 5 days and 8 hours.

General guidelines

The most important hyperparameter that needs to be tuned on a per-dataset basis is the R₁ regularization weight, --gamma, that must be specified explicitly for train.py. As a rule of thumb, the value of --gamma scales quadratically with respect to the training set resolution: doubling the resolution (e.g., 256x256 → 512x512) means that --gamma should be multiplied by 4 (e.g., 2 → 8). The optimal value is usually the same for --cfg=stylegan3-t and --cfg=stylegan3-r, but considerably lower for --cfg=stylegan2.

In practice, we recommend selecting the value of --gamma as follows:

• Find the closest match for your specific case in this document (config, resolution, and GPU count).
• Try training with the same --gamma first.
• Then, try increasing the value by 2x and 4x, and also decreasing it by 2x and 4x.
• Pick the value that yields the lowest FID.

The results may also be improved by adjusting --mirror and --aug, depending on the training data. Specifying --mirror=1 augments the dataset with random x-flips, which effectively doubles the number of images. This is generally beneficial with datasets that are horizontally symmetric (e.g., FFHQ), but it can be harmful if the images contain noticeable asymmetric features (e.g., text or letters). Specifying --aug=noaug disables adaptive discriminator augmentation (ADA), which may improve the results slightly if the training set is large enough (at least 100k images when accounting for x-flips). With small datasets (less than 30k images), it is generally a good idea to leave the augmentations enabled.

It is possible to speed up the training by decreasing network capacity, i.e., --cbase=16384. This typically leads to lower quality results, but the difference is less pronounced with low-resolution datasets (e.g., 256x256).

Scaling to different number of GPUs

You can select the number of GPUs by changing the value of --gpu; this does not affect the convergence curves or training dynamics in any way. By default, the total batch size (--batch) is divided evenly among the GPUs, which means that decreasing the number of GPUs yields higher per-GPU memory usage. To avoid running out of memory, you can decrease the per-GPU batch size by specifying --batch-gpu, which performs the same computation in multiple passes using gradient accumulation.

By default, train.py exports network snapshots once every 200 kimg, i.e., the product of --snap=50 and --tick=4. When using few GPUs (e.g., 1–2), this means that it may take a very long time for the first snapshot to appear. We recommend increasing the snapshot frequency in such cases by specifying --snap=20, --snap=10, or --snap=5.

Note that the configurations listed in this document have been specifically tuned for 8 GPUs. The safest way to scale them to different GPU counts is to adjust --gpu, --batch-gpu, and --snap as described above, but it may be possible to reach faster convergence by adjusting some of the other hyperparameters as well. Note, however, that adjusting the total batch size (--batch) requires some experimentation; decreasing --batch usually necessitates increasing regularization (--gamma) and/or decreasing the learning rates (most importantly --dlr).

Transfer learning

Transfer learning makes it possible to reach very good results very quickly, especially when the training set is small and/or the images resemble the ones produced by a pre-trained model. To enable transfer learning, you can point --resume to one of the pre-trained models that we provide for StyleGAN3 and StyleGAN2. For example:

# Fine-tune StyleGAN3-R for MetFaces-U using 1 GPU, starting from the pre-trained FFHQ-U pickle.
python train.py --outdir=~/training-runs --cfg=stylegan3-r --data=~/datasets/metfacesu-1024x1024.zip \
    --gpus=8 --batch=32 --gamma=6.6 --mirror=1 --kimg=5000 --snap=5 \
    --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan3/versions/1/files/stylegan3-r-ffhqu-1024x1024.pkl

The pre-trained model should be selected to match the specified config, resolution, and architecture-related hyperparameters (e.g., --cbase, --map-depth, and --mbstd-group). You check this by looking at the fakes_init.png exported by train.py at the beginning; if the configuration is correct, the images should look reasonable.

With transfer learning, the results may be improved slightly by adjusting --freezed, in addition to the above guidelines for --gamma, --mirror, and --aug. In our experience, --freezed=10 and --freezed=13 tend to work reasonably well.

Recommended configurations

This section lists recommended settings for StyleGAN3-T and StyleGAN3-R for different resolutions and GPU counts, selected according to the above guidelines. These are intended to provide a good starting point when experimenting with a new dataset. Please note that many of the options (e.g., --gamma, --mirror, and --aug) are still worth adjusting on a case-by-case basis.

128x128 resolution

Config	GPUs	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN3‑T	1	73.68	27.20	7.2	--cfg=stylegan3-t --gpus=1 --batch=32 --gamma=0.5 --batch-gpu=16 --snap=10
StyleGAN3‑T	2	37.30	13.74	7.1	--cfg=stylegan3-t --gpus=2 --batch=32 --gamma=0.5 --snap=20
StyleGAN3‑T	4	20.66	7.52	4.1	--cfg=stylegan3-t --gpus=4 --batch=32 --gamma=0.5
StyleGAN3‑T	8	11.31	4.40	2.6	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=0.5
StyleGAN3‑R	1	58.44	34.23	8.3	--cfg=stylegan3-r --gpus=1 --batch=32 --gamma=0.5 --batch-gpu=16 --snap=10
StyleGAN3‑R	2	29.92	17.29	8.2	--cfg=stylegan3-r --gpus=2 --batch=32 --gamma=0.5 --snap=20
StyleGAN3‑R	4	15.49	9.53	4.5	--cfg=stylegan3-r --gpus=4 --batch=32 --gamma=0.5
StyleGAN3‑R	8	8.43	5.69	2.7	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=0.5

256x256 resolution

Config	GPUs	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN3‑T	1	89.15	49.81	9.5	--cfg=stylegan3-t --gpus=1 --batch=32 --gamma=2 --batch-gpu=16 --snap=10
StyleGAN3‑T	2	45.45	25.05	9.3	--cfg=stylegan3-t --gpus=2 --batch=32 --gamma=2 --snap=20
StyleGAN3‑T	4	23.94	13.26	5.2	--cfg=stylegan3-t --gpus=4 --batch=32 --gamma=2
StyleGAN3‑T	8	13.04	7.32	3.1	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=2
StyleGAN3‑R	1	87.37	56.73	6.7	--cfg=stylegan3-r --gpus=1 --batch=32 --gamma=2 --batch-gpu=8 --snap=10
StyleGAN3‑R	2	44.12	28.60	6.7	--cfg=stylegan3-r --gpus=2 --batch=32 --gamma=2 --batch-gpu=8 --snap=20
StyleGAN3‑R	4	22.42	14.39	6.6	--cfg=stylegan3-r --gpus=4 --batch=32 --gamma=2
StyleGAN3‑R	8	11.88	8.03	3.7	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=2

512x512 resolution

Config	GPUs	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN3‑T	1	137.33	90.25	7.8	--cfg=stylegan3-t --gpus=1 --batch=32 --gamma=8 --batch-gpu=8 --snap=10
StyleGAN3‑T	2	69.65	45.42	7.7	--cfg=stylegan3-t --gpus=2 --batch=32 --gamma=8 --batch-gpu=8 --snap=20
StyleGAN3‑T	4	34.88	22.81	7.6	--cfg=stylegan3-t --gpus=4 --batch=32 --gamma=8
StyleGAN3‑T	8	18.47	12.29	4.3	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=8
StyleGAN3‑R	1	158.91	110.13	6.0	--cfg=stylegan3-r --gpus=1 --batch=32 --gamma=8 --batch-gpu=4 --snap=10
StyleGAN3‑R	2	79.96	55.18	6.0	--cfg=stylegan3-r --gpus=2 --batch=32 --gamma=8 --batch-gpu=4 --snap=20
StyleGAN3‑R	4	40.86	27.99	5.9	--cfg=stylegan3-r --gpus=4 --batch=32 --gamma=8 --batch-gpu=4
StyleGAN3‑R	8	20.44	14.04	5.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=8

1024x1024 resolution

Config	GPUs	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN3‑T	1	221.85	156.91	7.0	--cfg=stylegan3-t --gpus=1 --batch=32 --gamma=32 --batch-gpu=4 --snap=5
StyleGAN3‑T	2	113.44	79.16	6.8	--cfg=stylegan3-t --gpus=2 --batch=32 --gamma=32 --batch-gpu=4 --snap=10
StyleGAN3‑T	4	57.04	39.62	6.7	--cfg=stylegan3-t --gpus=4 --batch=32 --gamma=32 --batch-gpu=4 --snap=20
StyleGAN3‑T	8	28.71	20.01	6.6	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=32
StyleGAN3‑R	1	263.44	184.81	10.2	--cfg=stylegan3-r --gpus=1 --batch=32 --gamma=32 --batch-gpu=4 --snap=5
StyleGAN3‑R	2	134.22	92.58	10.1	--cfg=stylegan3-r --gpus=2 --batch=32 --gamma=32 --batch-gpu=4 --snap=10
StyleGAN3‑R	4	67.33	46.53	10.0	--cfg=stylegan3-r --gpus=4 --batch=32 --gamma=32 --batch-gpu=4 --snap=20
StyleGAN3‑R	8	34.12	23.42	9.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=32

Configurations used in StyleGAN3 paper

This section lists the exact settings that we used in the "Alias-Free Generative Adversarial Networks" paper.

FFHQ-U and FFHQ at 1024x1024 resolution

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN2	17.55	14.57	6.2	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=10 --mirror=1 --aug=noaug
StyleGAN3‑T	28.71	20.01	6.6	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=32.8 --mirror=1 --aug=noaug
StyleGAN3‑R	34.12	23.42	9.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=32.8 --mirror=1 --aug=noaug

MetFaces-U at 1024x1024 resolution

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN2	18.74	11.80	7.4	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=10 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan2/versions/1/files/stylegan2-ffhqu-1024x1024.pkl
StyleGAN3‑T	29.84	21.06	7.7	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=16.4 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan3/versions/1/files/stylegan3-t-ffhqu-1024x1024.pkl
StyleGAN3‑R	35.10	24.32	10.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=6.6 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan3/versions/1/files/stylegan3-r-ffhqu-1024x1024.pkl

MetFaces at 1024x1024 resolution

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN2	18.74	11.80	7.4	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=5 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan2/versions/1/files/stylegan2-ffhq-1024x1024.pkl
StyleGAN3‑T	29.84	21.06	7.7	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=6.6 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan3/versions/1/files/stylegan3-t-ffhq-1024x1024.pkl
StyleGAN3‑R	35.10	24.32	10.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=3.3 --mirror=1 --kimg=5000 --snap=10 --resume=https://api.ngc.nvidia.com/v2/models/nvidia/research/stylegan3/versions/1/files/stylegan3-r-ffhq-1024x1024.pkl

AFHQv2 at 512x512 resolution

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN2	10.90	6.60	3.9	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=5 --mirror=1
StyleGAN3‑T	18.47	12.29	4.3	--cfg=stylegan3-t --gpus=8 --batch=32 --gamma=8.2 --mirror=1
StyleGAN3‑R	20.44	14.04	5.9	--cfg=stylegan3-r --gpus=8 --batch=32 --gamma=16.4 --mirror=1

FFHQ-U ablations at 256x256 resolution

Config	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
StyleGAN2	3.61	2.19	2.7	--cfg=stylegan2 --gpus=8 --batch=64 --gamma=1 --mirror=1 --aug=noaug --cbase=16384 --glr=0.0025 --dlr=0.0025 --mbstd-group=8
StyleGAN3‑T	7.40	3.74	3.5	--cfg=stylegan3-t --gpus=8 --batch=64 --gamma=1 --mirror=1 --aug=noaug --cbase=16384 --dlr=0.0025
StyleGAN3‑R	6.71	4.81	4.2	--cfg=stylegan3-r --gpus=8 --batch=64 --gamma=1 --mirror=1 --aug=noaug --cbase=16384 --dlr=0.0025

Old StyleGAN2-ADA configurations

This section lists command lines that can be used to match the configurations provided by our previous StyleGAN2-ADA codebase. The first table corresponds to --cfg=auto (default) for different resolutions and GPU counts, while the second table lists the remaining alternatives.

Default configuration

Res.	GPUs	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
128²	1	12.51	6.79	6.2	--cfg=stylegan2 --gpus=1 --batch=32 --gamma=0.1024 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
128²	2	6.43	3.45	6.2	--cfg=stylegan2 --gpus=2 --batch=64 --gamma=0.0512 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
128²	4	3.82	2.23	3.5	--cfg=stylegan2 --gpus=4 --batch=64 --gamma=0.0512 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
256²	1	20.84	12.53	4.5	--cfg=stylegan2 --gpus=1 --batch=16 --gamma=0.8192 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
256²	2	10.93	6.36	4.5	--cfg=stylegan2 --gpus=2 --batch=32 --gamma=0.4096 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
256²	4	5.39	3.20	4.5	--cfg=stylegan2 --gpus=4 --batch=64 --gamma=0.2048 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
256²	8	3.89	2.38	2.6	--cfg=stylegan2 --gpus=8 --batch=64 --gamma=0.2048 --map-depth=2 --glr=0.0025 --dlr=0.0025 --cbase=16384
512²	1	71.59	41.06	6.8	--cfg=stylegan2 --gpus=1 --batch=8 --gamma=6.5536 --map-depth=2 --glr=0.0025 --dlr=0.0025
512²	2	36.79	20.83	6.8	--cfg=stylegan2 --gpus=2 --batch=16 --gamma=3.2768 --map-depth=2 --glr=0.0025 --dlr=0.0025
512²	4	18.12	10.45	6.7	--cfg=stylegan2 --gpus=4 --batch=32 --gamma=1.6384 --map-depth=2 --glr=0.0025 --dlr=0.0025
512²	8	9.09	5.24	6.8	--cfg=stylegan2 --gpus=8 --batch=64 --gamma=0.8192 --map-depth=2 --glr=0.0025 --dlr=0.0025
1024²	1	141.83	90.39	7.2	--cfg=stylegan2 --gpus=1 --batch=4 --gamma=52.4288 --map-depth=2
1024²	2	73.13	46.04	7.2	--cfg=stylegan2 --gpus=2 --batch=8 --gamma=26.2144 --map-depth=2
1024²	4	36.95	23.15	7.0	--cfg=stylegan2 --gpus=4 --batch=16 --gamma=13.1072 --map-depth=2
1024²	8	18.47	11.66	7.3	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=6.5536 --map-depth=2

Repro configurations

Name	s/kimg (V100)	s/kimg (A100)	GPU mem	Options
stylegan2	17.55	14.57	6.2	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=10
paper256	4.01	2.47	2.7	--cfg=stylegan2 --gpus=8 --batch=64 --gamma=1 --cbase=16384 --glr=0.0025 --dlr=0.0025 --mbstd-group=8
paper512	9.11	5.28	6.7	--cfg=stylegan2 --gpus=8 --batch=64 --gamma=0.5 --glr=0.0025 --dlr=0.0025 --mbstd-group=8
paper1024	18.56	11.75	6.9	--cfg=stylegan2 --gpus=8 --batch=32 --gamma=2