matplotlib.animation.Animation #

クラス matplotlib.animation. アニメーション( fig、 event_source = None、 blit = False ) [source] #

アニメーションの基本クラス。

このクラスはそのままでは使用できないため、必要な動作を提供するためにサブクラス化する必要があります。

ノート

作成されたアニメーションは、アニメーションが実行される限り存続する変数に格納する必要があります。そうしないと、Animation オブジェクトがガベージコレクションされ、アニメーションが停止します。

パラメータ:

図Figure

描画やサイズ変更などの必要なイベントを取得するために使用される Figure オブジェクト。

event_sourceオブジェクト、オプション

必要なイベントが生成されたときにコールバックを実行したり、停止および開始したりできるクラス。

例としては、タイマー ( を参照TimedAnimation) やファイルシステム通知などがあります。

blit bool、デフォルト: False

描画を最適化するためにブリッティングを使用するかどうか。

こちらもご覧ください

FuncAnimation、ArtistAnimation

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

メソッド

`__init__`(図[, イベントソース, ブリット])
`new_frame_seq`()	フレーム情報の新しいシーケンスを返します。
`new_saved_frame_seq`()	保存/キャッシュされたフレーム情報の新しいシーケンスを返します。
`pause`()	アニメーションを一時停止します。
`resume`()	アニメーションを再開します。
`save`(ファイル名[、ライター、fps、dpi、コーデック、...])	すべてのフレームを描画して、アニメーションをムービーファイルとして保存します。
`to_html5_video`([embed_limit])	アニメーションを HTML5`<video>`タグに変換します。
`to_jshtml`([fps、embed_frames、default_mode])	アニメーションの HTML 表現を生成します。

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 , * , progress_callback = None ) [source] #

すべてのフレームを描画して、アニメーションをムービーファイルとして保存します。

パラメータ:

ファイル名str

出力ファイル名mymovie.mp4。

writerMovieWriterまたは str、デフォルト: rcParams["animation.writer"](デフォルト: 'ffmpeg')

使用するMovieWriterインスタンス、または使用するクラスを識別するキー (「ffmpeg」など)。

fps int、オプション

ムービーのフレームレート (1 秒あたり)。設定されていない場合は、アニメーションのフレーム間隔からのフレームレート。

dpi float、デフォルト: rcParams["savefig.dpi"](デフォルト: 'figure')

ムービーフレームのドット/インチを制御します。フィギュアのインチ単位のサイズと合わせて、ムービーのサイズを制御します。

コーデック文字列、デフォルト: rcParams["animation.codec"](デフォルト: 'h264')。

使用するビデオコーデック。特定のですべてのコーデックがサポートされているわけではありません MovieWriter。

ビットレートint、デフォルト: rcParams["animation.bitrate"](デフォルト: -1)

映画のビットレート (キロビット/秒)。値が大きいほどムービーの品質が高くなりますが、ファイルサイズが大きくなります。-1 の値は、基になるムービーエンコーダーがビットレートを選択できるようにします。

extra_args str または None のリスト、オプション

基になるムービーエンコーダーに渡される追加のコマンドライン引数。デフォルトの None は rcParams["animation.[name-of-encoder]_args"]、組み込みのライターを使用することを意味します。

メタデータdict[str, str]、デフォルト: {}

出力ファイルに含めるメタデータのキーと値のディクショナリ。使用できるキーには、タイトル、アーティスト、ジャンル、件名、著作権、srcform、コメントなどがあります。

extra_animリスト、デフォルト: []

Animation保存したムービーファイルに含める必要がある追加のオブジェクト。matplotlib.figure.Figureこれらは同じインスタンスからのものである必要があります。また、アニメーションフレームは単純に結合されるため、異なるアニメーションのフレーム間には 1:1 の対応が必要です。

savefig_kwargs dict、デフォルト: {}

savefig個々のフレームを保存するために使用される各呼び出しに渡されるキーワード引数。

progress_callback関数、オプション

保存の進行状況を通知するためにフレームごとに呼び出されるコールバック関数。署名が必要です

def func(current_frame: int, total_frames: int) -> Any

current_frameは現在のフレーム番号、 total_framesは保存するフレームの総数です。フレームの総数を特定できない場合、total_framesは None に設定されます。戻り値が存在する場合がありますが、無視されます。

進行状況を stdout に書き込むサンプルコード:

progress_callback =                    lambda i, n: print(f'Saving frame {i} of {n}')

ノート

fps、codec、bitrate、extra_args、およびmetadataは、インスタンスの構築に使用され、writerMovieWriterが文字列の場合にのみ渡すことができます。これらがNone以外として渡され、writerが a の場合、 aが送出されます。MovieWriterRuntimeError

to_html5_video ( embed_limit =なし) [source] #

アニメーションを HTML5<video>タグに変換します。

これにより、アニメーションが h264 ビデオとして保存され、base64 で直接 HTML5 ビデオタグにエンコードされます。rcParams["animation.writer"]これは(デフォルト: 'ffmpeg') とrcParams["animation.bitrate"](デフォルト: ) を尊重します-1。これもを使用し intervalて速度を制御し、repeat パラメーターを使用してループするかどうかを決定します。

パラメータ:

mbed_limit float、オプション: 返されるアニメーションの制限 (MB 単位)。制限を超えた場合、アニメーションは作成されません。デフォルトはrcParams["animation.embed_limit"](デフォルト: 20.0) = 20.0 です。

戻り値:

力: アニメーションが base64 でエンコードされた h264 ビデオとして埋め込まれた HTML5 ビデオタグ。埋め込み制限を超えると、文字列「動画が大きすぎて埋め込むことができません」が返されます。

to_jshtml ( fps =なし、 embed_frames = True、 default_mode =なし) [source] #

アニメーションの HTML 表現を生成します。

パラメータ:

fps int、オプション: ムービーのフレームレート (1 秒あたり)。設定されていない場合は、アニメーションのフレーム間隔からのフレームレート。
Embed_framesブール値、オプション
default_mode文字列、オプション: アニメーションが終了したらどうするか。のいずれかである必要があります。が True の場合、それ以外の場合はデフォルトです。{'loop', 'once', 'reflect'}'loop'self.repeat'once'