• Stars
    star
    537
  • Rank 82,649 (Top 2 %)
  • Language
    Python
  • License
    MIT License
  • Created over 4 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Rewriting a Deep Generative Model, ECCV 2020 (oral). Interactive tool to directly edit the rules of a GAN to synthesize scenes with objects added, removed, or altered. Change StyleGANv2 to make extravagant eyebrows, or horses wearing hats.

Rewriting a Deep Generative Model

In this paper, we ask if a deep network can be reprogrammed to follow different rules, by enabling a user to directly change the weights, instead of training with a data set.


Directly rewriting the weights of a StyleGANv2 to reprogram horses to have hats.

What is model rewriting?

We present the task of model rewriting, which aims to add, remove, and alter the semantic and physical rules of a pre-trained deep network. While modern image editing tools achieve a user-specified goal by manipulating individual input images, we enable a user to synthesize an unbounded number of new images by editing a generative model to carry out modified rules.

Why rewrite a model?

There are two reasons to want to rewrite a deep network directly:

  1. To gain insight about how a deep network organizes its knowledge.
  2. To enable creative users to quickly make novel models for which there is no existing data set.

Model rewriting envisions a way to construct deep networks according to a user's intentions. Rather than limiting networks to imitating data that we already have, rewriting allows deep networks to model a world that follows new rules that a user wishes to have.

Rewriting a Deep Generative Model.
David Bau, Steven Liu, Tongzhou Wang, Jun-Yan Zhu, Antonio Torralba.
ECCV 2020 (oral).
MIT CSAIL and Adobe Research.


2 minute
Video Preview

ECCV 2020
Preprint

ECCV 2020
Talk Video

Presentation
Slides

Website

Demo Colab
Notebook

Our method rewrites the weights of a generator to change generative rules. Instead of editing individual images, our method edits the generator, so an infinite set of images can be potentially synthesized and manipulated using the altered rules. Rules can be changed in various ways, such as removing patterns like watermarks, adding objects such as people, or replacing definitions such as making trees grow out of towers.

Our method is based on the hypothesis that the weights of a generator act as linear associative memory. A layer stores a map between keys, which denote meaningful context, and values, which determine output.

Example Results

The results below show changes of a single rule within StyleGANv2. In each case, four examples chosen by the user (center of the top row) establish the context for the rule begin rewritten, and the "copy and paste" examples (left and right of top row) indicate how the user wishes to change the model.

The grid below shows pairs of outputs: for each pair, the first is the output of the original unmodified StyleGANv2. The second is the output of the modified StyleGANv2, applying the user's intention using our method.


First: changing the rule defining kids' eyebrows to make them look like a bushy mustache.


Altering the rule for pointy tower tops to make them into trees.


Changing the rule for tops of horses heads, to put hats on horses.


Changing frowns into smiles.


Removing the main window in a building by changing the rule to draw a blank wall.

Tips

The code runs using PyTorch.

  • The method and interface can be found in /rewrite
  • Notebooks are in /notebooks: see rewriting-interface.ipynb for the demonstration UI.
  • Quantitative experiments in /metrics, dissection utilities in /utils. Experiments from section 5.1 can be repoduced by /experiments.sh, and section 5.2 can be reproduced by /watermarks.sh. The experiment in section 5.3 runs in ithe notebook /notebooks/reflection-rule-change.ipynb.

Setup

It's designed to use a recent version of PyTorch (1.4+) on python (3.6), using cuda 10.1 and cudnn 7.6.0. Run setup/setup_renv.sh to create a conda environment that has the needed dependencies.

Rewriting your own models

To edit your own models, do the following:

# Resolution (size) and style dimensionality (style_dim and n_mlp) are
# the architecture dimensions as you trained them.  The truncation trick can be
# applied here if desired (truncation=1.0 if not).
# Note that mconv='seq' splits apart the optimized modulated convolution into
# separate operations that the rewriter can examine the underlying
# convolution directly.
model = SeqStyleGAN2(size=256, style_dim=512, n_mlp=8, truncation=0.5, mconv='seq')

# load the exponential moving average model weights, put it on the GPU.
state_dict = torch.load('your_model.pt')
model.load_state_dict(state_dict['g_ema'], latent_avg=state_dict['latent_avg'])
model.cuda()
  • Create a ganrewrite.SeqStyleGanRewriter instance to edit your model
layernum = 8 # or which ever layer you wish to modify
sample_size = 1000 # a small sample of images for computing statistics
zds = zdataset.z_dataset_for_model(model, size=sample_size)
gw = SeqStyleGanRewriter(
    model, zds, layernum,
    cachedir='experiments')
  • Finally, to specify and create changes, you can use the rewriteapp.GanRewriteApp interface (assumes you are running in a notebook. This interface can be used to try edits and save and load json files with stored model edit specifications.
savedir = 'masks'
interface = rewriteapp.GanRewriteApp(gw, size=256, mask_dir=savedir, num_canvases=32)
  • To bulk-generate images from an edited model (notebook UI not needed), you can do the following, then sample the output of the modified model as usual. See metrics/sample_edited.py for an example.
saved_edit = 'masks/my_edit.json'
gw.apply_edit(json.load(saved_edit), rank=1)

More Repositories

1

seedrandom

seeded random number generator for Javascript
JavaScript
1,955
star
2

how-to-read-pytorch

Quick, visual, principled introduction to pytorch code through five colab notebooks.
Jupyter Notebook
316
star
3

dissect

Code for the Proceedings of the National Academy of Sciences 2020 article, "Understanding the Role of Individual Units in a Deep Neural Network"
Python
300
star
4

ganseeing

Seeing what a GAN cannot generate. Visualizes and quantifies object classes within scenes that are outside the range of a GAN.
Python
182
star
5

baukit

Python
37
star
6

covid-19-chart

Chart of current COVID-19 time series data. Enables a variety of county- state- and nation-level comparisons and data exploration.
HTML
18
star
7

see

see.js interactive eval panel that allows debugging of nested javascript scope.
JavaScript
16
star
8

sidn-handbook

The Structure and Interpretation of Deep Networks Handbook
Jupyter Notebook
12
star
9

xsrand

Several fast 32-bit xor-shift random number generators implemented in Javascript.
JavaScript
12
star
10

conformal

An interactive HTML conformal map viewer.
HTML
7
star
11

gpwidget

Jupyter Notebook
7
star
12

envs

Conda environments for pytorch-oriented deep learning work.
Shell
5
star
13

quick-netdissect

Lightweight reimplementation of netdissect for pytorch (under development)
Python
4
star
14

webcrush

A utility for minifying and LZW compressing an HTML file.
JavaScript
4
star
15

colabsecrets

A repo for keeping track of colab tricks.
Python
4
star
16

splaylist

Splay tree in Javascript, with fast indexing and order statistics. Better than a linked list.
JavaScript
4
star
17

make-full-linux-history

Yoann Padioleau's scripts to graft together a nearly complete history of linux commits as a git repo.
OCaml
3
star
18

miniplaces

baseline setup for alexnet on miniplaces using pytorch
Python
2
star
19

mandelbrot

Updated code for http://davidbau.com/mandelbrot/, an early HTML5 demo of the canvas element. See http://davidbau.com/archives/2009/09/27/mandelbrot.html
HTML
2
star
20

ganclass

Python
1
star
21

heidisudoku

JavaScript
1
star
22

panoptic-segmentation

Python
1
star
23

thisxsite

"This X does not exist" website
Python
1
star
24

pytorch-setup

Just to share a conda setup that I use
Shell
1
star
25

glowjs

A package containing the glowscript javascript libaries as a single javascript file.
JavaScript
1
star
26

sudokui

A simplified sudoku UI for experimenting with A/B testing: MIT 6.831
JavaScript
1
star
27

net-intent

Simple experiment to explore a jacobian method for determining hidden unit intent.
Python
1
star