Elecard Video Quality Estimator Command line tool

Elecard Video Quality Estimator Command line tool

April 19, 2018
Features 4 134 views

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

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.exe config.xml /in1:input.avc /out:output/input_avc /ref:ref_input.yuv

Note: you should not relocate the <product> console without all the other applications of the product contained in the installation pack, otherwise the console application will not start.

/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">
    <inputA file="…" stream="-1(default)" offset="0(default)"/>
    <inputB file="…" stream="-1(default)" offset="0(default)"/>
    <reference file="" type="IYUV(default)/[*Upsampler Type]" 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)" source="AB/ARaw/BRaw"/>
    <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|BRaw" nativeChroma="Yes(default)/No" component="All(default)|Y|U|V|A" type="PSNR(default)|APSNR|SSIM|… " file="…"/>
        <data source="A|B" format="IYUV(default)/YV12" file="…"/>
        <difference type="compare/subtraction/temperature/psnr/psnr clip" source="AB/ARaw/BRaw" format="IYUV(default)/YV12" file="…"/>
        <message source="A|B" level="all(default)/message/warning/error" file="…"/>    
    </info>
</VQ>

Back to table of contents



List of commands:

<input1/>
<input2/>
The tag is used to configure the input file
 Note: if the VMAF and VMAF phone metrics are enabled, and if input raw file is missing, encoded reference file should be placed in the input 2(B) field.
streamSpecifies the elementary video stream number, if number of streams exceeds one.
«-1» — first available elementary video stream. It is set by default.
offsetShifts the position from the first analyzed frame to the specified one in a stream
<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
offsetShifts the position from the first analyzed frame to the specified one in a reference stream. “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
separatorAllows selecting decimal comma or decimal dot to separate an integer part from a fractional one of a real number
delimiterAllows selecting comma or semicolon to specify boundaries in data stream
fileSets the output file path
<roi/> Region of interest selected for measurement
normalMeasures the specified field of the frame
inverseMeasures the whole frame field except the specified part
<sync/> Specifies the frames range for auto synchronization mode. “0” is set by default
<range/> The tag is used to define the range of analyzed frames
spanDefines the range of frames (all(by defalult) /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)|APSNR|SSIM|DELTA|MSAD|MSE|VQM|NQI|VIF|VMAF|VMAF phone
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 EstimatorStreamEye Studio
Category:Features

Feedback

More questions?

Chat nowAsk a question