The Cycle Generative Adversarial Network, or CycleGAN, is an approach to training a deep convolutional neural network for image-to-image translation tasks.
Unlike other GAN models for image translation, the CycleGAN does not require a dataset of paired images.
For example, if we are interested in translating photographs of oranges to apples, we do not require a training dataset of oranges that have been manually converted to apples.
This allows the development of a translation model on problems where training datasets may not exist, such as translating paintings to photographs.
In this tutorial, you will discover how to develop a CycleGAN model to translate photos of horses to zebras, and back again.
After completing this tutorial, you will know:Discover how to develop DCGANs, conditional GANs, Pix2Pix, CycleGANs, and more with Keras in my new GANs book, with 29 step-by-step tutorials and full source code.
Let’s get started.
How to Develop a CycleGAN for Image-to-Image Translation with KerasPhoto by A.
Munar, some rights reserved.
This tutorial is divided into four parts; they are:The CycleGAN model was described by Jun-Yan Zhu, et al.
in their 2017 paper titled “Unpaired Image-to-Image Translation using Cycle-Consistent Adversarial Networks.
”The benefit of the CycleGAN model is that it can be trained without paired examples.
That is, it does not require examples of photographs before and after the translation in order to train the model, e.
g.
photos of the same city landscape during the day and at night.
Instead, the model is able to use a collection of photographs from each domain and extract and harness the underlying style of images in the collection in order to perform the translation.
The model architecture is comprised of two generator models: one generator (Generator-A) for generating images for the first domain (Domain-A) and the second generator (Generator-B) for generating images for the second domain (Domain-B).
The generator models perform image translation, meaning that the image generation process is conditional on an input image, specifically an image from the other domain.
Generator-A takes an image from Domain-B as input and Generator-B takes an image from Domain-A as input.
Each generator has a corresponding discriminator model.
The first discriminator model (Discriminator-A) takes real images from Domain-A and generated images from Generator-A and predicts whether they are real or fake.
The second discriminator model (Discriminator-B) takes real images from Domain-B and generated images from Generator-B and predicts whether they are real or fake.
The discriminator and generator models are trained in an adversarial zero-sum process, like normal GAN models.
The generators learn to better fool the discriminators and the discriminator learn to better detect fake images.
Together, the models find an equilibrium during the training process.
Additionally, the generator models are regularized to not just create new images in the target domain, but instead translate more reconstructed versions of the input images from the source domain.
This is achieved by using generated images as input to the corresponding generator model and comparing the output image to the original images.
Passing an image through both generators is called a cycle.
Together, each pair of generator models are trained to better reproduce the original source image, referred to as cycle consistency.
There is one further element to the architecture, referred to as the identity mapping.
This is where a generator is provided with images as input from the target domain and is expected to generate the same image without change.
This addition to the architecture is optional, although results in a better matching of the color profile of the input image.
Now that we are familiar with the model architecture, we can take a closer look at each model in turn and how they can be implemented.
The paper provides a good description of the models and training process, although the official Torch implementation was used as the definitive description for each model and training process and provides the basis for the the model implementations described below.
Take my free 7-day email crash course now (with sample code).
Click to sign-up and also get a free PDF Ebook version of the course.
Download Your FREE Mini-CourseOne of the impressive examples of the CycleGAN in the paper was to transform photographs of horses to zebras, and the reverse, zebras to horses.
The authors of the paper referred to this as the problem of “object transfiguration” and it was also demonstrated on photographs of apples and oranges.
In this tutorial, we will develop a CycleGAN from scratch for image-to-image translation (or object transfiguration) from horses to zebras and the reverse.
We will refer to this dataset as “horses2zebra“.
The zip file for this dataset about 111 megabytes and can be downloaded from the CycleGAN webpage:Download the dataset into your current working directory.
You will see the following directory structure:The “A” category refers to horse and “B” category refers to zebra, and the dataset is comprised of train and test elements.
We will load all photographs and use them as a training dataset.
The photographs are square with the shape 256×256 and have filenames like “n02381460_2.
jpg“.
The example below will load all photographs from the train and test folders and create an array of images for category A and another for category B.
Both arrays are then saved to a new file in compressed NumPy array format.
Running the example first loads all images into memory, showing that there are 1,187 photos in category A (horses) and 1,474 in category B (zebras).
The arrays are then saved in compressed NumPy format with the filename “horse2zebra_256.
npz“.
Note: this data file is about 570 megabytes, larger than the raw images as we are storing pixel values as 32-bit floating point values.
We can then load the dataset and plot some of the photos to confirm that we are handling the image data correctly.
The complete example is listed below.
Running the example first loads the dataset, confirming the number of examples and shape of the color images match our expectations.
A plot is created showing a row of three images from the horse photo dataset (dataA) and a row of three images from the zebra dataset (dataB).
Plot of Photographs from the Horses2Zeba DatasetNow that we have prepared the dataset for modeling, we can develop the CycleGAN generator models that can translate photos from one category to the other, and the reverse.
In this section, we will develop the CycleGAN model for translating photos of horses to zebras and photos of zebras to horsesThe same model architecture and configuration described in the paper was used across a range of image-to-image translation tasks.
This architecture is both described in the body paper, with additional detail in the appendix of the paper, and a fully working implementation provided as open source implemented for the Torch deep learning framework.
The implementation in this section will use the Keras deep learning framework based directly on the model described in the paper and implemented in the author’s codebase, designed to take and generate color images with the size 256×256 pixels.
The architecture is comprised of four models, two discriminator models, and two generator models.
The discriminator is a deep convolutional neural network that performs image classification.
It takes a source image as input and predicts the likelihood of whether the target image is a real or fake image.
Two discriminator models are used, one for Domain-A (horses) and one for Domain-B (zebras).
The discriminator design is based on the effective receptive field of the model, which defines the relationship between one output of the model to the number of pixels in the input image.
This is called a PatchGAN model and is carefully designed so that each output prediction of the model maps to a 70×70 square or patch of the input image.
The benefit of this approach is that the same model can be applied to input images of different sizes, e.
g.
larger or smaller than 256×256 pixels.
The output of the model depends on the size of the input image but may be one value or a square activation map of values.
Each value is a probability for the likelihood that a patch in the input image is real.
These values can be averaged to give an overall likelihood or classification score if needed.
A pattern of Convolutional-BatchNorm-LeakyReLU layers is used in the model, which is common to deep convolutional discriminator models.
Unlike other models, the CycleGAN discriminator uses InstanceNormalization instead of BatchNormalization.
It is a very simple type of normalization and involves standardizing (e.
g.
scaling to a standard Gaussian) the values on each output feature map, rather than across features in a batch.
An implementation of instance normalization is provided in the keras-contrib project that provides early access to community supplied Keras features.
The keras-contrib library can be installed via pip as follows:Or, if you are using an Anaconda virtual environment, such as on EC2:The new InstanceNormalization layer can then be used as follows:The “axis” argument is set to -1 to ensure that features are normalized per feature map.
The define_discriminator() function below implements the 70×70 PatchGAN discriminator model as per the design of the model in the paper.
The model takes a 256×256 sized image as input and outputs a patch of predictions.
The model is optimized using least squares loss (L2) implemented as mean squared error, and a weighting it used so that updates to the model have half (0.
5) the usual effect.
The authors of CycleGAN paper recommend this weighting of model updates to slow down changes to the discriminator, relative to the generator model during training.
The generator model is more complex than the discriminator model.
The generator is an encoder-decoder model architecture.
The model takes a source image (e.
g.
horse photo) and generates a target image (e.
g.
zebra photo).
It does this by first downsampling or encoding the input image down to a bottleneck layer, then interpreting the encoding with a number of ResNet layers that use skip connections, followed by a series of layers that upsample or decode the representation to the size of the output image.
First, we need a function to define the ResNet blocks.
These are blocks comprised of two 3×3 CNN layers where the input to the block is concatenated to the output of the block, channel-wise.
This is implemented in the resnet_block() function that creates two Convolution-InstanceNorm blocks with 3×3 filters and 1×1 stride and without a ReLU activation after the second block, matching the official Torch implementation in the build_conv_block() function.
Same padding is used instead of reflection padded recommended in the paper for simplicity.
Next, we can define a function that will create the 9-resnet block version for 256×256 input images.
This can easily be changed to the 6-resnet block version by setting image_shape to (128x128x3) and n_resnet function argument to 6.
Importantly, the model outputs pixel values with the shape as the input and pixel values are in the range [-1, 1], typical for GAN generator models.
The discriminator models are trained directly on real and generated images, whereas the generator models are not.
Instead, the generator models are trained via their related discriminator models.
Specifically, they are updated to minimize the loss predicted by the discriminator for generated images marked as “real“, called adversarial loss.
As such, they are encouraged to generate images that better fit into the target domain.
The generator models are also updated based on how effective they are at the regeneration of a source image when used with the other generator model, called cycle loss.
Finally, a generator model is expected to output an image without translation when provided an example from the target domain, called identity loss.
Altogether, each generator model is optimized via the combination of four outputs with four loss functions:This can be achieved by defining a composite model used to train each generator model that is responsible for only updating the weights of that generator model, although it is required to share the weights with the related discriminator model and the other generator model.
This is implemented in the define_composite_model() function below that takes a defined generator model (g_model_1) as well as the defined discriminator model for the generator models output (d_model) and the other generator model (g_model_2).
The weights of the other models are marked as not trainable as we are only interested in updating the first generator model, i.
e.
the focus of this composite model.
The discriminator is connected to the output of the generator in order to classify generated images as real or fake.
A second input for the composite model is defined as an image from the target domain (instead of the source domain), which the generator is expected to output without translation for the identity mapping.
Next, forward cycle loss involves connecting the output of the generator to the other generator, which will reconstruct the source image.
Finally, the backward cycle loss involves the image from the target domain used for the identity mapping that is also passed through the other generator whose output is connected to our main generator as input and outputs a reconstructed version of that image from the target domain.
To summarize, a composite model has two inputs for the real photos from Domain-A and Domain-B, and four outputs for the discriminator output, identity generated image, forward cycle generated image, and backward cycle generated image.
Only the weights of the first or main generator model are updated for the composite model and this is done via the weighted sum of all loss functions.
The cycle loss is given more weight (10-times) than the adversarial loss as described in the paper, and the identity loss is always used with a weighting half that of the cycle loss (5-times), matching the official implementation source code.
We need to create a composite model for each generator model, e.
g.
the Generator-A (BtoA) for zebra to horse translation, and the Generator-B (AtoB) for horse to zebra translation.
All of this forward and backward across two domains gets confusing.
Below is a complete listing of all of the inputs and outputs for each of the composite models.
Identity and cycle loss are calculated as the L1 distance between the input and output image for each sequence of translations.
Adversarial loss is calculated as the L2 distance between the model output and the target values of 1.
0 for real and 0.
0 for fake.
Generator-A Composite Model (BtoA or Zebra to Horse)The inputs, transformations, and outputs of the model are as follows:We can summarize the inputs and outputs as:Generator-B Composite Model (AtoB or Horse to Zebra)The inputs, transformations, and outputs of the model are as follows:We can summarize the inputs and outputs as:Defining the models is the hard part of the CycleGAN; the rest is standard GAN training and relatively straightforward.
Next, we can load our paired images dataset in compressed NumPy array format.
This will return a list of two NumPy arrays: the first for source images and the second for corresponding target images.
Each training iteration we will require a sample of real images from each domain as input to the discriminator and composite generator models.
This can be achieved by selecting a random batch of samples.
The generate_real_samples() function below implements this, taking a NumPy array for a domain as input and returning the requested number of randomly selected images, as well as the target for the PatchGAN discriminator model indicating the images are real (target=1.
0).
As such, the shape of the PatchgAN output is also provided, which in the case of 256×256 images will be 16, or a 16x16x1 activation map, defined by the patch_shape function argument.
Similarly, a sample of generated images is required to update each discriminator model in each training iteration.
The generate_fake_samples() function below generates this sample given a generator model and the sample of real images from the source domain.
Again, target values for each generated image are provided with the correct shape of the PatchGAN, indicating that they are fake or generated (target=0.
0).
Typically, GAN models do not converge; instead, an equilibrium is found between the generator and discriminator models.
As such, we cannot easily judge whether training should stop.
Therefore, we can save the model and use it to generate sample image-to-image translations periodically during training, such as every one or five training epochs.
We can then review the generated images at the end of training and use the image quality to choose a final model.
The save_models() function below will save each generator model to the current directory in H5 format, including the training iteration number in the filename.
This will require that the h5py library is installed.
The summarize_performance() function below uses a given generator model to generate translated versions of a few randomly selected source photographs and saves the plot to file.
The source images are plotted on the first row and the generated images are plotted on the second row.
Again, the plot filename includes the training iteration number.
We are nearly ready to define the training of the models.
The discriminator models are updated directly on real and generated images, although in an effort to further manage how quickly the discriminator models learn, a pool of fake images is maintained.
The paper defines an image pool of 50 generated images for each discriminator model that is first populated and probabilistically either adds new images to the pool by replacing an existing image or uses a generated image directly.
We can implement this as a Python list of images for each discriminator and use the update_image_pool() function below to maintain each pool list.
We can now define the training of each of the generator models.
The train() function below takes all six models (two discriminator, two generator, and two composite models) as arguments along with the dataset and trains the models.
The batch size is fixed at one image to match the description in the paper and the models are fit for 100 epochs.
Given that the horses dataset has 1,187 images, one epoch is defined as 1,187 batches and the same number of training iterations.
Images are generated using both generators each epoch and models are saved every five epochs or (1187 * 5) 5,935 training iterations.
The order of model updates is implemented to match the official Torch implementation.
First, a batch of real images from each domain is selected, then a batch of fake images for each domain is generated.
The fake images are then used to update each discriminator’s fake image pool.
Next, the Generator-A model (zebras to horses) is updated via the composite model, followed by the Discriminator-A model (horses).
Then the Generator-B (horses to zebra) composite model and Discriminator-B (zebras) models are updated.
Loss for each of the updated models is then reported at the end of the training iteration.
Importantly, only the weighted average loss used to update each generator is reported.
Tying all of this together, the complete example of training a CycleGAN model to translate photos of horses to zebras and zebras to horses is listed below.
The example can be run on CPU hardware, although GPU hardware is recommended.
The example might take a number of hours to run on modern GPU hardware.
If needed, you can access cheap GPU hardware via Amazon EC2; see the tutorial:Note: your specific results may vary given the stochastic nature of the learning algorithm.
Consider running the example a few times.
The loss is reported each training iteration, including the Discriminator-A loss on real and fake examples (dA), Discriminator-B loss on real and fake examples (dB), and Generator-AtoB and Generator-BtoA loss, each of which is a weighted average of adversarial, identity, forward, and backward cycle loss (g).
If loss for the discriminator goes to zero and stays there for a long time, consider re-starting the training run as it is an example of a training failure.
Plots of generated images are saved at the end of every epoch or after every 1,187 training iterations and the iteration number is used in the filename.
Models are saved after every five epochs or (1187 * 5) 5,935 training iterations, and again the iteration number is used in the filenames.
The plots of generated images can be used to choose a model and more training iterations may not necessarily mean better quality generated images.
Horses to Zebras translation starts to become reliable after about 50 epochs.
Plot of Source Photographs of Horses (top row) and Translated Photographs of Zebras (bottom row) After 53,415 Training IterationsThe translation from Zebras to Horses appears to be more challenging for the model to learn, although somewhat plausible translations also begin to be generated after 50 to 60 epochs.
I suspect that better quality results could be achieved with an additional 100 training epochs with weight decay, as is used in the paper, and perhaps with a data generator that systematically works through each dataset rather than randomly sampling.
Plot of Source Photographs of Zebras (top row) and Translated Photographs of Horses (bottom row) After 90,212 Training IterationsNow that we have fit our CycleGAN generators, we can use them to translate photographs in an ad hoc manner.
The saved generator models can be loaded and used for ad hoc image translation.
The first step is to load the dataset.
We can use the same load_real_samples() function as we developed in the previous section.
Review the plots of generated images and select a pair of models that we can use for image generation.
In this case, we will use the model saved around epoch 89 (training iteration 89,025).
Our generator models used a custom layer from the keras_contrib library, specifically the InstanceNormalization layer.
Therefore, we need to specify how to load this layer when loading each generator model.
This can be achieved by specifying a dictionary mapping of the layer name to the object and passing this as an argument to the load_model() keras function.
We can use the select_sample() function that we developed in the previous section to select a random photo from the dataset.
Next, we can use the Generator-AtoB model, first by selecting a random image from Domain-A (horses) as input, using Generator-AtoB to translate it to Domain-B (zebras), then use the Generator-BtoA model to reconstruct the original image (horse).
We can then plot the three photos side by side as the original or real photo, the translated photo, and the reconstruction of the original photo.
The show_plot() function below implements this.
We can then call this function to plot our real and generated photos.
This is a good test of both models, however, we can also perform the same operation in reverse.
Specifically, a real photo from Domain-B (zebra) translated to Domain-A (horse), then reconstructed as Domain-B (zebra).
Tying all of this together, the complete example is listed below.
Running the example first selects a random photo of a horse, translates it, and then tries to reconstruct the original photo.
Plot of a Real Photo of a Horse, Translation to Zebra, and Reconstructed Photo of a Horse Using CycleGAN.
Then a similar process is performed in reverse, selecting a random photo of a zebra, translating it to a horse, then reconstructing the original photo of the zebra.
Plot of a Real Photo of a Zebra, Translation to Horse, and Reconstructed Photo of a Zebra Using CycleGAN.
Note: your results will vary given the stochastic training of the CycleGAN model and choice of a random photograph.
Try running the example a few times.
The models are not perfect, especially the zebra to horse model, so you may want to generate many translated examples to review.
It also seems that both models are more effective when reconstructing an image, which is interesting as they are essentially performing the same translation task as when operating on real photographs.
This may be a sign that the adversarial loss is not strong enough during training.
We may also want to use a generator model in a standalone way on individual photograph files.
First, we can select a photo from the training dataset.
In this case, we will use “horse2zebra/trainA/n02381460_541.
jpg“.
Photograph of a HorseWe can develop a function to load this image and scale it to the preferred size of 256×256, scale pixel values to the range [-1,1], and convert the array of pixels to a single sample.
The load_image() function below implements this.
We can then load our selected image as well as the AtoB generator model, as we did before.
We can then translate the loaded image, scale the pixel values back to the expected range, and plot the result.
Tying this all together, the complete example is listed below.
Running the example loads the selected image, loads the generator model, translates the photograph of a horse to a zebra, and plots the results.
Photograph of a Horse Translated to a Photograph of a Zebra using CycleGANThis section lists some ideas for extending the tutorial that you may wish to explore.
If you explore any of these extensions, I’d love to know.
Post your findings in the comments below.
This section provides more resources on the topic if you are looking to go deeper.
In this tutorial, you discovered how to develop a CycleGAN model to translate photos of horses to zebras, and back again.
Specifically, you learned:Do you have any questions?.Ask your questions in the comments below and I will do my best to answer.
Develop Your GAN Models in Minutes .
with just a few lines of python codeDiscover how in my new Ebook: Generative Adversarial Networks with PythonIt provides self-study tutorials and end-to-end projects on: DCGAN, conditional GANs, image translation, Pix2Pix, CycleGAN and much more.
Finally Bring GAN Models to your Vision Projects Skip the Academics.
Just Results.
Click to learn more.