JSVM9-19-13

############################################################################### # Copyright 2006 -- Thomson R&D France Snc # Technology - Corporate Research ############################################################################### # File : README.TXT # Author : jerome.vieron@thomson.net # Creation date : 25 January 2006 # Version : 1.0.0 ################################################################################ The current directory contains the following sub-directories: ============================================================= SimuDataBase : contains the "Simulations" data base (i.e. tests set) to be run for the evaluation phase Tools : perl scripts and tools. SimuRun : location where the "Simulations" will be run. (if not present, will be automatically created) PacketLossSimulator : contains the source code of a packet loss simulator tool to be used when running the Short-term simulations set. 422_to_420fullres : contains the source code of the SD 422 to 420 conversion tools proposed in [VCEG-059]. This tool has to be used for certain validation tests related to Interlaced material. [orig] : contains the original YUV sequences (typically the 4CIF sequences) [OPTIONAL] NOTE: The location of this directory (including its name) can be specified. [bin] : contains the binaries of the encoder,decoder,extractor,downconvert and psnr tools;[OPTIONAL] NOTE : The location of this directory (including its name) can be specified. IMPORTANT NOTES: ================- 1)Before running the Short_term and Long_term tests sets, the user will have to download YUV sequences available at ftp.tnt.uni-hannover.de/pub/svc/testsequences/. The required sequences are the following: Short_term: BUS_352x288_30.yuv, MOBILE_352x288_30.yuv, FOOTBALL_352x288_30.yuv and, CREW_704x576_60.yuv. Long_term: CREW_704x576_30.yuv and, CREW_704x576_60.yuv. In order to run the "Interlaced" validation scripts CFG1_P2I, CFG4_I2I, LCFG1_P2I, and, LCFG4_I2I, the user will have to download the SD sequence called src5_ref__625.yuv available at ftp://vqeg.its.bldrdoc.gov/SDTV/VQEG_PhaseI/TestSequences/ALL_625/. This sequence is in 4:2:2 format. Conversion to 4:2:0 format shall be made using the conversion tool 422_to_420fullres using the p option as following: > 422_to_420perl.exe p src5_ref__625.yuv CANOA_720x576_25i.yuv The resulting CANOA_720x576_25i.yuv will then be used for the Interlaced validation scripts (in both Short_term and Long_term tests sets). All these yuv sequences will be placed in the "orig" directory. 2) The "bin" directory must contain the following executables - DownConvertStatic - H264AVCDecoderLibTestStatic - H264AVCEncoderLibTestStatic - BitStreamExtractorStatic - PSNRStatic - QualityLevelAssignerStatic - PacketLossSimulatorStatic 3) Before running AVC_Conformance simulation set, please read the README.TXT files located in the SimuDataBase/AVC_Conformance/ directory. You will have to download the conformance bistreams and YUV sequences available at "http://ftp3.itu.ch/av-arch/jvt-site/draft_conformance/". The numbering of the conformance tests corresponds to the classification of the conformance bit-streams in the ITU-T Recommendation H.264.1 "Conformance specification for H.264 advanced video coding". So far, only tests "6.6.1, 6.6.2, 6.6.5, 6.6.6, 6.6.7, 6.6.11, 6.6.18, 6.6.19, 6.6.20 and, Hierarchical" must be run. Please again, read the instructions... It contains also the file: ========================== "run.pm" which is the main Perl script to be run in order to validate/evaluate JSVM perfomances (mainly after integration phase). --------- Usage: ------ [-SimusetName [ <SimuName1>...<SimuNameN>] ] : to specify that the simulations set called ""SimusetName" must be run (default value: Short_term) : "SimusetName" must be the name of a sub-directory of the SimuDataBase directory NOTE 0: You can specify the name of the "Simulations" you want to run inside a given simulations-set by specifying <SimuName1>...<SimuNameN>. NOTE 1: You can just specify a prefix of the "name_simuset" set. [-bin <bin_directory>] :to specify the bin directory location (default value: ./bin) [-seq <orig_directory>] :to specify the orig directory location (default value: ./orig) [-v] : Version number; [-u ] : Usage; The run.pm script works as following: ==================================== - Building of the work directory: -------------------------------- A dedicated directory (with the Name of the considered simulation) will be created in the SimuRun directory. All the data related to this simulation (located in the DataBase directory) will be copy in these new directory. - Reference sequences generation: --------------------------------- Using ONE original "High Dimension" YUV sequence as input, the DownConvertStatic tools is used to generate the reference sequences of each layer. NOTE: if the sequences are already built, this creation will not be done. - Encoding process: ------------------- This part can be set to OFF depending on the kind of Simulation you want to run. If required, a step of so-called "quality layer assignment" will be applied. - TESTS processes: ----------------- For each test: -Extracting and/or Decoding -Check results (if required) A GLOBAL log file will be created at the root of the "SimuRun" directory. A LOCAL log file (detailed) will be created at the root of the "SimuRun" directory. NOTE CLEANING PROCESS =========================== -At the beginning of a Simulation run, if the "SimuRun/SimulationName" directory exists it will be removed. Except if the encoding process is set to OFF.