Skip to content
Image similarity comparison simulating human perception (multiscale SSIM in Rust)
Rust
Branch: master
Clone or download
Latest commit 57953df Jun 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
benches Edition 2018 Jun 5, 2019
src Edition 2018 Jun 5, 2019
tests Initial public release Nov 10, 2017
.gitignore Initial public release Nov 10, 2017
CONTRIBUTING.md Add contributing doc Jan 5, 2019
Cargo.toml Edition 2018 Jun 5, 2019
README.md Bump Mar 16, 2019
snapcraft.yaml Fix snapcraft Mar 16, 2019

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 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.
  • No OpenCV or MATLAB needed.
    • DSSIM version 1.x uses C (C99) and libpng or Cocoa on macOS.
    • DSSIM version 2.x is easy to build with Rust.

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

It's also usable as a 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.

When you quote results, please include DSSIM version, since the scale has changed between versions. The version is printed when you run dssim -h.

Build or Download

You need Rust

cargo build --release

Will give you ./target/release/dssim.

Accuracy

Scores for version 2.9 measured against TID2013 database:

TID2013 Category Spearman correlation
Noise -0.930
Actual -0.937
Simple -0.946
Exotic -0.844
New -0.802
Color -0.814
Full -0.861

License

DSSIM is dual-licensed under AGPL or commercial license.

You can’t perform that action at this time.