DSSIM C implementation (with a Rust API)
C Rust Objective-C Makefile Shell
Latest commit 0eee617 Nov 16, 2016 @pornel committed on GitHub Merge pull request #35 from wcgallego/master
Some clean up of main.c
Permalink
Failed to load latest commit information.
debian added debian package files Mar 20, 2015
rhel Show more digits Mar 25, 2016
src Some clean up Nov 16, 2016
.gitignore A basic Rust API Aug 7, 2015
Cargo.toml Updated Rust API Jun 26, 2016
LICENSE Relicensing Jan 26, 2015
Makefile Adding USE_LIBJPEG flag for quick jpeg support Feb 22, 2016
README.md
build-debian.sh Rename Jun 15, 2015
meson.build meson: Modernize meson build definition Nov 16, 2016
publish_to_ppa.sh added debian package files Mar 20, 2015

README.md

RGBA Structural Similarity

This tool computes (dis)similarity between two or more PNG images using an algorithm approximating human vision.

Comparison is done using the SSIM algorithm (based on Rabah Mehdi's implementation) at multiple weighed resolutions.

The value returned is 1/SSIM-1, where 0 means identical image, and >0 (unbounded) is amount of difference. Values are not directly comparable with other tools. See below on interpreting the values.

Features

  • Comparison is done in in L*a*b* color space (D65 white point, sRGB gamma) with chroma subsampling. Other implementations use "RGB" or grayscale without gamma correction.
  • Supports alpha channel.
  • Only needs C (C99) and libpng or Cocoa on OS X. No OpenCV or MATLAB needed.

Usage

dssim file-original.png file-modified.png

Will output something like "0.02341" (smaller is better) followed by a filename.

You can supply multiple filenames to compare them all with the first file:

dssim file.png modified1.png modified2.png modified3.png

You can save an image visualising the difference between the files:

dssim -o difference.png file.png file-modified.png

The dssim.c file is also usable as a C library.

Interpreting the values

The amount of difference goes from 0 to infinity. It's not a percentage.

If you're comparing two different image compression codecs, then ensure you either:

  • compress images to the same file size, and then use DSSIM to compare which one is closests to the original, or
  • compress images to the same DSSIM value, and compare file sizes to see how much file size gain each option gives.

More about benchmarking image compression.

Build or Download

You need libpng, zlib, pkg-config and make

make

Will give you dssim. On OS X make USE_COCOA=1 will compile without libpng.

You'll find downloads on GitHub releases page.

Debian packages for i386/amd64 can be installed for ubuntu (14.04 LTS) from ppa:

$ sudo apt-add-repository ppa:lkwg82/dssim
$ sudo apt-get update
$ sudo apt-get install dssim

(other versions on request)

Plain download from here: https://launchpad.net/~lkwg82/+archive/ubuntu/dssim/+packages

Accuracy

Scores for version 1.3 measured against TID2008 database:

TID2008 Category Spearman correlation
Noise -0.872
Noise2 -0.888
Safe -0.889
Hard -0.903
Simple -0.922
Exotic -0.484
Exotic2 -0.651
Full -0.818