Weave は moviepy を使用してビデオを自動的にログに記録します。これにより、ビデオの入力と出力をトレースされた関数に渡すことができ、Weave がビデオデータのアップロードと保存を自動的に処理します。
ビデオのサポートは現在 Python でのみ利用可能です。
利用の前提条件
weave と moviepy==1.0.3 をインストールします。- W&B アカウントを作成します。
サポートされているビデオタイプ
Weave は、以下のような moviepy のビデオクリップオブジェクトを認識します。
- ビデオファイルからロードされた
VideoFileClip
ImageClip、ColorClip、TextClip などのメモリ内クリップ
ファイルベースのクリップの直接アップロード
クリップが VideoFileClip であり、サポートされている拡張子を持つ有効なファイル名がある場合、Weave はそのファイルを直接アップロードします。
サポートされているファイル拡張子:
メモリ内クリップのサポート
ビデオオブジェクトがメモリ内にある（ディスク上にファイルがない）場合、Weave はそれを .mp4 ファイルとしてエンコードし、自動的にアップロードを処理します。これは以下のタイプのクリップに適用されます。
ImageClipColorClipTextClip
例: ビデオ関数のトレース
以下のコードサンプルは、Weave でビデオ プロセッシング 関数をトレースする方法を示しています。このコードサンプルでは以下のことを行います。
video-test という名前の Weave Projects を初期化します。weave.op として追跡される get_video 関数を定義し、ロードされた VideoFileClip から 1 秒間のサブクリップを VideoClip として抽出します。- Weave でクリップをアップロードし、追跡します。
- ビデオが見つからない場合、ダミーの MP4 ビデオを自動的に生成します。
スレッドセーフの問題を避けるため、VideoFileClip オブジェクトを Weave op の外で作成するのではなく、常にパスを渡すようにしてください。
import os
import weave
from moviepy.editor import VideoFileClip, ColorClip, VideoClip
# プロジェクト名を更新するか、'video-test' という名前の新しいプロジェクトを作成します
weave.init('video-test')
@weave.op
def get_video(clip: VideoFileClip) -> VideoClip:
"""クリップを直接渡すのではなく、パスによってビデオを処理します。
これにより、VideoFileClip が Weave op のスレッドコンテキスト内で作成および管理され、
スレッドセーフの問題を回避できます。
"""
new_clip = clip.subclip(0, 1)
return new_clip
if __name__ == "__main__":
os.makedirs("videos", exist_ok=True)
# MP4 ファイルを指すようにパスを更新してください
video_path = './videos/example.mp4'
# ビデオが存在しない場合はダミービデオを生成します
# ダミービデオの内容: 5秒間表示される赤い正方形
if not os.path.isfile(video_path):
print("No video found. Creating dummy video...")
dummy_clip = ColorClip(size=(640, 480), color=(255, 0, 0), duration=5)
dummy_clip.write_videofile(video_path, fps=24)
clip = VideoFileClip(video_path, has_mask=False, audio=True)
get_video(clip)
