scikit-video 是一个面向科研人员的科学视频处理库，旨在简化视频编解码器与容器格式的复杂性，提供一致的基于 NumPy 的接口，并可与科学 Python 生态无缝集成。
用途
该库适用于以下场景：通过 FFmpeg 读写 MP4、AVI、MKV 等多种格式的视频文件；从长视频中提取特定帧或片段而不必将整个视频载入内存；计算运动估计（块匹配、光流）；测量视频质量（PSNR、SSIM、VIF、NIQE）；生成用于机器学习的视频数据集；可视化像素数据的时间变化（如科学记录）；处理原始 YUV 数据流。
核心原则
视频以四维数组表示
视频被表示为形状为 (T, H, W, C) 的 NumPy 数组：T 为时间（帧数），H 为高度，W 为宽度，C 为通道数（通常 RGB 为 3）。
FFmpeg 后端
scikit-video 本身不包含编解码器，而是作为 FFmpeg 的桥梁。系统必须安装 FFmpeg，skvideo.io 才能正常工作。
面向大数据的生成器
对于长视频，scikit-video 提供基于生成器的读取器（vreader），逐帧处理，避免内存耗尽。
安装与导入
安装命令：pip install scikit-video（注意确保 ffmpeg 在系统 PATH 中）。
标准导入： import skvideo.io import skvideo.motion import skvideo.measure import numpy as np
基本读取与检查
使用 skvideo.io.vread("experiment.mp4") 可将整个视频读入 NumPy 数组，形状为 (frames, height, width, 3)。可通过 video_data.shape 获取帧数、高度、宽度和通道数，并通过索引访问特定帧。
关键规则
建议做法：对大文件使用 vreader 进行基于生成器的读取；若已知所需帧数，设置 num_frames 以避免不必要的扫描；若 FFmpeg 安装在非标准位置，使用 skvideo.setFFmpegPath() 指定路径；为指标计算归一化像素值（通常 uint8 为 [0, 255]）；使用 vwrite 进行简单输出，它会自动处理复杂的 FFmpeg 命令行参数；处理原始传输数据时考虑使用 YUV 读取能力。
应避免：用 vread 加载 4K 视频（一分钟 4K 视频会超出多数内存容量）；忽略 inputdict 和 outputdict（它们可向 FFmpeg 传递比特率、像素格式或编解码器等标志）；假设通道顺序为 RGB（读取后应验证通道顺序，尤其使用外部编解码器时）；未去噪就处理视频（视频噪声会破坏运动估计，应先应用空间或时间滤波器）。
读写（skvideo.io）
高级视频 I/O 支持通过 inputdict 传递 FFmpeg 选项，例如指定起始时间（-ss）和持续时间（-t）；通过 outputdict 指定输出参数，如视频编解码器（-vcodec）、比特率（-b:v）和像素格式（-pix_fmt）。
运动估计（skvideo.motion）
可使用 blockMotion 进行块匹配算法，返回每个块的运动向量，形状为 (H/mbSize, W/mbSize, 2)，最后一维包含 (dy, dx) 偏移。
视频质量评估（skvideo.measure）
可逐帧计算 PSNR、SSIM、MSE 等指标，用于比较原始视频与压缩视频，并输出平均值。
数据集与工具
skvideo.datasets 提供内置示例视频（如 bigbuckbunny()），便于测试。
实用工作流
包括简单背景减除管道（通过中值计算静态背景）、视频稳定（基于运动向量的帧对齐）以及自动化视频质量报告（生成 MSE、PSNR、SSIM 报告）。
性能优化
使用 vreader 配合多线程，采用基于队列的多线程方法保持 FFmpeg 管道满载；高效切片，通过 inputdict 使用 FFmpeg 的 seek 和 duration 标志只读取所需数据。
常见问题与解决方案
FFmpeg 未找到：可通过 skvideo.setFFmpegPath() 手动设置路径。色彩空间不匹配：某些视频存储为 YUV422 或 YUV444，scikit-video 默认转换为 RGB，可在 inputdict 中指定像素格式。内存不足：即使使用 vreader，若将所有帧存入列表仍会耗尽内存，应处理并保存到磁盘或定期清空列表。
参考文档
官方文档：http://www.scikit-video.org/ GitHub：https://github.com/scikit-video/scikit-video 搜索模式：skvideo.io.vread、skvideo.io.FFmpegReader、skvideo.motion、skvideo.measure