Elecard StreamEye Command line tool

With StreamEye command line tool, the complex analysis operations become as fast and easy as a few lines of commands.

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;
• Get access to most of StreamEye functionality and resources through StreamEye Console.

Table of contents

• How to use StreamEye Command line tool
• Notes on the Command line rules
• Sample Config.xml file
• List of commands
• Examples

How to use StreamEye Command line tool:

To streamline automatic analysis of several files the following rules are introduced. They reassign input and output parameters for configuration files.

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:

SEyeConsole.exe <config path> <options>

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.

Notes on the Command line rules

1. Parameters with default value are not required and can be omitted.

2. Rules for input and output file names:

• parameter /in:<file path> in the command line overwrites the value of the tag <input> in the configuration file;
• parameter /out:<file path> in the command line overwrites the value of the tag <output> in the configuration file;
• if <output> tag is missing (or not specified), output file names are formed from input file names plus suffix (if the latter is specified);
• if output file for a tag/section is not specified, the output file name for the tag/section is formed from the name specified in the <output/> tag plus suffix depeding on the name of the tag/section, e.g. ".message.csv", ".header.csv", etc.

Back to table of contents

Sample Config.xml file:

<?xml version="1.0"?>
<stream version="1">
    <input HEVCDecoder="Elecard(default)/Reference" SkipIncomplete="true(default)/false" file="…"/>
    <output separator=".(default)/," delimiter=";(default)/," file="…"/>
    <reference type="IYUV(default)/[*Upsampler Type]" filter="None(default)/FieldGen/Median/Sobel" offset="0(default)" increment="1(default)" file="…"/>
    <range span="all(default)/start - stop" order="display(default)" indexmode="base/extended(default)"/>
    <userdefs framerate="25(default)" timeperiod="1(default)"/>
    <info>
        <stream distribution="on(default)/off" file="…"/>
        <picture distribution="on(default)/off" file="…">
            <condition … />
        </picture>
        <data type="decoded(default)/predicted/unfiltered/residual/reference/difference" file="…"/>
        <coefficients type="transform/dequantized" file="…"/>
        <message level="all(default)/message/warning/error" file="…"/>
        <header level="struct(default)/parameter" file="…">
            <condition parameter="name" comparison="full/substring(default)">
                <range value="min-max"/>
                <equal value="value"/>
                <less value="min"/>
                <more value="max"/>
                <not value="value"/>
            </condition>
        </header>
        <index distribution="on(default)/off" order="display(default)/stream" file="…"/>
        <metrics type="psnr(default)/[*Metric Type]" source="decoded(default)/predicted/unfiltered/residual/reference/difference" file="…"/>
        <difference type="compare/psnr/psnr clip/subtraction/temperature" source0="decoded(default)/predicted/unfiltered/residual/reference" source1="reference(default)/decoded/predicted/unfiltered/residual" format="IYUV(default)/YV12" file="…"/> 
        <buffer file="…"/>
        <block compact="false(default)/true" disable="block|subblock|prediction|transform" file="…"/>
        <dpb description="on(default)/off" file="…"/>
        <statistics mode="all(default)/stream/picture" type="all(default)/[*Statistic Type]" prediction="all(default)/sizes/mpe" component="all(default)/luma/chroma" by="all(default)/count/area" file="…"/> 
    </info>
</stream>

<stream>
    <input file="…"/>
    <output separator=";(default)/," delimiter=".(default)/," file="…"/>
    <info>
        <stream distribution="on(default)/off" file="…"/>
    </info>
</stream>

* Upsampler types that can be used in a configuration file: I444, I422, IYUV, NV12, NV21, P444, RGB24, RGB32, UYVY (Y422, UYNV, HDYC), V210, V400, V444, Y42B, YUY2 (YUNV, V422, YUYV), YV12, YV16, YVYU, Y4M.

Back to table of contents

List of commands:

Back to table of contents

Examples

These examples show how to perform some of the typical tasks from the command-line:

1. Saving the general information on the stream and on each picture;
2. Retrieving information on the number of IDR_W_RADL slices and offsets;
3. Searching for all slices with the slice_type value equal to "2";
4. Saving YUV data on the prediction step;
5. Saving the block info data of the picture;
6. Retrieving information on frame sizes and PSNR values for the first 10 frames.

1. Saving the general information on the stream and on each picture

config.xml:

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <stream/> 
            <picture/> 
      </info> 
      </stream>

Output files:

test_12_0_sei.stream.csv:

 ...
test_12_0_sei.stream.csv:

Back to list of examples

2. Retrieving information on the number of IDR_W_RADL slices and offsets

config.xml:

<?xml version="1.0"?>
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <header level="parameter"> 
                  <condition parameter="IDR_W_RADL" comparison="substring"/>
            </header>  
      </info> 
</stream> 

Output file: 

test_12_0_sei.header.csv:

Back to list of examples

3. Searching for all slices with the slice_type value equal to "2"

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\test_12_0_sei"/> 
      <info> 
            <header> 
                  <condition parameter="slice_type">  
                        <equal value="2"/> 
                  </condition> 
            </header> 
      </info> 
</stream>

Output file:

test_12_0_sei.header.csv: 

Back to list of examples

4. Saving YUV data on the prediction step

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <data type="predicted"/> 
      </info> 
</stream>

Output file:

test_12_0_sei.data.416x240.yuv

Back to list of examples

5. Saving the block info data of the picture

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <block/> 
      </info> 
</stream>

Output file:

test_12_0_sei.block10.csv  

Back to list of examples

6. Retrieving information on frame sizes and PSNR values for the first 10 frames.

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/>
      <reference file="C:\Media\raw\BasketballDrill_832x480_50.yuv"/> 
      <range span="0-10"/> 
      <info> 
            <metrics type="psnr"/>
            <index distribution="off" order="display"/>
      </info> 
</stream>

Output file:

test_12_0_sei.index.csv: 

Back to list of examples

Back to table of contents