swh:1:snp:94e75f89911aaffbba4968868a9b9c8f88629fa0
Tip revision: 5956813a465c36f5ac3ad9cbee39542fae93f3e2 authored by Peterou on 14 October 2023, 13:49:45 UTC
Update README.md
Update README.md
Tip revision: 5956813
curriculums.py
"""
To easily reproduce experiments, and avoid passing several command line arguments, we implemented
a curriculum utility. Parameters can be set in a curriculum dictionary.
Curriculum Schema:
Numerical keys in the curriculum specify an upsample step. When the current step matches the upsample step,
the values in the corresponding dict be updated in the curriculum. Common curriculum values specified at upsamples:
batch_size: Batch Size.
num_steps: Number of samples along ray.
img_size: Generated image resolution.
batch_split: Integer number over which to divide batches and aggregate sequentially. (Used due to memory constraints)
gen_lr: Generator learnig rate.
disc_lr: Discriminator learning rate.
fov: Camera field of view
ray_start: Near clipping for camera rays.
ray_end: Far clipping for camera rays.
fade_steps: Number of steps to fade in new layer on discriminator after upsample.
h_stddev: Stddev of camera yaw in radians.
v_stddev: Stddev of camera pitch in radians.
h_mean: Mean of camera yaw in radians.
v_mean: Mean of camera yaw in radians.
sample_dist: Type of camera pose distribution. (gaussian | spherical_uniform | uniform)
topk_interval: Interval over which to fade the top k ratio.
topk_v: Minimum fraction of a batch to keep during top k training.
betas: Beta parameters for Adam.
unique_lr: Whether to use reduced LRs for mapping network.
weight_decay: Weight decay parameter.
r1_lambda: R1 regularization parameter.
latent_dim: Latent dim for Siren network in generator.
grad_clip: Grad clipping parameter.
model: Siren architecture used in generator. (SPATIALSIRENBASELINE | TALLSIREN)
generator: Generator class. (ImplicitGenerator3d)
discriminator: Discriminator class. (ProgressiveEncoderDiscriminator | ProgressiveDiscriminator)
dataset: Training dataset. (CelebA | Carla | Cats)
clamp_mode: Clamping function for Siren density output. (relu | softplus)
z_dist: Latent vector distributiion. (gaussian | uniform)
hierarchical_sample: Flag to enable hierarchical_sampling from NeRF algorithm. (Doubles the number of sampled points)
z_labmda: Weight for experimental latent code positional consistency loss.
pos_lambda: Weight parameter for experimental positional consistency loss.
last_back: Flag to fill in background color with last sampled color on ray.
"""
import math
def next_upsample_step(curriculum, current_step):
# Return the epoch when it will next upsample
current_metadata = extract_metadata(curriculum, current_step)
current_size = current_metadata['img_size']
for curriculum_step in sorted([cs for cs in curriculum.keys() if type(cs) == int]):
if curriculum_step > current_step and curriculum[curriculum_step].get('img_size', 512) > current_size:
return curriculum_step
return float('Inf')
def last_upsample_step(curriculum, current_step):
# Returns the start epoch of the current stage, i.e. the epoch
# it last upsampled
current_metadata = extract_metadata(curriculum, current_step)
current_size = current_metadata['img_size']
for curriculum_step in sorted([cs for cs in curriculum.keys() if type(cs) == int]):
if curriculum_step <= current_step and curriculum[curriculum_step]['img_size'] == current_size:
return curriculum_step
return 0
def get_current_step(curriculum, epoch):
step = 0
for update_epoch in curriculum['update_epochs']:
if epoch >= update_epoch:
step += 1
return step
def extract_metadata(curriculum, current_step):
return_dict = {}
for curriculum_step in sorted([cs for cs in curriculum.keys() if type(cs) == int], reverse=True):
if curriculum_step <= current_step:
for key, value in curriculum[curriculum_step].items():
return_dict[key] = value
break
for key in [k for k in curriculum.keys() if type(k) != int]:
return_dict[key] = curriculum[key]
return return_dict
CelebA = {
0: {'batch_size': 28 * 2, 'num_steps': 12, 'img_size': 64, 'batch_split': 2, 'gen_lr': 6e-5, 'disc_lr': 2e-4},
int(200e3): {},
'dataset_path': '/home/ericryanchan/data/celeba/img_align_celeba/*.jpg',
'fov': 12,
'ray_start': 0.88,
'ray_end': 1.12,
'fade_steps': 10000,
'h_stddev': 0.3,
'v_stddev': 0.155,
'h_mean': math.pi*0.5,
'v_mean': math.pi*0.5,
'sample_dist': 'gaussian',
'topk_interval': 2000,
'topk_v': 0.6,
'betas': (0, 0.9),
'unique_lr': False,
'weight_decay': 0,
'r1_lambda': 0.2,
'latent_dim': 256,
'grad_clip': 10,
'model': 'SPATIALSIRENBASELINE',
'generator': 'ImplicitGenerator3d',
'discriminator': 'CCSEncoderDiscriminator',
'dataset': 'CelebA',
'clamp_mode': 'relu',
'z_dist': 'gaussian',
'hierarchical_sample': True,
'z_lambda': 0,
'pos_lambda': 15,
'last_back': False,
'eval_last_back': True,
}
CARLA = {
0: {'batch_size': 30, 'num_steps': 48, 'img_size': 32, 'batch_split': 1, 'gen_lr': 4e-5, 'disc_lr': 4e-4},
int(10e3): {'batch_size': 14, 'num_steps': 48, 'img_size': 64, 'batch_split': 2, 'gen_lr': 2e-5, 'disc_lr': 2e-4},
int(55e3): {'batch_size': 10, 'num_steps': 48, 'img_size': 128, 'batch_split': 5, 'gen_lr': 10e-6, 'disc_lr': 10e-5},
int(200e3): {},
'dataset_path': '/home/marcorm/S-GAN/data/cats_bigger_than_128x128/*.jpg',
'fov': 30,
'ray_start': 0.7,
'ray_end': 1.3,
'fade_steps': 10000,
'sample_dist': 'spherical_uniform',
'h_stddev': math.pi,
'v_stddev': math.pi/4 * 85/90,
'h_mean': math.pi*0.5,
'v_mean': math.pi/4 * 85/90,
'topk_interval': 1000,
'topk_v': 1,
'betas': (0, 0.9),
'unique_lr': False,
'weight_decay': 0,
'r1_lambda': 10,
'latent_dim': 256,
'grad_clip': 1,
'model': 'TALLSIREN',
'generator': 'ImplicitGenerator3d',
'discriminator': 'ProgressiveEncoderDiscriminator',
'dataset': 'Carla',
'white_back': True,
'clamp_mode': 'relu',
'z_dist': 'gaussian',
'hierarchical_sample': True,
'z_lambda': 0,
'pos_lambda': 0,
'learnable_dist': False,
}
CATS = {
0: {'batch_size': 28, 'num_steps': 24, 'img_size': 64, 'batch_split': 4, 'gen_lr': 6e-5, 'disc_lr': 2e-4},
int(200e3): {},
'dataset_path': '/home/ericryanchan/graf-beta/data/carla/carla/*.png',
'fov': 12,
'ray_start': 0.8,
'ray_end': 1.2,
'fade_steps': 10000,
'h_stddev': 0.5,
'v_stddev': 0.4,
'h_mean': math.pi*0.5,
'v_mean': math.pi*0.5,
'sample_dist': 'uniform',
'topk_interval': 2000,
'topk_v': 0.6,
'betas': (0, 0.9),
'unique_lr': False,
'weight_decay': 0,
'r1_lambda': 0.2,
'latent_dim': 256,
'grad_clip': 10,
'model': 'SPATIALSIRENBASELINE',
'generator': 'ImplicitGenerator3d',
'discriminator': 'StridedDiscriminator',
'dataset': 'Cats',
'clamp_mode': 'relu',
'z_dist': 'gaussian',
'hierarchical_sample': True,
'z_lambda': 0,
'pos_lambda': 0,
'last_back': False,
'eval_last_back': True,
}