pysseract 0.1.7

Python binding to Tesseract API

Pysseract

A Python binding to Tesseract API. Tesseract is an open-source tool made available by Google for Optical Character Recognition (OCR) - that is, getting a computer to read the text in an image. Tesseract allows you to perform this task at a number of levels of granularity (one character at a time, one word at a time, and so on), by segmenting the page in a number of different ways (by assuming the whole page is one lump of text, or one line, or sparsely located throughout the source image), and with a number of different language models including ones you have built (pre-built models are available at https://github.com/tesseract-ocr/tessdata among other places).

Pip 19.3.1 or greater is required if you're installing the wheel for this package, otherwise just install the source. On Linux, if you install the wheel Tesseract comes included. You will however need to provide the Tesseract models. An example of how you might do this with English on a linux system is as follows:

curl -O https://raw.githubusercontent.com/tesseract-ocr/tessdata_fast/4.0.0/eng.traineddata
mkdir -p /usr/local/share/tessdata/ && sudo mv eng.traineddata /usr/local/share/tessdata/ 

The reason the file is being put in to /usr/local/share/tessdata/ is because that is the default value for TESSDATA_PREFIX, an environment variable that Tesseract uses to locate model files. You're free to override the value of TESSDATA_PREFIX, of course.

Documentation is hosted on readthedocs.

Basic usage

In order to just get all the text from an image and concatenate it into a string, run the following:

import pysseract
t = pysseract.Pysseract()
t.SetImageFromPath('tests/001-helloworld.png')
print(t.utf8Text)

If instead you want to iterate through the text boxes found in an image at the TEXTLINE level (coarser-grained than WORD, but also lower-level than BLOCK), then you might run the following:

with pysseract.Pysseract() as t:
    resIter = t.GetIterator()
    LEVEL = pysseract.PageIteratorLevel.TEXTLINE
    for box, text in t.iterAt(LEVEL):
        lines.append(text)
        boxes.append(box)

A third possibility is that you may want to control how exactly the image is segmented. This is done before instantiating a ResultIterator, as follows:

with pysseract.Pysseract() as t:
    t.pageSegMode = pysseract.PageSegMode.SINGLE_BLOCK
    t.SetImageFromPath("002-quick-fox.jpg")
    t.SetSourceResolution(70)
    resIter = t.GetIterator()
    LEVEL = pysseract.PageIteratorLevel.TEXTLINE
    lines = []
    boxes = []
    for box, text in t.iterAt(LEVEL):
        lines.append(text)
        boxes.append(box)

Building the package

Requirements

• gcc/clang with at least c++11 support
• libtesseract, libtesseract-dev (equivalent on non-Debian/Ubuntu systems)
• pybind11>=2.2

python3 setup.py test build install

Building the documentation

pip install sphinx sphinx_rtd_theme
python3 setup.py build_sphinx

You should find the generated html in build/sphinx.

Contribute

Look at Tesseract BaseAPI and import those functions of interest to pymodule.cpp.

Please write a brief description in your wrapper function like those already in pymodule.cpp.

Reference

• basic pybind11
• class based pybind11
• compiling with pybind11

LICENSE

GPLv3