Elecard Video Quality Estimator Command line tool

Features 313 views October 17, 2017

Elecard Video Quality Estimator functionality is available in console version, so you can run the tool from the command line.

Video Quality Estimator Command Line tool allows automatic analysis of video arrays. You can customize a sequence of commands to perform your specific tasks and automate your routine tasks.

Using this tool you'll be able to: 

  • Analyze the whole array of video files automatically;
  • Address specific and complex challenges with a few lines of commands;
  • Retrieve submitted results as a text file in CSV format for easy viewing in Excel;
  • Customize a sequence of commands to perform your specific tasks;
  • Accelerate and automate your regular tasks;

Table of contents

How to use Video Quality Estimator Command line tool

Sample Config.xml file

List of commands

 


How to use Video Quality Estimator Command line tool

Get to the command prompt by clicking Start->Run and type 'cmd'. Then enter the command to start the application first and proceed with the command line options. In general, the syntax is as follows:

 VQConsole config.xml /in1:input.avc /out:output/input_avc /ref:ref_input.yuv
/in1:<path>first input file path
/in2:<path>second input file path
/ref:<path>reference file path
/out:<path>output files prefix
/sfx:<path>suffix of all output files in the config
/dcuse current run directory as default path for files
/?advanced help

Back to table of contents


 

Sample Config.xml file:

<?xml version="1.0"?>
<VQ version="1">
    <input1 file="..." stream="-1(default)" offset="0(default)"/>
    <input2 file="..." stream="-1(default)" offset="0(default)"/>
    <reference file="..." type="YV12(default)" offset="0(default)" step="1(default)"/>
    <output separator=";(default)/," delimiter=".(default)/," file="..."/>
    <roi x="0" y="0" width="0" height="0" inverse="true\false"/>
    <sync window="0(default)">
    <range span="all(default)/start - stop"/>
    <info> 
        <stream distribution="on(default)/off" file="..."/>
        <index distribution="on(default)/off" file="..."/>
        <metrics data="All(default)|AB|ARaw|..." type="PSNR(default)|SSIM|..."file="..."/>
        <data source="A/B/AB" format="iyuv(default)" file="..."/>
        <difference type="compare/subtraction/temperature/psnr/psnr clip" source="AB" file="..."/>    
    </info>
</VQ>

Back to table of contents



List of commands:
 

<input1/>
<input2/>
The tag is used to configure the input file
streamSpecifies the elementary video stream number, if number of streams exceeds one.
«-1» — first available elementary video stream. It is set by default.
offsetStarting frame for further calculation. Offset from the beginning up to the specified frame in the stream. It is expressed in frames.
<reference/>The tag is used to configure the reference file
typeDefines the format of the raw data. (YV12 (is set by default) / IYUV are used now. More formats to be supported in the next updates.)
fileSets the path to the reference file
offsetOffset from the beginning up to the specified frame in a reference stream. It is expressed in frames. “0” is set by default
stepCoefficient used for calculation of a successive frame number for further analysis. “1” is set by default
<output/> The tag is used to configure the output file
separatorDefines the symbol/string to separate the output data, the “.” sign is set by default
fileSets the output file path
<roi/>Region of interest selected for measurement
xSets the initial x-coordinate of the field for measurement
ySets the initial y-coordinate of the  field
widthSpecify the width of the field
heightSpecify the height of the field
inversetrue: Measures the whole frame field except the specified part
false: Measures the specified field of the frame; (default)
<sync/> Specifies the frames range for auto synchronization mode. “0” is set by default
windowSets the number of frames from the beginning of the stream to be scanned
<range/> The tag is used to define the range of analyzed frames
spanDefines the range of frames (all (by default) /start - stop), 'start' - number of the first analyzed frame, 'stop' - number of the last analyzed frame
<stream/> The tag is used to output general information about the analyzed stream
distributionContains information on data distribution by type of coding units (on (by default) / off)
fileSets the path for the output stream information
<index/> The tag is used to output information about frames (offset, frame type, frame size, average quantizer, etc.)
distributionContains information on data distribution by type of coding units (on (by default) / off)
fileSets the output file path where information on frames will be saved
<metrics/> The tag is used to output information on quality metrics
dataSpecifies the type of the streams selected for metrics calculation and saving: All (by default) | AB | ARaw | BRaw
typeSpecifies the metric type: PSNR (by default) | ssim | delta | msad | mse | VQM
fileSets the output file path where information on metrics will be saved
<data/> The tag is used to save output decoder information on any decoding step
sourceDefines the type of the source for metrics calculation: A | B | Raw
formatDefines the format for saving data (IYUV (by default))
fileSets the output file path where the data will be saved
<difference/> The tag is used to output information on difference metrics
typeDefines the type of difference (compare/subtraction/temperature/psnr/psnr clip). This is the required parameter for this tag. Its default value should be set. If the value is not set, this tag will be skipped
sourceSpecifies the source type for difference calculation: AB | ARaw | BRaw
fileSets the output file path where information on difference will be saved

Back to table of contents

Resources

On the topic

Product:Video Quality Estimator
Category:Features

Feedback

More questions?

Chat nowAsk a question