matplotlib.animation.ArtistAnimation

class matplotlib.animation.ArtistAnimation(fig, artists, *args, **kwargs) [source]

Bases: matplotlib.animation.TimedAnimation

Анимация, использующая фиксированный набор Artist объектов.

Перед созданием экземпляра должны быть выполнены все операции построения графиков, и соответствующие объекты-артисты должны быть сохранены.

Параметры:

fig : matplotlib.figure.Figure Объект фигуры, используемый для получения событий рисования, изменения размера и других необходимых событий. artists : list Каждый элемент списка — это набор артистов, представляющих то, что должно быть включено в каждом кадре. Они будут отключены для других кадров. interval : number, optional Задержка между кадрами в миллисекундах. По умолчанию 200. repeat_delay : number, optional Если анимация повторяется, добавляет задержку в миллисекундах перед повторением анимации. По умолчанию None. repeat : bool, optional Управляет тем, должна ли анимация повторяться, когда последовательность кадров завершается. По умолчанию True. blit : bool, optional Управляет тем, используется ли блинтинг для оптимизации рисования. По умолчанию False.

new_frame_seq()

Создает новую последовательность информации о кадрах.

new_saved_frame_seq()

Создает новую последовательность сохранённой/кешированной информации о кадрах.

save(filename, writer=None, fps=None, dpi=None, codec=None, bitrate=None, extra_args=None, metadata=None, extra_anim=None, savefig_kwargs=None)

Сохраняет файл анимированного видео, рисуя каждый кадр.

Параметры:

filename : str Имя выходного файла, например, mymovie.mp4. writer : MovieWriter or str, optional Экземпляр MovieWriter для использования или ключ, идентифицирующий используемый класс, например, 'ffmpeg'. Если None, по умолчанию rcParams["animation.writer"]. fps : number, optional Кадры в секунду в анимированном видео. По умолчанию None, которое будет использовать указанный интервал анимации для установки кадров в секунду. dpi : number, optional Управление точками на дюйм для кадров анимированного видео. В сочетании с размером фигуры в дюймах это управляет размером видео. Если None, по умолчанию rcParams["savefig.dpi"]. codec : str, optional Кодек видео, который будет использоваться. Не все кодеки поддерживаются данным MovieWriter. Если None, по умолчанию rcParams["animation.codec"]. bitrate : number, optional Указывает количество бит, используемых в секунду в сжатом видео, в килобитах в секунду. Более высокое значение означает более высокое качество видео, но за счёт увеличения размера файла. Если None, по умолчанию rcParams["animation.bitrate"]. extra_args : list, optional Список дополнительных строковых аргументов, которые необходимо передать базовой утилите видео. Если None, по умолчанию rcParams["animation.extra_args"]. metadata : Dict[str, str], optional Словарь ключей и значений для метаданных, которые необходимо включить в выходной файл. Некоторые полезные ключи: title, artist, genre, subject, copyright, srcform, comment. extra_anim : list, optional Дополнительные объекты Animation, которые должны быть включены в сохранённый файл анимированного видео. Они должны быть из одного и того же экземпляра matplotlib.figure.Figure. Кроме того, кадры анимации просто объединяются, поэтому должна быть 1:1 корреспонденция между кадрами разных анимаций. savefig_kwargs : dict, optional Словарь, содержащий ключевые аргументы, которые необходимо передать команде savefig, которая вызывается многократно для сохранения отдельных кадров.

Примечания

fps, codec, bitrate, extra_args, metadata используются для создания экземпляра MovieWriter и могут быть переданы только если writer является строкой. Если они переданы как не-None и writer является MovieWriter, будет возбуждено исключение RuntimeError.

to_html5_video(embed_limit=None)

Возвращает анимацию в виде тега HTML5 video.

Это сохраняет анимацию в виде видео h264, закодированного в base64 непосредственно в теге HTML5 video. Это учитывает параметры rc для записывающего устройства, а также скорость передачи данных. Также используется interval для управления скоростью и параметр repeat для определения, нужно ли циклировать.

to_jshtml(fps=None, embed_frames=True, default_mode=None)

Генерирует HTML-представление анимации

Примеры использования matplotlib.animation.ArtistAnimation

Анимированное изображение с использованием предварительно вычисленного списка изображений