Interpolating

ahlive can make animations alive.

interp

There are various interp methods built-in.

import ahlive as ah
interp = "linear"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp=interp, inline_labels=interp,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

import ahlive as ah
interp = "cubic"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp=interp, inline_labels=interp,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

import ahlive as ah
interp = "elastic"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp=interp, inline_labels=interp,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

gifsicle: warning: trivial adaptive palette (only 248 colors in source)

For a full list:

import ahlive as ah
ah.easing.INTERPS

['fill',
 'linear',
 'cubic',
 'exponential',
 'quadratic',
 'quartic',
 'quintic',
 'circular',
 'sine',
 'bounce',
 'elastic',
 'back']

ease

There are also three easing methods for each of these interp methods.

import ahlive as ah

ease = "in_out"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp="cubic", ease=ease, inline_labels=ease,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

import ahlive as ah

ease = "in"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp="cubic", ease=ease, inline_labels=ease,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

import ahlive as ah

ease = "out"
ah.Array(
    [0, 1], [1, 1], s=[18, 488],
    interp="cubic", ease=ease, inline_labels=ease,
    xmargins=(0.1, 0.5), ymargins=0, figsize=(10, 0.75),
    revert='traceback', style="bare", watermark=" "
).render()

frames

The number of frames per transition to the next base state can be controlled using frames.

Higher number of frames will be more smooth.

import ahlive as ah
ah.Array([0, 1], [0, 1], frames=25).render()

gifsicle: warning: trivial adaptive palette (only 51 colors in source)

Lower number of frames will be more choppy.

import ahlive as ah
ah.Array([0, 1], [0, 1], frames=5).render()

gifsicle: warning: trivial adaptive palette (only 27 colors in source)

fps can be set alongside frames to control the length of the animation.

revert

There are three revert methods.

boomerang finds the shortest path to the initial state.

import ahlive as ah
ah.Array(
    [0, 50, 1000], [0, 1000, 5000], revert='boomerang'
).render()

gifsicle: warning: trivial adaptive palette (only 46 colors in source)

traceback backtracks the original path to the initial state.

import ahlive as ah
ah.Array(
    [0, 50, 1000], [0, 1000, 5000], revert='traceback'
).render()

gifsicle: warning: trivial adaptive palette (only 51 colors in source)

rollback is like traceback, but disregards the original path’s durations.

import ahlive as ah
ah.Array(
    [0, 50, 1000], [0, 1000, 5000], revert='rollback'
).render()

gifsicle: warning: trivial adaptive palette (only 51 colors in source)

stand-alone

The Easing class be applied to any generic Iterables.

import numpy as np
from ahlive import Easing

array = np.array([0, 1, 3])
easing = Easing(interp='cubic', ease='in')
easing.interpolate(array)

array([[0.00000000e+00, 1.45793847e-04, 1.16635078e-03, 3.93643388e-03,
        9.33080624e-03, 1.82242309e-02, 3.14914711e-02, 5.00072897e-02,
        7.46464499e-02, 1.06283715e-01, 1.45793847e-01, 1.94051611e-01,
        2.51931768e-01, 3.20309083e-01, 4.00058318e-01, 4.92054235e-01,
        5.97171599e-01, 7.16285173e-01, 8.50269719e-01, 1.00000000e+00,
        1.00000000e+00, 1.00029159e+00, 1.00233270e+00, 1.00787287e+00,
        1.01866161e+00, 1.03644846e+00, 1.06298294e+00, 1.10001458e+00,
        1.14929290e+00, 1.21256743e+00, 1.29158769e+00, 1.38810322e+00,
        1.50386354e+00, 1.64061817e+00, 1.80011664e+00, 1.98410847e+00,
        2.19434320e+00, 2.43257035e+00, 2.70053944e+00, 3.00000000e+00,
        3.00000000e+00]])