array2gif

Write a (list of) NumPy array(s) to an (animated) GIF.


Keywords
array2gif, animated, gif, encoder, numpy, rgb
License
BSD-3-Clause
Install
pip install array2gif==1.0.4

Documentation

Array2GIF: convert NumPy arrays to (animated) GIF

Animation of random pixels converging from two colors to one color. T = 0.7 T_c. T = 0.7 T_c Animation of random pixels converging less slowly to one color. T = 0.88 T_c. T = 0.88 T_c Animation of random pixels staying mostly random. T = 1.06 T_c. T = 1.06 T_c

Array2GIF provides a single top-level function, write_gif(), to write a 3-D NumPy array to a GIF, or a list of these arrays to an animated GIF. It works for me - just small animations of thermodynamics simulations - like the magnetization in the Ising model shown here.

Usage

Here is an example for a 2 pixel by 3 pixel animated GIF with two frames, switching 5 frames per second. All animations from this library will loop indefinitely.

import numpy as np
from array2gif import write_gif

dataset = [
    np.array([
        [[255, 0, 0], [255, 0, 0]],  # red intensities
        [[0, 255, 0], [0, 255, 0]],  # green intensities
        [[0, 0, 255], [0, 0, 255]]   # blue intensities
    ]),
    np.array([
        [[0, 0, 255], [0, 0, 255]],
        [[0, 255, 0], [0, 255, 0]],
        [[255, 0, 0], [255, 0, 0]]
    ])
]
write_gif(dataset, 'rgbbgr.gif', fps=5)

# or for just a still GIF
write_gif(dataset[0], 'rgb.gif')

Installation

Either:

pip install array2gif

or:

pip install git+https://github.com/tanyaschlusser/array2gif.git#egg=array2gif