Skip to main content

diffusionjax is a simple and accessible diffusion models package in JAX

Project description

diffusionjax

CI Coverage Status

diffusionjax is a simple, accessible introduction to diffusion models, also known as score-based generative models (SGMs). It is implemented in Python via the autodiff framework, JAX. In particular, diffusionjax uses the Flax library for the neural network approximator of the score. diffusionjax focusses on the continuous time formulation during training.

The development of diffusionjax has been supported by The Alan Turing Institute through the Theory and Methods Challenge Fortnights event "Accelerating generative models and nonconvex optimisation", which took place on 6-10 June 2022 and 5-9 Sep 2022 at The Alan Turing Institute headquarters.

nPlan

Thank you to nPlan, who are supporting this project.

Contents:

Installation

The package requires Python 3.8+. First, it is recommended to create a new python virtual environment. diffusionjax depends on JAX. Because the JAX installation is different depending on your CUDA version, diffusionjax does not list JAX as a dependency in setup.py. First, follow these instructions to install JAX with the relevant accelerator support. To run the examples, you may optionally need to install optax, orbax-checkpoint, torch[cpu] and mlkernels, which the package depends on only through the examples given. Then, pip install diffusionjax or for developers,

  • Clone the repository git clone git@github.com:bb515/diffusionjax.git
  • Install using pip pip install -e . from the root directory of the repository (see the setup.py for the requirements that this command installs).

Examples

Introduction to diffusion models

Run the example by typing

python examples/example.py:
  --config: Training configuration.
    (default: './configs/example.py')
  --workdir: Working directory
    (default: './examples/')

on the command line from the root directory of the repository.

  • config is the path to the config file. The default config files are provided in configs/. They are formatted according to ml_collections.
  • workdir is the path that stores all artifacts of one experiment, like checkpoints, samples, and evaluation results via wandb.

The example is based off the Jupyter notebook by Jakiw Pidstrigach, a tutorial on the theoretical and implementation aspects of diffusion models.

>>> num_epochs = 4000
>>> num_samples = 8
>>> samples = sample_circle(num_samples)
>>> N = samples.shape[1]
>>> plot_scatter(samples=samples, index=(0, 1), fname="samples", lims=((-3, 3), (-3, 3)))
>>> rng = random.PRNGKey(2023)

Prediction

>>> # Get variance preserving (VP) a.k.a. time-changed Ohrnstein Uhlenbeck (OU) sde model
>>> sde = VP()
>>>
>>> def log_hat_pt(x, t):
>>>     """
>>>     Empirical distribution score.
>>>
>>>     Args:
>>>     x: One location in $\mathbb{R}^2$
>>>     t: time
>>>     Returns:
>>>     The empirical log density, as described in the Jupyter notebook
>>>     .. math::
>>>         \hat{p}_{t}(x)
>>>     """
>>>     mean, std = sde.marginal_prob(samples, t)
>>>     potentials = jnp.sum(-(x - mean)**2 / (2 * std**2), axis=1)
>>>     return logsumexp(potentials, axis=0, b=1/num_samples)
>>>
>>> # Get a jax grad function, which can be batched with vmap
>>> nabla_log_hat_pt = jit(vmap(grad(log_hat_pt), in_axes=(0, 0), out_axes=(0)))
>>>
>>> # Running the reverse SDE with the empirical drift
>>> plot_score(score=nabla_log_hat_pt, t=0.01, area_min=-3, area_max=3, fname="empirical score")

Prediction

>>> sampler = get_sampler((5760, N), EulerMaruyama(sde.reverse(nabla_log_hat_pt)))
>>> rng, *sample_rng = random.split(rng, 2)
>>> q_samples = sampler(jnp.array(sample_rng))
>>> q_samples = q_samples.reshape(5760, N)
>>> plot_heatmap(samples=q_samples, area_min=-3, area_max=3, fname="heatmap empirical score")

Prediction

>>> # What happens when I perturb the score with a constant?
>>> perturbed_score = lambda x, t: nabla_log_hat_pt(x, t) + 1
>>> sampler = get_sampler((5760, N), EulerMaruyama(sde.reverse(perturbed_score)))
>>> rng, *sample_rng = random.split(rng, 2)
>>> q_samples = sampler(jnp.array(sample_rng))
>>> q_samples = q_samples.reshape(5760, N)
>>> plot_heatmap(samples=q_samples, area_min=-3, area_max=3, fname="heatmap bounded perturbation")

Prediction

>>> # Neural network training via score matching
>>> batch_size=16
>>> score_model = MLP()
>>> # Initialize parameters
>>> params = score_model.init(step_rng, jnp.zeros((batch_size, N)), jnp.ones((batch_size,)))
>>> # Initialize optimizer
>>> opt_state = optimizer.init(params)
>>> # Get loss function
>>> solver = EulerMaruyama(sde)
>>> loss = get_loss(
>>>     sde, solver, score_model, score_scaling=True, likelihood_weighting=False)
>>> # Train with score matching
>>> score_model, params, opt_state, mean_losses = retrain_nn(
>>>     update_step=update_step,
>>>     num_epochs=num_epochs,
>>>     step_rng=step_rng,
>>>     samples=samples,
>>>     score_model=score_model,
>>>     params=params,
>>>     opt_state=opt_state,
>>>     loss=loss,
>>>     batch_size=batch_size)
>>> # Get trained score
>>> trained_score = get_score(sde, score_model, params, score_scaling=True)
>>> plot_score(score=trained_score, t=0.01, area_min=-3, area_max=3, fname="trained score")

Prediction

>>> solver = EulerMaruyama(sde.reverse(trained_score))
>>> sampler = get_sampler((720, N), solver, stack_samples=False)
>>> rng, *sample_rng = random.split(rng, 2)
>>> q_samples = sampler(jnp.array(sample_rng))
>>> q_samples = q_samples.reshape(720, N)
>>> plot_heatmap(samples=q_samples, area_min=-3, area_max=3, fname="heatmap trained score")

Prediction

>>>  # Condition on one of the coordinates
>>>  y = jnp.array([-0.5, 0.0])
>>>  mask = jnp.array([1., 0.])
>>>  # Get inpainter
>>>  sampler = get_sampler(sampling_shape,
                           solver,
                           Inpainted(sde.reverse(trained_score), mask, y),
                           inverse_scaler=inverse_scaler,
                           stack_samples=False,
                           denoise=True)
>>>  q_samples, _ = sampler(sample_rng)
>>>  q_samples = q_samples.reshape(sampling_shape)
>>>  plot_heatmap(samples=q_samples, area_bounds=[-3., 3.], fname="heatmap inpainted")

Prediction

Does haves

  • Training scores on (possibly, image) data and sampling from the generative model. Also inverse problems, such as inpainting.
  • jit multiple training steps together to improve training speed at the cost of more memory usage. This can be set via config.training.n_jitted_steps.
  • Not many lines of code.
  • Bayesian inversion (inverse problems) with linear observation maps.
  • Easy to use, extendable. Get started with the example, provided.

Doesn't haves

  • Geometry other than Euclidean space, such as Riemannian manifolds.
  • Diffusion in a latent space.
  • Augmented with critically-damped Langevin diffusion.

References

This is the implementation for the paper Tweedie Moment Projected Diffusions for Inverse Problems by Benjamin Boys, Mark Girolami, Jakiw Pidstrigach, Sebastian Reich, Alan Mosca and O. Deniz Akyildiz.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

diffusionjax-0.1.7.tar.gz (206.3 kB view details)

Uploaded Source

File details

Details for the file diffusionjax-0.1.7.tar.gz.

File metadata

  • Download URL: diffusionjax-0.1.7.tar.gz
  • Upload date:
  • Size: 206.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.1

File hashes

Hashes for diffusionjax-0.1.7.tar.gz
Algorithm Hash digest
SHA256 ccf99197fcada9371ebda66eb11d1b0b3a844fdaf28a3a466ac46f7e62b08b9c
MD5 e2318d3e87feaf464c7e0909b0d4c210
BLAKE2b-256 7949803ad0d6c7d73dea359695c5b0602396f09e41b98fbc808a3be63914af37

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page