pyslibtesseract

Integration of Tesseract for Python using a shared library

To install

From PyPI

sudo pip3 install pyslibtesseract

From Github

sudo apt-get install libtesseract-dev
sudo apt-get install libleptonica-dev
git clone https://github.com/brunomacabeusbr/pyslibtesseract.git
cd pyslibtesseract
cd src/cppcode/ && cmake . && make && cd ../.. && sudo python3 setup.py install

To use

Start

You must create a object of TesseractConfig:

config_single_char = TesseractConfig(psm=PageSegMode.PSM_SINGLE_CHAR)
config_line = TesseractConfig(psm=PageSegMode.PSM_SINGLE_LINE)
config_line_portuguese_brazilian = TesseractConfig(psm=PageSegMode.PSM_SINGLE_LINE, lang='pt-br')

Possible PSM (page segmentation mode) are:

PSM_OSD_ONLY
PSM_AUTO_OSD
PSM_AUTO_ONLY
PSM_AUTO
PSM_SINGLE_COLUMN
PSM_SINGLE_BLOCK_VERT_TEX
PSM_SINGLE_BLOCK
PSM_SINGLE_LINE
PSM_SINGLE_WORD
PSM_CIRCLE_WORD
PSM_SINGLE_CHAR
PSM_SPARSE_TEXT
PSM_SPARSE_TEXT_OSD
PSM_COUNT

You can set variables of Tesseract:

config_single_char.add_variable('tessedit_char_whitelist', 'QWERTYUIOPASDFGHJKLZXCVBNM')

Read

The first parameter is always the configuration and the second parameter is always the image path

Read a pharese

>>> LibTesseract.simple_read(config_line, 'phrase.png')
the book is on the table

Read a pharese and say confidence in each sentence

>>> LibTesseract.read_and_get_confidence_word(config_line, 'phrase.png')
[('he', 82.19984436035156), ('is', 84.98550415039062), ('readlnq', 75.25213623046875), ('the', 74.60755157470703), ('book', 85.8053207397461)]

Read a char, say confidence and other possible characters

>>> LibTesseract.read_and_get_confidence_char(config_single_char, 'char.png')
[('E', 58.27500915527344), ('Y', 56.93630599975586), ('F', 56.4453125), ('T', 51.12168884277344), ('Q', 47.19916534423828), ('W', 46.1181640625), ('V', 45.31656265258789), ('G', 43.49636459350586)]

hOCR

If you want a return with hOCR format, you need a create config with hocr=True

>>> config_line_with_hocr = TesseractConfig(psm=PageSegMode.PSM_SINGLE_LINE, hocr=True)

or edit a alredy exist config

>>> config_line.hocr = True

Then, use a method simple_read

>>> LibTesseract.simple_read(config_line_with_hocr, 'phrase.png')
  <div class='ocr_page' id='page_1' title='image ""; bbox 0 0 319 33; ppageno 0'>
   <div class='ocr_carea' id='block_1_1' title="bbox 0 0 319 33">
    <p class='ocr_par' dir='ltr' id='par_1_1' title="bbox 10 13 276 25">
     <span class='ocr_line' id='line_1_1' title="bbox 10 13 276 25; baseline 0 0"><span class='ocrx_word' id='word_1_1'     title='bbox 10 14 41 25; x_wconf 75' lang='eng' dir='ltr'><strong>the</strong></span> <span class='ocrx_word' id='word_1_2' title='bbox 53 13 97 25; x_wconf 84' lang='eng' dir='ltr'><strong>book</strong></span> <span class='ocrx_word' id='word_1_3' title='bbox 111 13 129 25; x_wconf 79' lang='eng' dir='ltr'><strong>is</strong></span> <span class='ocrx_word' id='word_1_4' title='bbox 143 17 164 25; x_wconf 83' lang='eng' dir='ltr'>on</span> <span class='ocrx_word' id='word_1_5' title='bbox 178 14 209 25; x_wconf 75' lang='eng' dir='ltr'><strong>the</strong></span> <span class='ocrx_word' id='word_1_6' title='bbox 223 14 276 25; x_wconf 76' lang='eng' dir='ltr'><strong>table</strong></span> 
     </span>
    </p>
   </div>
  </div>