imclab / comparison-server

takes two images and returns a set of comparison metrics

comparison-server

takes two images and returns a set of comparison metrics

Set up

There are a few dependencies to look out for. You can either install them manually, or use the commands below.

This can be installed locally on your system pretty easily using virtualenv and pip.

Just clone this repository and do the following commands:

$ cd comparison-server ( or wherever you cloned it to )
$ virtualenv venv --distribute
$ source venv/bin/activate
$ pip install -r requirements.txt

You can then run the server locally using foreman like this:

$ foreman start

If you want to skip all that and you already have the dependencies installed on your system, just do:

$ gunicorn comparison:app

Dependencies

• Flask
• PIL
• gunicorn
• python-Levenshtein

Use

This server uses a handful of image processing algorithms to determines the similarity between two images. Presently you can only load files locally like so:

$ curl -F image_a=@/path/to/image_a.jpg -F image_b=@/path/to/image_b.jpg http//0.0.0.0:5000/

resulting in something like this

{
  "metrics": {
    "levenshtein": 24.479166666666657, 
    "nrmsd": 98.73465815317296, 
    "psnr": 37.955842578546836, 
    "similarity": 61.60691240991981
  }, 
  "stat": "ok"
  }

Metrics

Currently the following image processing algorithms are being used:

• Levenshtein Distance
• Normalized Root Mean Square Deviation
• Peak Signal to Noise Ratio