matplotlib.animation.Animation

class matplotlib.animation.Animation(fig, event_source=None, blit=False) [source]

Этот класс оборачивает создание анимации с помощью matplotlib.

Это базовый класс, который необходимо наследовать для предоставления необходимого поведения.

Этот класс обычно не используется напрямую.

Параметры:

figFigure Объект фигуры, используемый для отрисовки, изменения размера и других необходимых событий. event_sourceobject, optional Класс, который может запускать обратный вызов при возникновении необходимых событий, а также останавливаться и запускаться. Примеры включают таймеры (см. TimedAnimation) и уведомления о файловой системе. blitbool, optional управляет использованием буферизации для оптимизации отрисовки. По умолчанию False.

См. также

FuncAnimation, ArtistAnimation

__init__(self, fig, event_source=None, blit=False) [source]

Инициализировать self. См. help(type(self)) для точного подписи.

Методы

__init__(self, fig[, event_source, blit])	Инициализировать self.
new_frame_seq(self)	Возвращает новую последовательность информации о кадрах.
new_saved_frame_seq(self)	Возвращает новую последовательность сохранённой/кэшированной информации о кадрах.
save(self, filename[, writer, fps, dpi, ...])	Сохраните анимацию в виде файла видео, нарисовав каждый кадр.
to_html5_video(self[, embed_limit])	Преобразуйте анимацию в тег HTML5 <video>.
to_jshtml(self[, fps, embed_frames, ...])	Создайте HTML-представление анимации

new_frame_seq(self) [source]

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

new_saved_frame_seq(self) [source]

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

save(self, filename, writer=None, fps=None, dpi=None, codec=None, bitrate=None, extra_args=None, metadata=None, extra_anim=None, savefig_kwargs=None, *, progress_callback=None) [source]

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

Параметры:

filenamestr Имя выходного файла, например, mymovie.mp4. writerMovieWriter or str, optional Экземпляр MovieWriter для использования или ключ, идентифицирующий используемый класс, например, 'ffmpeg'. Если None, по умолчанию rcParams["animation.writer"] (значение по умолчанию: 'ffmpeg') = 'ffmpeg'. fpsnumber, optional Кадров в секунду в видео. По умолчанию None, который будет использовать указанный в анимации интервал для установки кадров в секунду. dpinumber, optional Управляет точками на дюйм для кадров видео. В сочетании с размером фигуры в дюймах управляет размером видео. Если None, по умолчанию rcParams["savefig.dpi"] (значение по умолчанию: 'figure'). codecstr, optional Кодек видео, который будет использоваться. Не все кодеки поддерживаются данным MovieWriter. Если None, по умолчанию rcParams["animation.codec"] (значение по умолчанию: 'h264') = 'h264'. bitratenumber, optional Указывает количество бит, используемых в секунду в сжатом видео, в килобитах в секунду. Более высокое число означает более высокое качество видео, но за счёт увеличения размера файла. Если None, по умолчанию rcParams["animation.bitrate"] (значение по умолчанию: -1) = -1. extra_argslist, optional Список дополнительных строковых аргументов, которые должны быть переданы в базовую утилиту видео. Если None, по умолчанию rcParams["animation.extra_args"]. metadataDict[str, str], optional Словарь ключей и значений для метаданных, которые необходимо включить в выходной файл. Некоторые полезные ключи включают: title, artist, genre, subject, copyright, srcform, comment. extra_animlist, optional Дополнительные объекты Animation, которые должны быть включены в сохранённый файл видео. Они должны быть из того же экземпляра matplotlib.figure.Figure. Кроме того, кадры анимации будут просто объединены, поэтому должна быть 1:1 корреляция между кадрами разных анимаций. savefig_kwargsdict, optional Это словарь, содержащий ключевые аргументы, которые должны быть переданы команде savefig которая вызывается многократно для сохранения отдельных кадров. progress_callbackfunction, optional Функция обратного вызова, которая будет вызываться для каждого кадра, чтобы уведомить о ходе сохранения. Она должна иметь подпись def func(current_frame: int, total_frames: int) -> Any где current_frame — номер текущего кадра, а total_frames — общее количество кадров для сохранения. total_frames устанавливается в значение None, если общее количество кадров определить невозможно. Возвращаемые значения могут существовать, но игнорируются. Пример кода для записи прогресса в стандартный вывод: progress_callback = lambda i, n: print(f'Saving frame {i} of {n}')

Примечания

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

to_html5_video(self, embed_limit=None) [source]

Преобразуйте анимацию в тег HTML5 <video>.

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

Параметры:	embed_limitfloat, optional Предел, в МБ, возвращаемой анимации. Анимация не создаётся, если предел превышен. По умолчанию rcParams["animation.embed_limit"] (значение по умолчанию: 20.0) = 20.0.
Возвращает:	video_tagstr Тег HTML5 video с вложенной анимацией как кодированное в base64 видео h264. Если предел embed_limit превышен, возвращается строка "Видео слишком велико для встраивания."

to_jshtml(self, fps=None, embed_frames=True, default_mode=None) [source]

Создайте HTML-представление анимации