This is part of MSU Video Quality Measurement tool Online Help for MSU VQMT 14.1

MSU Video Quality Measurement Tool (MSU VQMT) project:

• Main MSU VQMT page on compression.ru
• Download & Purchase on compression.ru
• Basic information
• Online help
• Metrics reference
• Version history & Changelog

Online help for MSU VQMT 14.1 contents:

• Command-line help
• VQMT various lists and tables
• Usage of VQMT metrics in CLI
• Picture types
• Configuration description
• PDF Documenation
• List of documentation pages for all versions

Content

• Content
  • List of color standards
  • List of available devices
  • List of open modes
  • Visualization methods

List of color standards

BT.2020

BT.2020
PU encoding BT.2020: L 0..514.985;
RGB BT.2020: R 0..1, G 0..1, B 0..1;
RGB BT.2020 Quantized: R 0..1, G 0..1, B 0..1;
RGB BT.2020 linear: R 0..1, G 0..1, B 0..1; r: (0.708,0.292), g: (0.17,0.797), b: (0.131,0.046)
YUV BT.2020: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.2627, wb: 0.0593
YUV BT.2020 Quantized: Y 0..1, U 0..1, V 0..1;
YUV BT.2020 linear: Y 0..1, U -0.5..0.5, V -0.5..0.5;

BT.2020PC

BT.2020 PC range
PU encoding BT.2020: L 0..514.985;
RGB BT.2020: R 0..1, G 0..1, B 0..1;
RGB BT.2020 Quantized PC: R 0..1, G 0..1, B 0..1;
RGB BT.2020 linear: R 0..1, G 0..1, B 0..1; r: (0.708,0.292), g: (0.17,0.797), b: (0.131,0.046)
YUV BT.2020: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.2627, wb: 0.0593
YUV BT.2020 Quantized PC: Y 0..1, U 0..1, V 0..1;
YUV BT.2020 linear: Y 0..1, U -0.5..0.5, V -0.5..0.5;

BT.601

BT.601
RGB BT.601: R 0..1, G 0..1, B 0..1;
RGB BT.601 Quantized: R 0..1, G 0..1, B 0..1;
RGB BT.601 linear: R 0..1, G 0..1, B 0..1; r: (0.64,0.33), g: (0.29,0.6), b: (0.15,0.06)
YUV BT.601: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.299, wb: 0.114
YUV BT.601 Quantized: Y 0..1, U 0..1, V 0..1;

BT.601PC

BT.601 PC range
RGB BT.601: R 0..1, G 0..1, B 0..1;
RGB BT.601 Quantized PC: R 0..1, G 0..1, B 0..1;
RGB BT.601 linear: R 0..1, G 0..1, B 0..1; r: (0.64,0.33), g: (0.29,0.6), b: (0.15,0.06)
YUV BT.601: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.299, wb: 0.114
YUV BT.601 Quantized PC: Y 0..1, U 0..1, V 0..1;

BT.709

BT.709
PU encoding BT.709: L 0..514.985;
RGB BT.709: R 0..1, G 0..1, B 0..1;
RGB BT.709 Quantized: R 0..1, G 0..1, B 0..1;
YUV BT.709: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.2126, wb: 0.0722
YUV BT.709 Quantized: Y 0..1, U 0..1, V 0..1;
YUV BT.709 linear: Y 0..1, U -0.5..0.5, V -0.5..0.5;
sRGB/BT.709 linear: R 0..1, G 0..1, B 0..1; r: (0.64,0.33), g: (0.3,0.6), b: (0.15,0.06)

BT.709PC

BT.709 PC range
PU encoding BT.709: L 0..514.985;
RGB BT.709: R 0..1, G 0..1, B 0..1;
RGB BT.709 Quantized PC: R 0..1, G 0..1, B 0..1;
YUV BT.709: Y 0..1, U -0.5..0.5, V -0.5..0.5; wr: 0.2126, wb: 0.0722
YUV BT.709 Quantized PC: Y 0..1, U 0..1, V 0..1;
YUV BT.709 linear: Y 0..1, U -0.5..0.5, V -0.5..0.5;
sRGB/BT.709 linear: R 0..1, G 0..1, B 0..1; r: (0.64,0.33), g: (0.3,0.6), b: (0.15,0.06)

List of available devices

-dev CPU

CPU (recommended)

-dev CUDA

CUDA (recommended)

-dev OpenCL0

NVIDIA CUDA/GeForce GTX 660 Ti

List of open modes

auto

Auto (quick opening video, raw and images)
This mode will automatically choose an open mode, based on input file extension, etc. If fail, it will try multiple modes.

ffmpeg_new

FFmpegNew
Use this mode for opening any media containers (AVI, MOV, MP4, etc.), raw streams, and other video files. Supports a lot of codecs and formats.
Supported properties: any properties of decoder, transmitted directly to FFmpeg.

ffmpeg2.7

FFmpeg2.7
Legacy FFmpeg opening mode. It is better to use the modern FFmpeg implementation.

avifile

AviFile (*.avi and *.avs)
Use this mode on Windows to open AVI or AVS files.
NOTE: for AVI and other video containers FFmpeg is preferable mode!

avisynth

AviSynth (do not use for *.avs)
Use this mode for opening video files, not AviSynth. VQMT will automatically create AviSynth script for opening a file you specified.

avs_AviFileSource

AviSynth (AviFileSource)
Use this mode for opening video files, not AviSynth. VQMT will automatically create AviSynth script for opening a file you specified.

avs_AviSource

AviSynth (AviSource)
Use this mode for opening video files, not AviSynth. VQMT will automatically create AviSynth script for opening a file you specified.

avs_DirectShowSource

AviSynth (DirectShowSource)
Use this mode for opening video files, not AviSynth. VQMT will automatically create AviSynth script for opening a file you specified.

avs_OpenDMLSource

AviSynth (OpenDMLSource)
Use this mode for opening video files, not AviSynth. VQMT will automatically create AviSynth script for opening a file you specified.

y4m

Y4M file
Use this mode for opening yuv4mpeg files. Auto mode is also can be used.

raw

YUV raw file
Use for opening RAW files. You should specify resolution and picture type.
Example of command-line:
vqmt -orig source.yuv 1920x1080 yuv420p -in processed.yuv psnr
Supported properties:

• w – width.
• h – height.
• fmt – picture type. See the list of Picture types

sequence

Image sequence
Use single image or image sequence as frame source for VQMT. To specify image sequence, place %d to a filename. For using % sign in a filename place %%. VQMT will find a first number that could be substituted instead of %d and will consider it as the first frame. You also can use %0Nd to fill zeroes, for example %03d if frame numbers has a form 001, 002, etc.

pipe

Pipe
Use pipe mode to redirect output of custom shell-command to VQMT for using as YUV or Y4M file source. If the command writes to a file, you can use it as well without creating an intermediate file. To use this feature, specify %s instead of output file name of command.
By default, output is considered to be Y4M. If you want to read raw data, specify resolution and picture type.

Example 1. Using ffmpeg which output to STDOUT with Y4M output:
vqmt -in “ffmpeg -i source.avi -f yuv4mpegpipe -pix_fmt yuv444p pipe:” pipe -in “ffmpeg -i distorted.avi -f yuv4mpegpipe -pix_fmt yuv444p pipe:” pipe -metr psnr

Example 2. Using ffmpeg which output to a file with Y4M output:
vqmt -in “ffmpeg -i source.avi -f yuv4mpegpipe -pix_fmt yuv444p %s” pipe -in “ffmpeg -i distorted.avi -f yuv4mpegpipe -pix_fmt yuv444p %s” pipe -metr psnr

Example 3. Using ffmpeg which output to a file with YUV output:
vqmt -in “ffmpeg -i source.avi -f rawvideo -pix_fmt yuv444p %s” pipe 1920x1080 yuv444p -in “ffmpeg -i distorted.avi -f rawvideo -pix_fmt yuv444p %s” pipe 1920x1080 yuv444p -metr psnr
End of examples.

If you want to suppress command STDOUT or STDERR printing, add >/dev/null or 2>/dev/null to the end of command. On windows use nul instead of /dev/null/.
The program could report broken pipes. It is a normal situation if VQMT stops reading frames.
Sometimes on Linux, the command invoked by VQMT can change TTY settings. To restore them add stty echo after VQMT command.

Supported properties: use the properties of raw mode to open as YUV. Else the input will be considered as Y4M.

NOTE: If the program did not start writing the specified output, VQMT can hang. The only way to stop waiting, in this case, is by killing VQMT.

callback

Get frames via user provided callback
Provide callback for getting raw image in VQMT wrapper - for example Python wrapper.
See also examples of usage VQMT in Python
Supported properties:

• w – width.
• h – height.
• fmt – picture type. See the list of Picture types
• allow_seek – false if the callback does not support getting an arbitrary frame
• frames – total number of frames can be obtained via callback

Visualization methods

h264

Lossy video (H264)
Usage: -vis-type h264

• -vis-type h264 -vis-preset lq (small file)
• -vis-type h264 -vis-preset mq (middle quality, default)
• -vis-type h264 -vis-preset hq (max quality)

png

Lossless images (PNG)
Usage: -vis-type png

• -vis-type png -vis-preset (default, default)
• -vis-type png -vis-preset max-speed (max speed)
• -vis-type png -vis-preset max-compr (max compression)
• -vis-type png -vis-preset no-compr (no compression)

tiff

Lossless images (TIFF)
Usage: -vis-type tiff

jpeg

Lossy images (JPEG)
Usage: -vis-type jpeg

• -vis-type jpeg -vis-preset lowq (bad quality)
• -vis-type jpeg -vis-preset avgq (average quality)
• -vis-type jpeg -vis-preset normq (normal quality)
• -vis-type jpeg -vis-preset goodq (good quality, default)
• -vis-type jpeg -vis-preset superbq (superb qualirt)

windows

Windows method
Usage: -vis-type windows

bmp

Lossless images (BMP)
Usage: -vis-type bmp

This page is automatically generated by 14.1 r12839 on 2022-06-24. In case of any question or suggestion, please mail us: video-measure@compression.ru