Deep Image Structure and Texture Similarity (DISTS) Metric
This is the repository of paper Image Quality Assessment: Unifying Structure and Texture Similarity.
Highlights:
- A full-reference IQA model correlated well with human perception of image quality.
- It is robust to texture variance (e.g., evaluating the images generated by GANs) and mild geometric transformations (e.g., evaluating the image pair that are not strictly point-by-point aligned).
- It can be employed as the objective function in various optimization problems.
Three implementation versions:
- Pytorch
DISTS_pt.py(recommend) - Tensorflow
DISTS_tf.py - Matlab
DISTS.m.
====== Pytorch ======
Installation:
pip install dists-pytorch
Requirements:
- Python>=3.6
- Pytorch>=1.0
Usage:
from DISTS_pytorch import DISTS
D = DISTS()
# calculate DISTS between X, Y (a batch of RGB images, data range: 0~1)
# X: (N,3,H,W)
# Y: (N,3,H,W)
dists_value = D(X, Y)
# set 'require_grad=True, batch_average=True' to get a scalar value as loss.
dists_loss = D(X, Y, require_grad=True, batch_average=True)
dists_loss.backward()
or
git clone https://github.com/dingkeyan93/DISTS
cd DISTS_pytorch
python DISTS_pt.py --ref <ref_path> --dist <dist_path>
====== Tensorflow ======
Requirements:
- Python>=3.6
- Tensorflow>=1.15
Usage:
git clone https://github.com/dingkeyan93/DISTS
cd DISTS_tensorflow
python DISTS_tf.py --ref <ref_path> --dist <dist_path>
====== Matlab ======
Requirements:
- Matlab>=2019b
Usage:
git clone https://github.com/dingkeyan93/DISTS
run demo.m
help DISTS
Citation
@article{ding2020iqa,
title={Image Quality Assessment: Unifying Structure and Texture Similarity},
author={Ding, Keyan and Ma, Kede and Wang, Shiqi and Simoncelli, Eero P.},
journal = {CoRR},
volume = {abs/2004.07728},
year={2020},
url = {https://arxiv.org/abs/2004.07728}
}
Metadata
Release files for DISTS-pytorch 0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| DISTS_pytorch-0.1-py3-none-any.whl | Python 3 | none | any | Details for DISTS_pytorch-0.1-py3-none-any.whl |
Release files / DISTS_pytorch-0.1-py3-none-any.whl
| Download URL | DISTS_pytorch-0.1-py3-none-any.whl |
|---|---|
| Size | 20.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
73e54ce13e7cf3ca962ee8e433d129884ec3dc75e00a27af90525e1da760ac61
|
|
BLAKE2b-256 checksum How to use checksums |
fa78f76cbe06c88076f6d6d5ef16a7591a7e3b7eb225e39b035e16d95f0fb89c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4
|
Security for DISTS-pytorch 0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.