Video Quality Metrics Report

Within a <metrics_report> job request, the source asset is used as a reference file to quantitatively compare VQ using 4 industry-standard perceptual quality tools VMAF, PSNR, SSIM, and MS_SSIM for each output format. Comparing the report metrics of outputs with different codecs or encoding parameters can be an invaluable tool to help improve the playback experience. The output of this job request is an HTML report that includes comparative tables and charts for reference and analysis. Example VQ Metric Report

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required -->
    <userkey>[UserKey]</userkey> <!-- required -->
    <action>AddMedia</action> <!-- required -->
    <source>[SourceURL]</source> <!-- required -->
    <metrics_report>
        <metrics>vmaf</metrics>
        <metrics>psnr</metrics>
        <metrics>ssim</metrics>
        <metrics>ms_ssim</metrics>
        <metrics>bitrate</metrics>
        <destination>[MetricsReportDestinationDir]</destination>
    </metrics_report>
    <format>
        <output>[OutputFormat]</output> <!-- required -->
        <metrics_report_sample_name>[SampleName]</metrics_report_sample_name>
        <!-- Format params -->
    </format>
    <format>
        <output>[OutputFormat]</output> <!-- required -->
        <metrics_report_sample_name>[SampleName]</metrics_report_sample_name>
        <!-- Format params -->
    </format>
</query>
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "AddMedia", // required
        "source": "[SourceURL]", // required
        "metrics_report": {
            "metrics": [
                "vmaf",
                "psnr",
                "ssim",
                "ms_ssim",
                "bitrate"
            ],
            "destination": "[MetricsReportDestinationDir]"
        },
        "format": [
            {
                "output": "[OutputFormat]", // required
                "metrics_report_sample_name": "[SampleName]"
                // Format params
            },
            {
                "output": "[OutputFormat]", // required
                "metrics_report_sample_name": "[SampleName]"
                // Format params
            }
        ]
    }
} 

Metrics report parameters

ParameterDescriptionAllowed Values
metricsArray of metrics namesvmaf – Video Multimethod Assessment Fusion
psnr – Peak signal-to-noise ratio
ssim – Structural similarity
ms_ssim – Multiscale structural similarity
bitrate
destinationDirectory where we will upload metrics reportsValid Directory URL

🚧

For destination

The <destination /> parameter value has to be a directory because we upload multiple files to this destination.

Format parameters

ParameterDescriptionAllowed Values
metrics_report_sample_nameOutput sample name in the reportString