How To Perform Neural Style Transfer with Python 3 and PyTorch
How To Perform Neural Style Transfer with Python 3 and PyTorch
We hope you find this tutorial helpful. In addition to guides like this one, we provide simple cloud infrastructure for developers. Learn more →

How To Perform Neural Style Transfer with Python 3 and PyTorch

UpdatedSeptember 13, 2018 19.9k views Python Python Frameworks Machine Learning Programming Project Development Ubuntu 16.04

Introduction

Machine learning, or ML, is a subfield of AI focused on algorithms that learn models from data.

Let's look at a practical application of machine learning in the field of Computer Vision called neural style transfer. In 2015, researchers used deep learning techniques to create an algorithm that mixed the content of one image with the artistic style of another. This new algorithm generated unique images, but also offered a unique perspective into how our visual system may infer new artistic concepts.

As its name suggests, neural style transfer relies on neural networks to perform this task. The exact details of this implementation are beyond the scope of this tutorial, but you can learn more in this blog post on artistic style transfer or from the original research manuscript.

In this tutorial, you will apply neural style transfer using Jupyter Notebook and the Linux command line to take an image like this:

An image of Rocket Sammy

and transform it by applying the artistic style of Vincent van Gogh's "Starry Night" to create this image:

An image of Starry night's style transferred to Rocket Sammy

Prerequisites

To complete this tutorial, you will need:

Working with machine learning models can be memory intensive, so your machine should have at least 8GB of memory to perform some of the calculations in this tutorial.

Step 1 — Installing Dependencies and Cloning the PyTorch-Style-Transfer GitHub Repository

In this tutorial, we'll use an open-source implementation of neural style transfer provided by Hang Zhang called PyTorch-Style-Transfer. This particular implementation uses the PyTorch library.

Activate your programming environment, and install PyTorch and the torchvision package with the following command:

  • pip install http://download.pytorch.org/whl/cu75/torch-0.1.12.post1-cp35-cp35m-linux_x86_64.whl
  • pip install torchvision

Note that for this tutorial, we need torch-0.1.12_2.

To avoid cluttering your home directory with files, create a new directory called style_transfer and use it as your working directory:

  • mkdir style_transfer
  • cd style_transfer

Next, clone the PyTorch-Style-Transfer repository to your working directory using the git clone command. You can learn more about Git in this Git tutorial series.

  • git clone https://github.com/zhanghang1989/PyTorch-Style-Transfer.git

The author of this repository has placed the code we will be using in the experiments folder of the PyTorch-Style-Transfer repository, so switch to this directory once all files have been cloned:

  • cd PyTorch-Style-Transfer/experiments

Take a look at the contents of the experiments directory:

  • ls

You'll see the following directories:

Output
camera_demo.py dataset images main.py models net.py option.py utils.py

In this tutorial you'll work with the images/ directory, which contains stock images, and the main.py script, which is used to apply neural style transfer to your images.

Before moving to the next section, you also need to download the pre-trained deep learning model required to run neural style transfer. These models can be large and therefore not suitable for storing on GitHub, so the author provides a small script to download the file. You'll find the script at models/download_model.sh.

First, make the script executable:

  • chmod +x ./models/download_model.sh

Then execute the script to download the model:

  • ./models/download_model.sh

Now that everything's downloaded, let's use these tools to transform some images.

Step 2 — Running your First Style Transfer Experiment

To illustrate how neural style transfer works, let's start by using the example provided by the author of the PyTorch-Style-Transfer repository. Since we will need to display and view images, it will be more convenient to use a Jupyter notebook.

Launch Jupyter from your terminal:

  • jupyter notebook

Then access Jupyter by following the instructions presented.

Once Jupyter is displayed, create a new notebook by selecting New > Python 3 from the top right pull-down menu:

Jupyter Notebook

This opens a new notebook where you can enter your code.

At the top of the notebook, add the following code to load the required libraries.

Notebook
import torch
import os
import subprocess
from IPython.display import Image
from IPython.display import display

Along with torch, we're also importing the standard libraries os and subprocess, which we'll use to run Python scripts directly from Jupyter notebook. We also include the IPython.display library, which lets us display images within the Jupyter notebook.

Note: Type ALT+ENTER (or SHIFT+ENTER on macOS) to run the code and move into a new code block within your notebook. Do this after each code block in this tutorial to see your results.

The example provided in the README file of the PyTorch-Style-Transfer repository uses stock images located in the images/ directory and the main.py script. You will need to provide at least five arguments in order to run the main.py script:

  • The path to the content image (located in /images/content).
  • The path to the style image (located in /images/21styles).
  • The path to the pretrained GAN (Generative Adversarial Network) model used to perform the style transfer (located in /models).
  • The path and name of the output image.
  • Deep learning models run much faster on GPUs. If you have one available then specify the --cuda=1 parameter, otherwise use --cuda=0.

To run the neural style transfer code, we'll specify the required arguments and use the subprocess library to run the command in the shell.

First, let's define the path to our working directory. We'll store in a variable called workingdir:

Notebook
# define the path to the working directory
experiment_dir = 'style_transfer/PyTorch-Style-Transfer/experiments'
workingdir = '{}/{}'.format(os.environ['HOME'], experiment_dir)

We'll use this variable throughout our code when we point to images and other files.

Now let's define the path to the main.py script, as well as the list of arguments that we will use as input for this test run. We'll specify that the content image is venice-boat.jpg, the style image isstarry_night.jpg, and we'll save the output of our neural style transfer to a file called test.jpg:

Notebook
# specify the path to the main.py script
path2script = '{}/main.py'.format(workingdir)

# specify the list of arguments to be used as input to main.py
args = ['eval',
        '--content-image',
        '{}/images/content/venice-boat.jpg'.format(workingdir),
        '--style-image',
        '{}/images/21styles/starry_night.jpg'.format(workingdir),
        '--model',
        '{}/models/21styles.model'.format(workingdir),
        '--output-image',
        '{}/test.jpg'.format(workingdir),
        '--cuda=0']

Before running the test example, you can take a quick look at the content and style images that you have chosen for this example by executing this code in your notebook:

Notebook
content_image = Image('{}/images/content/venice-boat.jpg'.format(workingdir))
style_image = Image('{}/images/21styles/starry_night.jpg'.format(workingdir))
display(content_image)
display(style_image)

You'll see these images displayed in the output:

The content image for your first example of neural style transfer

The style image for your first example of neural style transfer

Finally, concatenate the call to main.py and its list of arguments and run it in the shell using the subprocess.check_output function:

Notebook
# build subprocess command
cmd = ['python3', path2script] + args

# run the command
x = subprocess.check_output(cmd, universal_newlines=True)

Depending on the amount of memory available on your machine, this may take a minute or two to run. Once it has completed, you should see a test.jpg file in your working directory. From a Jupyter notebook, you can use Ipython magic commands to display the contents of your working directory within the Jupyter notebook:

Notebook
!ls $workingdir

Alternatively, you can use the ls command in your terminal. Either way you'll see the following output:

Output
__pycache__ dataset main.py myutils option.py camera_demo.py images models net test.jpg

You'll see a new file called test.jpg, which contains the results of the neural style transfer using your input content and style images.

Use the Image function to display the content of test.jpg:

Notebook
Image('{}/test.jpg'.format(workingdir))

Starry night's style transferred to the content of our image of Venitian boats

The artistic style of Vincent van Vogh's Starry Night canvas has been mapped to the content of our Venitian boat images. You've successfully applied neural style transfer with a textbook example, so let's try repeating this exercise with different images.

Step 3 — Transforming Your Own Images

So far, you've used the images provided by the author of the library we're using. Let's use our own images instead. To do this, you can either find an image you are interested in and use the URL for the image in the following command, or use the URL provided to use Sammy the Shark.

We'll use some IPython magic again to download the image to our working directory and place it into a file called sammy.png.

Notebook
!wget -O - 'https://assets.digitalocean.com/blog/static/sammy-the-shark-gets-a-birthday-makeover-from-simon-oxley/sammy-jetpack.png' > $workingdir/sammy.png

When you run this command in your notebook, you'll see the following output:

Output
--2017-08-15 20:03:27-- https://assets.digitalocean.com/blog/static/sammy-the-shark-gets-a-birthday-makeover-from-simon-oxley/sammy-jetpack.png Resolving assets.digitalocean.com (assets.digitalocean.com)... 151.101.20.233 Connecting to assets.digitalocean.com (assets.digitalocean.com)|151.101.20.233|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 10483 (10K) [image/png] Saving to: 'STDOUT' - 100%[===================>] 10.24K --.-KB/s in 0.001s 2017-08-15 20:03:27 (12.9 MB/s) - written to stdout [10483/10483]

Use the Image command to display the new image in the notebook:

Notebook
Image('{}/sammy.png'.format(workingdir))

An image of Rocket Sammy

Following the same workflow as the test run, let's run our artistic style transfer model using Rocket Sammy as the content image, and the same Starry Night picture as our style image.

We'll use the same code we used previously, but this time we'll specify the content image to be sammy.png, the style image to be starry_night.jpg, and we write the output to a file called starry_sammy.jpg. Then we execute the command:

Notebook
# specify the path to the main.py script
path2script = '{}/main.py'.format(workingdir)

# specify the list of arguments to be used as input to main.py
args = ['eval',
        '--content-image',
        '{}/sammy.png'.format(workingdir),
        '--style-image',
        '{}/images/21styles/starry_night.jpg'.format(workingdir),
        '--model',
        '{}/models/21styles.model'.format(workingdir),
        '--output-image',
        '{}/starry_sammy.jpg'.format(workingdir),
        '--cuda=0']

# build subprocess command
cmd = ['python3', path2script] + args

# run the bash command
x = subprocess.check_output(cmd, universal_newlines=True)

Then use the Image function to view the results of transferring the artistic style of Vincent van Vogh's Starry Night to the content of your Rocket Sammy image.

Notebook
Image('{}/starry_sammy.jpg'.format(workingdir))

You'll see the new stylized Rocket Sammy:

An image of Starry night's style transferred to Rocket Sammy

Let's try this again by mapping a different style image to our picture of Rocket Sammy. We'll use Picasso's The Muse this time. Again, we use sammy.png as our content image, but we'll change the style image to be la_muse.jpg. We'll save the output to musing_sammy.jpg:

Notebook
# specify the path to the main.py script
path2script = '{}/main.py'.format(workingdir)

# specify the list of arguments to be used as input to main.py
args = ['eval',
        '--content-image',
        '{}/sammy.png'.format(workingdir),
        '--style-image',
        '{}/images/21styles/la_muse.jpg'.format(workingdir),
        '--model',
        '{}/models/21styles.model'.format(workingdir),
        '--output-image',
        '{}/musing_sammy.jpg'.format(workingdir),
        '--cuda=0']

# build subprocess command
cmd = ['python3', path2script] + args

# run the bash command
x = subprocess.check_output(cmd, universal_newlines=True)

Once the code has finished running, display the output of your work using the output filename you specified and the Image function:

Notebook
Image('{}/musing_sammy.jpg'.format(workingdir))

An image of The Muse's style transferred to Rocket Sammy

By now, you should have a good idea how to use these transformations. Try using some of your own images if you haven't already.

Conclusion

In this tutorial, you used Python and an open-source PyTorch implementation of a neural style transfer model to apply stylistic transfer to images. The field of machine learning and AI is vast, and this is only one of its applications. Here are some additional things you can explore:

7 Comments

Creative Commons License