****************************************
Motion Classification based Search (MCS)
****************************************

This ZIP contains windows and linux executables of a video coder that implement the paper

"I. Gonzlez-Daz, F. Daz-de-Mara. Adaptive Multipattern Fast Block-Matching Algorithm Based on Motion Classification Techniques. In IEEE Transactions on Circuits and Systems for Video Technology, vol.18, no.10, pp.1369-1382, Oct. 2008"

Each folder (windows, linux) contains three files:

1.- lencod(.exe): the executable of the H.264 coder that embeds the proposed ME algorithm. This executable is based on H.264/AVC Reference Software Encoder (JM10.2 version)

2.- encoder.cfg: configuration file for the encoder (MCS parameters are at the end of the file).

3.- script.sh: script used to run the tests

Additionally, as configured in the script, results are stored in results folder, which is automatically created when running the script.
Each row in the output file corresponds to an execution under a particular set of parameters. The structure of the output is as follows:

Example of the output (three rows, 100 frames and QP varying from 1 to 3)
=========================================================================
100  1  1 64.28 64.85 64.98 3098976 0.00 0.00 0.00     0 58.94 59.15 59.29 15678.61 6.562 0.230 0.668
100  3  3 59.59 59.81 59.86 2853928 0.00 0.00 0.00     0 56.47 56.65 56.77 14255.87 6.560 0.226 0.666
100  5  5 56.20 56.27 56.30 2625328 0.00 0.00 0.00     0 54.14 54.37 54.50 12859.44 6.567 0.225 0.665
========================================================================

Description of the output
=========================

1.- Frame coded 
2.- Initial QP
3.- Final QP (same as initial when coding at constant QP)
4.- INTRA Y SNR
5.- INTRA U SNR
6.- INTRA V SNR
7.- Bits for INTRA frames
8.- Not used (set to 0)
9.- Not used (set to 0)
10.- Not used (set to 0)
11.- Not used (set to 0)
12.- Mean Y PSNR, used in the paper
13.- Mean U PSNR
14.- Mean V PSNR
15.- Mean BitRate in kbps, used in the paper.
16.- Mean Points evaluated in the ME module per local search (as results given in the paper)
17.- Local Search Time per frame in seconds (used in the paper)
18.- Coding time per frame in seconds (used in the paper)		

For additional questions regarding the use of the executables or interpretation of the outputs, please contact to:

Ivn Gonzlez Daz 
igonzalez@tsc.uc3m.es
