# Readme of MCML 4K UHD Quality Database

# Guide to decode bitstreams (AVC / HEVC / VP9) and upscale decoded videos

1. Decoding
You can decode encoded bitstreams using ffmpeg.

>> ffmpeg -i bitstream.264 decoded.yuv
>> ffmpeg -i bitstream.bin decoded.yuv
>> ffempg -i bitstream.webm decoded.yuv


	1-1. AVC
	We encoded video sequences with AVC codec using JM reference software version 18.5.
	We decoded .264 bitstreams using JM software and upscaled the decoded FHD videos to UHD resolution using ffmpeg.
	You can decode .264 file using ldecod.exe from JM software. (We tested this script on Windows environment.)

	>> ldecod.exe -i bitstream.264 -o decoded.yuv

	The attached zip file (decode.zip) includes executive file (ldecod.exe) of the JM18.5.
	You can use this .exe file, but we recommend to use regular version of the software.


	1-2. HEVC
	We encoded video sequences with HEVC codec using HM reference software version 10.0.
	We decoded .bin bitstreams using HM software and upscaled the decoded FHD videos to UHD resolution using ffmpeg.
	You can decode .bin file using TAppDecoder.exe from HM software. (We tested this script on Windows environment.)

	>> TAppDecoder.exe -b bitstream.bin -o decoded.yuv

	The attached zip file (decode.zip) includes executive file (TAppDecoder.exe) of the HM10.0.
	You can use this .exe file, but we recommend to use regular version of the software.


	1-3. VP9
	We encoded video sequences with VP9 codec using libvpx software version 1.3.0.
	We decoded .webm bitstreams using libvpx software and upscaled the decoded FHD videos to UHD resolution using ffmpeg.
	You can decode .webm file using vpxdec from libvpx software on Linux environment. (But we do not test this scipt again in Nov. 2018.)

	>> ./libvpx/vpxdec --progress --codec=vp9 --i420 -o decoded.yuv bitstream.webm


2. Up-scaling 
You can up-scale the decoded FHD videos to UHD resolution using ffmpeg.

>> ffmpeg.exe -s hd1080 -r 30 -i docoded.yuv -vcodec rawvideo -sws_flags lanczos -s 3840x2160 -r 30 upscaled.yuv