codec_compare

A small framework for comparing metrics for still image codecs. The framework is portable, and runs inside a Docker container. The Dockerfile includes 4 anchor codecs (jpeg, kakadu, webp, hevc) and encoding/decoding scripts for each codec. By default, the framework encodes 7 BPP targets per encoder (0.12, 0.25, 0.50, 0.75, 1.00, 1.50, 2.00) and two colorspaces (RGB and YUV420). The encode and decode for each codec is handled by small scripts placed in the ./encode and ./decode directories. The anchor codec scripts are written in Python, but you could use any language you'd like. Each script is called by the framework with the following command-line arguments:

Encode args:

image_src  = sys.argv[1]
image_out  = sys.argv[2]
bpp_target = sys.argv[3]
width      = sys.argv[4]
height     = sys.argv[5]
pix_fmt    = sys.argv[6] #either yuv420p or ppm
depth      = sys.argv[7] 

Decode args:

image_src  = sys.argv[1]
image_out  = sys.argv[2]
width      = sys.argv[3]
height     = sys.argv[4]
pix_fmt    = sys.argv[5] #either yuv420p or ppm 

Source images:

Place your source images in ./images.

To add another codec:

Update the Dockerfile to include your binaries. Add an encode and decode script in ./encode and ./decode.

To build container:

docker build -t codec_compare .

To run container:

docker run -it -v $(pwd):/codec_compare codec_compare

To encode, decode, calculate metrics:

./compare.py

To generate graphs:

./visualize.py ./metrics/*.json