Skip to content

idemia/python-wsq

Repository files navigation

WSQ

CeCILL-C Python 3.x v?.? Github action Code Coverage Status (Codecov)

A Python library extending Pillow to support WSQ images.

This library is a simple wrapper on the NIST Biometric Image Software (NBIS) version 5.0.0 made available by the National Institute of Standards and Technology (NIST).

For the convenience of the build, the source code of NBIS (or to be more accurate, the part related to WSQ) is included in this repository. Apart from minor changes to make possible the build (like removal of some include directives) the NBIS source code is not changed.

Installation

wsq is published on PyPI and can be installed from there:

pip install -U wsq

To install from source code:

pip install build
python -m build

The Python development library and C compiler must be available. For instance, for Ubuntu:

sudo apt install python3-dev

Quick Start

To open a WSQ image:

from PIL import Image
import wsq

img = Image.open("my_image.wsq")

To save a WSQ images, use one of:

image.save(f,'WSQ')
# or
image.save('test.wsq')

To convert from another format:

from PIL import Image
import wsq

img = Image.open("test.png")
# Convert to grayscale image (important)
img = img.convert("L")
img.save("test.wsq")