Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.


This repository contains a torch implementation for automatically applying optical flow deformations to pairs of images in order to morph between images. The optical flow calculation and loading code is from manuelruder/artistic-videos, and is based on DeepFlow. Theoretically, you could drop in another optical flow program which outputs .flo files in the Middlebury format.

This process is inspired by Patrick Feaster's post on Animating Historical Photographs With Image Morphing.

My blog post about this process: Animating Stereograms with Optical Flow Morphing


New York Skyline Historical Photo Cat and Child


  • torch7
  • DeepFlow and DeepMatching binaries in the current directory, as deepflow2-static and deepmatching-static


For input, you need two PNG images of the same dimensions named e.g. filename_0.png and filename_1.png. You can then run ./ filename to run all the steps and output the morphing animation as morphed_filename.gif.

You can also use ./ ID with an image ID from NYPL's Stereogranimator to download an animated GIF at low resolution and run it through the morphing process.

If you sign up for the NYPL Digital Collections API, you can use your API token with the included scripts to work with high-resolution original images. The nypl_recrop.rb script takes a Stereogranimator image ID as an argument and reads the API token from the NYPL_API_TOKEN environment variable, and attempts to apply the Stereogranimator's crop values to the original image. The script uses this process and passes the high-resolution cropped images to You can also pass the NYPL_API_TOKEN environment variable in your docker run command.

Docker Usage

I had very little luck getting DeepFlow to work on OS X, so I'm using Docker to run this with the included Dockerfile.

  • Build the Docker image with docker build -t torch-warp .
  • Run the build with docker run -t -i torch-warp /bin/bash. You may want to map a host directory as a data volume as well, in order to transfer images back and forth.
  • Use the scripts as described above inside the Docker container's shell.

I've also made this repository an automated build on Docker Hub: ryanfb/torch-warp


Fully automatic optical flow based image morphing implemented in Torch




No releases published


No packages published