You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Clemens Neudecker 978f425bd1
document tested Python+TF2 versions
6 days ago
.circleci make git submodule update depend on subdir 1 year ago
.github/workflows remove Python 3.11 from test 6 days ago
repo add assets subrepo 4 years ago
sbb_binarize 📦 v0.1.0 1 year ago
.gitignore 📦 v0.0.2 4 years ago
.gitkeep Add new directory, you can find corresponding models in qurator-data 5 years ago
.gitmodules add assets subrepo 4 years ago 📦 v0.1.0 1 year ago
LICENSE Add LICENSE 4 years ago
Makefile make git submodule update depend on subdir 1 year ago document tested Python+TF2 versions 6 days ago Add new file 5 years ago
ocrd-tool.json add ocrd-tool.json 4 years ago
requirements.txt Update tensorflow version requirements 6 days ago fix standalone CLI version_option 1 year ago


Document Image Binarization

pip release GHActions Tests


Python 3.7-3.10 with Tensorflow <=2.11.1 are currently supported. While newer versions might also work, we currently don't test this.

You can either install from PyPI via

pip install sbb-binarization

or clone the repository, enter it and install (editable) with

git clone
cd sbb_binarization; pip install -e .


Pre-trained models can be downloaded from the locations below. We also provide models and model cards on 🤗

Version Format Download
2021-03-09 SavedModel
2021-03-09 HDF5
2020-01-16 SavedModel
2020-01-16 HDF5

With OCR-D, you can also use the Resource Manager, e.g.

ocrd resmgr download ocrd-sbb-binarize "*"


sbb_binarize \
  -m <path to directory containing model files> \
  <input image> \
  <output image>

Note: the output image MUST use either .tif or .png as file extension to produce a binary image. Input images can also be JPEG.

Images containing a lot of border noise (black pixels) should be cropped beforehand to improve the quality of results.


sbb_binarize -m /path/to/model/ myimage.tif myimage-bin.tif

To use the OCR-D interface:

ocrd-sbb-binarize -I INPUT_FILE_GRP -O OCR-D-IMG-BIN -P model default


For simple smoke tests, the following will

  • download models

  • download test data

  • run the OCR-D wrapper (on page and region level):

      make models
      make test