mmagic.models.editors.singan.singan_generator

Module Contents

Classes

SinGANMultiScaleGenerator

Multi-Scale Generator used in SinGAN.

class mmagic.models.editors.singan.singan_generator.SinGANMultiScaleGenerator(in_channels, out_channels, num_scales, kernel_size=3, padding=0, num_layers=5, base_channels=32, min_feat_channels=32, out_act_cfg=dict(type='Tanh'), init_cfg=None, **kwargs)

Bases: mmengine.model.BaseModule

Multi-Scale Generator used in SinGAN.

More details can be found in: Singan: Learning a Generative Model from a Single Natural Image, ICCV’19.

Notes:

• In this version, we adopt the interpolation function from the official PyTorch APIs, which is different from the original implementation by the authors. However, in our experiments, this influence can be ignored.

Parameters

• in_channels (int) – Input channels.

• out_channels (int) – Output channels.

• num_scales (int) – The number of scales/stages in generator. Note that this number is counted from zero, which is the same as the original paper.

• kernel_size (int, optional) – Kernel size, same as nn.Conv2d. Defaults to 3.

• padding (int, optional) – Padding for the convolutional layer, same as nn.Conv2d. Defaults to 0.

• num_layers (int, optional) – The number of convolutional layers in each generator block. Defaults to 5.

• base_channels (int, optional) – The basic channels for convolutional layers in the generator block. Defaults to 32.

• min_feat_channels (int, optional) – Minimum channels for the feature maps in the generator block. Defaults to 32.

• out_act_cfg (dict | None, optional) – Configs for output activation layer. Defaults to dict(type=’Tanh’).

• init_cfg (dict, optional) – Initialization config dict.

forward(input_sample, fixed_noises, noise_weights, rand_mode, curr_scale, num_batches=1, get_prev_res=False, return_noise=False)

Forward function.

Parameters

• input_sample (Tensor | None) – The input for generator. In the original implementation, a tensor filled with zeros is adopted. If None is given, we will construct it from the first fixed noises.

• fixed_noises (list[Tensor]) – List of the fixed noises in SinGAN.

• noise_weights (list[float]) – List of the weights for random noises.

• rand_mode (str) – Choices from [‘rand’, ‘recon’]. In rand mode, it will sample from random noises. Otherwise, the reconstruction for the single image will be returned.

• curr_scale (int) – The scale for the current inference or training.

• num_batches (int, optional) – The number of batches. Defaults to 1.

• get_prev_res (bool, optional) – Whether to return results from previous stages. Defaults to False.

• return_noise (bool, optional) – Whether to return noises tensor. Defaults to False.

Returns

Generated image tensor or dictionary containing more data.

Return type

Tensor | dict

check_and_load_prev_weight(curr_scale)