Skip to content

Commit e2d4457

Browse files
committed
Update README
1 parent 92ae59d commit e2d4457

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

README.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
# RGBA Structural Similarity
22

3-
This tool computes (dis)similarity between two or more PNG images using an algorithm approximating human vision.
4-
5-
Comparison is done using a derivation of [the SSIM algorithm](https://ece.uwaterloo.ca/~z70wang/research/ssim/).
3+
This tool computes (dis)similarity between two or more images using an algorithm approximating human vision. Comparison is done using a variant of [the SSIM algorithm](https://ece.uwaterloo.ca/~z70wang/research/ssim/).
64

75
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](#interpreting-the-values) on interpreting the values.
86

@@ -11,8 +9,10 @@ The value returned is 1/SSIM-1, where 0 means identical image, and >0 (unbounded
119
* Improved algorithm
1210
* Compares at multiple weighed resolutions, and scaling is done in linear-light RGB. It's sensitive to distortions of various sizes and blends colors correctly to detect e.g. chroma subsampling errors.
1311
* Uses L\*a\*b\* color space for the SSIM algorithm. It measures brightness and color much better than metrics from average of RGB channels.
14-
* Uses mean absolute deviation for pooling of SSIM values.
1512
* Supports alpha channel.
13+
* Supports images with color profiles.
14+
* Takes advantage of multi-core CPUs.
15+
* Can be used as a library in C, Rust, and WASM.
1616
* No OpenCV or MATLAB needed.
1717

1818
## Usage
@@ -31,7 +31,7 @@ You can save an image visualising the difference between the files:
3131

3232
It's also usable [as a library](https://docs.rs/dssim).
3333

34-
Please be careful about color profiles in the images. Different profiles, or lack of support for profiles, can make images appear different even when the pixels are the same.
34+
Please be mindful about color profiles in the images. Different profiles, or lack of support for profiles in other tools, can make images appear different even when the pixels are the same.
3535

3636
### Interpreting the values
3737

@@ -44,12 +44,16 @@ If you're comparing two different image compression codecs, then ensure you eith
4444

4545
[More about benchmarking image compression](https://kornel.ski/faircomparison).
4646

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

50-
## Build or Download
50+
## Download
51+
52+
[Download from releases page](https://github.com/kornelski/dssim/releases). It's also available in Mac Homebrew and Ubuntu Snaps.
53+
54+
### Build from source
5155

52-
You need Rust 1.48 or later.
56+
You'll need [Rust 1.48](https://rustup.rs) or later. Clone the repo and run:
5357

5458
cargo build --release
5559

@@ -80,7 +84,7 @@ DSSIM is dual-licensed under [AGPL](LICENSE) or [commercial](https://supso.org/p
8084

8185
* The comparison is done on multiple weighed scales (based on IWSSIM) to measure features of different sizes. A single-scale SSIM is biased towards differences smaller than its gaussian kernel.
8286
* Scaling is done in linear-light RGB to model physical effects of viewing distance/lenses. Scaling in sRGB or Lab would have incorrect gamma and mask distortions caused by chroma subsampling.
83-
* ab channels of Lab are compared with lower spatial precision to simulate eyes' higher sensitivity to brightness than color changes.
87+
* a/b channels of Lab are compared with lower spatial precision to simulate eyes' higher sensitivity to brightness than color changes.
8488
* The lightness component of SSIM is ignored when comparing color channels.
85-
* SSIM score is pooled using a combination of local maximums and global averages. You can get per-pixel SSIM from the API to implement custom pooling.
89+
* SSIM score is pooled using mean absolute deviation. You can get per-pixel SSIM from the API to implement custom pooling.
8690

0 commit comments

Comments
 (0)