gfdavila/easyvmaf

easyVmaf镜像说明

镜像概述

本Docker镜像基于FFmpeg和libvmaf构建，集成easyVmaf工具，可自动完成视频预处理（去隔行、缩放、帧同步等）并计算VMAF视频质量评估分数，适用于视频质量分析场景。

核心功能

• 自动去隔行：检测并处理参考或失真视频的隔行扫描问题
• 自动缩放：根据VMAF模型自动将视频缩放到1080p/4K分辨率
• 帧同步：通过PSNR帧匹配实现参考与失真视频的自动同步
• 帧率适配：调整视频帧率以满足计算要求
• VMAF计算：支持HD/4K等模型，输出JSON/XML格式的质量分数

使用场景

• 视频编码质量评估：对比不同编码参数下的视频质量差异
• 转码优化：指导转码参数调整以平衡质量与文件大小
• 视频修复验证：评估修复后视频与原始视频的质量一致性
• 流媒体质量监控：定期检测平台视频的播放质量

配置说明

必填参数

• -d D：指定失真视频文件路径
• -r R：指定参考视频文件路径

可选参数

• -sw SW：同步窗口大小（秒），用于帧同步查找
• -ss SS：同步起始时间（秒），从参考视频开始计算同步窗口位置
• -subsample N：帧采样间隔（默认1，加快计算速度）
• -reverse：反转同步方向（默认禁用）
• -model MODEL：VMAF模型（HD/HDneg*/4K，默认HD）
• -phone：启用手机模型（仅HD，默认禁用）
• -threads THREADS：计算线程数
• -verbose：启用详细日志（默认info级别）
• -progress：显示计算进度（默认false）
• -output_fmt OUTPUT_FMT：输出格式（json/xml，默认json）

Docker部署示例

1. 处理本地视频文件（挂载目录）

bash
docker run --rm -v /本地视频目录:/data gfdavila/easyvmaf -r /data/参考视频.mp4 -d /data/失真视频.mp4

2. 使用镜像内示例视频

bash
docker run --rm gfdavila/easyvmaf -r video_samples/BBB_reference_10s.mp4 -d video_samples/BBB_sampleA_distorted.mp4 -sw 1 -ss 1

3. 反转同步方向示例

bash
docker run --rm gfdavila/easyvmaf -r video_samples/BBB_sampleA_distorted.mp4 -d video_samples/BBB_sampleB_distorted.mp4 -sw 2 -ss 0 -reverse

注：HDneg模型暂不支持FFmpeg，当前无法使用-model HDneg参数。