Skip to content

Commit

Permalink
Update readme.
Browse files Browse the repository at this point in the history
  • Loading branch information
akbargumbira committed Aug 23, 2018
1 parent cbd40ef commit 1af61a7
Show file tree
Hide file tree
Showing 4 changed files with 30 additions and 3 deletions.
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,34 @@ The package is in PyPI so you can install it simply by this command:

```pip install --process-dependency-links pybrisque```

## Usage
Initialize once:
```
brisq = BRISQUE()
```
and get the BRISQUE feature or score many times:
```
brisq.get_feature('/path')
brisq.get_feature('/image_path')
```


## Limitations
This implementation is heavily adopted from the original Matlab
implementation in [here](https://github.com/dsoellinger/blind_image_quality_toolbox/tree/master/%2Bbrisque). There is one catch though, the bicubic interpolation when resizing image in
Matlab and OpenCV is a bit different as explained in [here](https://stackoverflow.com/questions/26823140/imresize-trying-to-understand-the-bicubic-interpolation). For now, it uses ```nearest``` interpolation
which gives the most similar output with the original implementation.

Comparing with Matlab original implementation on reference images of TID 2008:

![Comparison](examples/comparison.png)

And the absolute differences' stat is as follows:
```
{'min': 0.17222238726479588,
'max': 16.544924728934404,
'mean': 3.9994322498322754,
'std': 3.0715344507521416}
```


2 changes: 1 addition & 1 deletion REQUIREMENTS.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
numpy
scipy
opencv-python
opencv-python-headless
-e git+https://github.com/Salinger/libsvm-python.git#egg=libsvm-python
Binary file added examples/comparison.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 1af61a7

Please sign in to comment.