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 видео.
Это сохраняет анимацию в виде видео h264, закодированного в base64 непосредственно в теге HTML5 видео. Это учитывает параметры rc для записи, а также битрейт. Это также использует
intervalдля управления скоростью и использует параметрrepeatдля определения того, нужно ли циклировать.
-
to_jshtml(fps=None, embed_frames=True, default_mode=None) -
Генерирует HTML-представление анимации
-
Примеры использования matplotlib.animation.ArtistAnimation
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.animation.ArtistAnimation.html