анимация

matplotlib.анимация

class matplotlib.animation.AVConvBase

Базы: matplotlib.animation.FFMpegBase

args_key = 'animation.avconv_args'

exec_key = 'animation.avconv_path'

class matplotlib.animation.AVConvFileWriter(*args, **kwargs)

Базы: matplotlib.animation.AVConvBase, matplotlib.animation.FFMpegFileWriter

class matplotlib.animation.AVConvWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)

Базы: matplotlib.animation.AVConvBase, matplotlib.animation.FFMpegWriter

Создаёт новый объект MovieWriter.

fps: int

Частота кадров для фильма.

codec: строка или None, необязательно

Используемый кодек. Если None (по умолчанию), используется значение из rcParam animation.codec.

bitrate: int или None, необязательно

Битрейт для сохранённого файла фильма, позволяющий контролировать размер и качество выходного файла. Значение по умолчанию — None, в этом случае используется значение из rcParam animation.bitrate. Значение -1 означает, что битрейт должен определяться автоматически подлежащей утилитой.

extra_args: список строк или None

Список дополнительных строковых аргументов для передачи подлежащей утилите создания фильма. По умолчанию None, в этом случае передаются дополнительные аргументы из rcParam ‘animation.extra_args’.

metadata: словарь string:string или None

Словарь пар «ключ:значение» для метаданных, которые нужно включить в выходной файл. Некоторые полезные ключи: title, artist, genre, subject, copyright, srcform, comment.

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

Базы: object

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

fig — объект figure, используемый для получения событий рисования, изменения размера и других необходимых событий.

event_source — класс, который может запускать обратный вызов при возникновении желаемых событий, а также останавливаться и запускаться. Примеры включают таймеры (см. TimedAnimation) и уведомления системы файлов.

blit — логическое значение, которое управляет тем, используется ли кеширование (blitting) для оптимизации рисования.

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 — имя выходного файла, например, mymovie.mp4

writer — либо экземпляр MovieWriter, либо строковый ключ, определяющий используемый класс, например, ‘ffmpeg’ или ‘mencoder’. Если ничего не передано, используется значение rcparam animation.writer.

dpi управляет точками на дюйм для кадров фильма. В сочетании с размером фигуры в дюймах это определяет размер фильма.

savefig_kwargs — словарь с ключевыми аргументами, которые нужно передать команде ‘savefig’, вызываемой многократно для сохранения отдельных кадров. Это можно использовать для установки жёстких границ, например.

extra_anim — список дополнительных объектов Animation, которые нужно включить в сохранённый файл фильма. Они должны быть из того же экземпляра matplotlib.Figure. Кроме того, кадры анимации будут просто объединены, поэтому должна быть взаимно однозначная связь между кадрами из разных анимаций.

Эти оставшиеся аргументы используются для создания экземпляра MovieWriter при необходимости и считаются допустимыми только если writer не является экземпляром MovieWriter.

fps — кадры в секунду в фильме. По умолчанию None, в этом случае частота кадров будет установлена ​​на основе заданного интервала анимации.

codec — используемый видеокодек. Не все кодеки поддерживаются данным MovieWriter. Если не указан, по умолчанию используется значение, заданное rcparam animation.codec.

bitrate определяет количество бит в секунду в сжатом фильме в килобитах в секунду. Более высокое значение означает более высокое качество фильма, но за счёт увеличения размера файла. Если значение не указано, по умолчанию используется значение из rcparam animation.bitrate.

extra_args — список дополнительных строковых аргументов, передаваемых подлежащей утилите создания фильма. По умолчанию None, в этом случае передаются дополнительные аргументы из rcParam ‘animation.extra_args’.

metadata — словарь пар «ключ:значение» для метаданных, которые нужно включить в выходной файл. Некоторые полезные ключи: title, artist, genre, subject, copyright, srcform, comment.

to_html5_video()

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

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

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

Базы: matplotlib.animation.TimedAnimation

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

frame_info — список, где каждый элемент списка — это набор элементов управления, которые нужно включить в каждом кадре. Они будут отключены для других кадров.

class matplotlib.animation.FFMpegBase

Базы: object

args_key = 'animation.ffmpeg_args'

exec_key = 'animation.ffmpeg_path'

output_args

class matplotlib.animation.FFMpegFileWriter(*args, **kwargs)

Базы: matplotlib.animation.FileMovieWriter, matplotlib.animation.FFMpegBase

supported_formats = ['png', 'jpeg', 'ppm', 'tiff', 'sgi', 'bmp', 'pbm', 'raw', 'rgba']

class matplotlib.animation.FFMpegWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)

Базы: matplotlib.animation.MovieWriter, matplotlib.animation.FFMpegBase

Создаёт новый объект MovieWriter.

fps: int

Частота кадров для фильма.

codec: строка или None, необязательно

Используемый кодек. Если None (по умолчанию), используется значение из rcParam animation.codec.

bitrate: int или None, необязательно

Битрейт для сохранённого файла фильма, позволяющий контролировать размер и качество выходного файла. Значение по умолчанию — None, в этом случае используется значение из rcParam animation.bitrate. Значение -1 означает, что битрейт должен определяться автоматически подлежащей утилитой.

extra_args: список строк или None

Список дополнительных строковых аргументов для передачи подлежащей утилите создания фильма. По умолчанию None, в этом случае передаются дополнительные аргументы из rcParam ‘animation.extra_args’.

metadata: словарь string:string или None

Словарь пар «ключ:значение» для метаданных, которые нужно включить в выходной файл. Некоторые полезные ключи: title, artist, genre, subject, copyright, srcform, comment.

class matplotlib.animation.FileMovieWriter(*args, **kwargs)

Bases: matplotlib.animation.MovieWriter

MovieWriter подкласс, отвечающий за запись в файл.

cleanup()

finish()

frame_format

Формат (png, jpeg и т. д.) для сохранения кадров, который может быть определен отдельными подклассами.

frame_size_can_vary = True

grab_frame(**savefig_kwargs)

Получение информации об изображении из фигуры и сохранение её как кадра анимации. Все ключевые аргументы в savefig_kwargs передаются команде «savefig», которая сохраняет фигуру.

setup(fig, outfile, dpi, frame_prefix='_tmp', clear_temp=True)

Выполнение настройки для записи файла анимации.

fig: matplotlib.Figure instance

Объект фигуры, содержащий информацию о кадрах

outfile: строка

Имя файла результирующего файла анимации

dpi: целое число

DPI (или разрешение) файла. Это управляет размером в пикселях результирующего файла анимации.

frame_prefix: строка, необязательно

Префикс имени файла для временных файлов. По умолчанию «_tmp»

clear_temp: логическое значение

Указывает, должны ли временные файлы удаляться после записи анимации. (Полезно для отладки.) По умолчанию True.

class matplotlib.animation.FuncAnimation(fig, func, frames=None, init_func=None, fargs=None, save_count=None, **kwargs)

Bases: matplotlib.animation.TimedAnimation

Создает анимацию, многократно вызывая функцию func, передавая (необязательные) аргументы в fargs.

frames может быть генератором, итерируемым объектом или числом кадров.

init_func — функция, используемая для рисования чистого кадра. Если не указана, будут использоваться результаты рисования из первого элемента последовательности кадров. Эта функция будет вызвана один раз перед первым кадром.

Если blit=True, func и init_func должны возвращать итерируемый объект из художников, которые нужно перерисовать.

kwargs включают repeat, repeat_delay и interval: interval рисует новый кадр каждые interval миллисекунд. repeat управляет тем, должна ли анимация повторяться, когда последовательность кадров завершается. repeat_delay необязательно добавляет задержку в миллисекундах перед повторением анимации.

new_frame_seq()

new_saved_frame_seq()

class matplotlib.animation.ImageMagickBase

Bases: object

args_key = 'animation.convert_args'

delay

exec_key = 'animation.convert_path'

output_args

class matplotlib.animation.ImageMagickFileWriter(*args, **kwargs)

Bases: matplotlib.animation.FileMovieWriter, matplotlib.animation.ImageMagickBase

supported_formats = ['png', 'jpeg', 'ppm', 'tiff', 'sgi', 'bmp', 'pbm', 'raw', 'rgba']

class matplotlib.animation.ImageMagickWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)

Bases: matplotlib.animation.MovieWriter, matplotlib.animation.ImageMagickBase

Создает новый объект MovieWriter.

fps: целое число

Частота кадров для анимации.

codec: строка или None, необязательно

Кодек для использования. Если None (по умолчанию), используется значение в rcParam animation.codec.

bitrate: целое число или None, необязательно

Битрейт для сохранённого файла анимации, что является одним из способов управления размером и качеством выходного файла. Значение по умолчанию None, которое использует значение, хранящееся в rcParam animation.bitrate. Значение -1 подразумевает, что битрейт должен определяться автоматически базовой утилитой.

extra_args: список строк или None

Список дополнительных строковых аргументов, которые будут переданы базовой утилите для анимации. По умолчанию None, который передаёт дополнительные аргументы в rcParam «animation.extra_args».

metadata: словарь {строка: строка} или None

Словарь ключей и значений для метаданных, которые следует включить в выходной файл. Некоторые полезные ключи включают: title, artist, genre, subject, copyright, srcform, comment.

class matplotlib.animation.MencoderBase

Bases: object

allowed_metadata = ['name', 'artist', 'genre', 'subject', 'copyright', 'srcform', 'comment']

args_key = 'animation.mencoder_args'

exec_key = 'animation.mencoder_path'

output_args

class matplotlib.animation.MencoderFileWriter(*args, **kwargs)

Bases: matplotlib.animation.FileMovieWriter, matplotlib.animation.MencoderBase

supported_formats = ['png', 'jpeg', 'tga', 'sgi']

class matplotlib.animation.MencoderWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)

Bases: matplotlib.animation.MovieWriter, matplotlib.animation.MencoderBase

Создает новый объект MovieWriter.

fps: целое число

Частота кадров для анимации.

codec: строка или None, необязательно

Кодек для использования. Если None (по умолчанию), используется значение в rcParam animation.codec.

bitrate: целое число или None, необязательно

Битрейт для сохранённого файла анимации, что является одним из способов управления размером и качеством выходного файла. Значение по умолчанию None, которое использует значение, хранящееся в rcParam animation.bitrate. Значение -1 подразумевает, что битрейт должен определяться автоматически базовой утилитой.

extra_args: список строк или None

Список дополнительных строковых аргументов, которые будут переданы базовой утилите для анимации. По умолчанию None, который передаёт дополнительные аргументы в rcParam «animation.extra_args».

metadata: словарь {строка: строка} или None

Словарь ключей и значений для метаданных, которые следует включить в выходной файл. Некоторые полезные ключи включают: title, artist, genre, subject, copyright, srcform, comment.

class matplotlib.animation.MovieWriter(fps=5, codec=None, bitrate=None, extra_args=None, metadata=None)

Базовый класс для записи видео. По сути, MovieWriter предоставляет способ получения кадров, вызывая метод grab_frame(). Метод setup() вызывается для начала процесса, а метод finish() — после его завершения. Этот класс настроен для записи данных кадров видео в канал. Для облегчения этого процесса используется метод saving() как контекстный менеджер, как:

with moviewriter.saving('myfile.mp4'):
    # Iterate over frames
    moviewriter.grab_frame()

Использование контекстного менеджера гарантирует выполнение необходимых операций настройки и завершения.

frame_format: строка

Формат, используемый для записи данных кадра, по умолчанию равен ‘rgba’

Создаёт новый объект MovieWriter.

fps: целое число

Частота кадров для видео.

codec: строка или None, необязательно

Кодек для использования. Если None (по умолчанию), используется значение из параметра rcParam animation.codec.

bitrate: целое число или None, необязательно

Битрейт для сохранённого файла видео, что является одним из способов управления размером и качеством выходного файла. Значение по умолчанию — None, которое использует значение, хранящееся в параметре rcParam animation.bitrate. Значение -1 означает, что битрейт должен определяться автоматически основополагающей утилитой.

extra_args: список строк или None

Список дополнительных строковых аргументов, которые должны быть переданы основополагающей утилите для обработки видео. По умолчанию None, что передает дополнительные аргументы из параметра rcParam ‘animation.extra_args’.

metadata: словарь вида строка:строка или None

Словарь пар «ключ-значение» для метаданных, которые следует включить в выходной файл. Некоторые полезные ключи включают: title, artist, genre, subject, copyright, srcform, comment.

classmethod bin_path()

Возвращает бинарный путь к инструменту командной строки, используемому конкретным подклассом. Это метод класса, поэтому инструмент можно искать перед тем, как сделать доступным конкретный подкласс MovieWriter.

cleanup()

Очистка и сборка процесса, используемого для записи файла видео.

finish()

Завершение всех операций обработки записи видео.

frame_size

Кортеж (ширина, высота) в пикселях кадра видео.

frame_size_can_vary = False

grab_frame(**savefig_kwargs)

Извлечение информации об изображении из рисунка и сохранение её как кадра видео. Все ключевые аргументы в savefig_kwargs передаются команде ‘savefig’, которая сохраняет рисунок.

classmethod isAvailable()

Проверка наличия подкласса MovieWriter путём запуска инструмента командной строки.

saving(*args)

Контекстный менеджер для упрощения записи файла видео.

*args — это любые параметры, которые должны быть переданы методу setup.

setup(fig, outfile, dpi, *args)

Выполнение настройки для записи файла видео.

fig: matplotlib.Figure instance

Объект рисунка, содержащий информацию о кадрах

outfile: строка

Имя файла результирующего видео

dpi: целое число

DPI (или разрешение) файла. Это контролирует размер в пикселях результирующего файла видео.

class matplotlib.animation.MovieWriterRegistry

Bases: object

is_available(name)

list()

Получение списка доступных MovieWriter.

register(name)

class matplotlib.animation.TimedAnimation(fig, interval=200, repeat_delay=None, repeat=True, event_source=None, *args, **kwargs)

Bases: matplotlib.animation.Animation

Animation подкласс, поддерживающий анимацию, основанную на времени, рисуя новый кадр каждые interval миллисекунд.

repeat управляет тем, должна ли анимация повторяться при завершении последовательности кадров.

repeat_delay необязательно добавляет задержку в миллисекундах перед повторением анимации.