Bounding

It’s easy to bound the extents in the animation!

limits

xlim0s, xlim1s, ylim0s, and ylim1s accept an Iterable, str, or scalar.

If an Iterable is passed, the plots’ limits are animated! The length of the Iterable must match the number of states.

[1]:
import ahlive as ah
ah.Array([0, 1, 2], [4, 5, 6], xlim1s=[7, 8, 9]).render()
gifsicle: warning: trivial adaptive palette (only 206 colors in source)
[1]:

If a scalar is passed, the limits are statically set to that value.

[2]:
import ahlive as ah
ah.Array([0, 1, 2], [4, 5, 6], xlim1s=9).render()
gifsicle: warning: trivial adaptive palette (only 202 colors in source)
[2]:

There are a couple built-in str options for limits.

fixed sets the limits to the absolute min / max of all items and states.

[3]:
import ahlive as ah
ah.Array([0, 1, 2], [4, 5, 6], xlim1s='fixed').render()
gifsicle: warning: trivial adaptive palette (only 194 colors in source)
[3]:

follow follows the current state’s min/max across all items.

[4]:
import ahlive as ah
ah.Array([0, 1, 2, 0], [4, 5, 6, 6], xlim1s='follow').render()
gifsicle: warning: trivial adaptive palette (only 228 colors in source)
[4]:

explore is similar to follow except, the min/max doesn’t decrease once explored.

[5]:
import ahlive as ah
ah.Array([0, 1, 2, 0], [4, 5, 6, 6], xlim1s='explore').render()
gifsicle: warning: trivial adaptive palette (only 228 colors in source)
[5]:

All these string limits can be suffixed with a desired offset value.

[6]:
import ahlive as ah
ah.Array([0, 1, 2, 0], [4, 5, 6, 6], xlim1s='explore_1').render()
gifsicle: warning: trivial adaptive palette (only 218 colors in source)
[6]:

If xs is a datetime type, a string representing a timedelta value can be passed. Any units listed in `pd.to_timedelta <https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.to_timedelta.html>`__ can be used.

[7]:
import ahlive as ah
import pandas as pd
ah.Array(pd.date_range("2017-02-01", "2017-02-04"), [4, 5, 6, 6], xlim1s='explore_12H').render()
gifsicle: warning: trivial adaptive palette (only 231 colors in source)
[7]:

If setting xlim0s and xlim1s or ylim0s and ylim1s individually feels tedious, there is the option to set xlims and ylims.

[8]:
import ahlive as ah
ah.Array([0, 1, 2, 0], [4, 5, 6, 6], xlims='explore', ylims='explore').render()
gifsicle: warning: trivial adaptive palette (only 229 colors in source)
[8]: