Skip to content

A simple module to extend islandora solution pack ingest processes by generating OCR for uploaded images via Tesseract. Enables the generation/parsing of OCR and HCOR data-streams.

License

Notifications You must be signed in to change notification settings

librarychik/islandora_ocr

 
 

Repository files navigation

Islandora OCR Build Status

Introduction

This module acts a Toolkit for generating OCR and word coordinate information. At the moment it relies exclusively on Tesseract to generate this information.

Tesseract

Tesseract is an OCR engine that was developed at HP Labs between 1985 and 1995. It is currently being developed at Google. Recognized as one of the most accurate open source OCR engines available, Tesseract will read binary, grey, or colour images and output text.

A TIFF reader that will read uncompressed TIFF images is also included. Islandora Book Solution Pack currently uses Tesseract version 3.02.02, which can be obtained from the project home page. Lower versions are not supported.

Requirements

This module requires the following modules/libraries:

Tesseract installation will differ depending on your operating system; please see the Tesseract Wiki for detailed instructions.

Installation

Install as usual, see this for further information.

Configuration

In Administration » Islandora » Islandora Utility Modules » OCR Tool (admin/islandora/tools/ocr), configure the following:

  • Set the path for Tesseract
  • Select languages available for OCR
  • Enable/disable Solr Fast Vector Highlighting
  • Set Solr field containing OCR text and the maximum number of results to return in a Solr query

Configuration

Solr result highlighting

To have Islandora viewers recognize Solr search results and highlight them, one will need to configure Solr to index the HOCR in a particular fashion.

The field that the HOCR is stored in must have the following attributes: indexed="true" stored="true" termVectors="true" termPositions="true" termOffsets="true"

Each text node of each element in the HOCR datastream must be placed in order in a single value for the Solr field with all whitespace sub strings normalized to a single space.

Any objects that were previously ingested but require this functionality will need to be re-indexed.

XSLT Reference Implementation for GSearch

Tesseract

Tesseract provides many languages which can be downloaded from here.

To install just unzip them in your tessdata directory, typically located at /usr/local/share/tessdata

If you want to add your own langauges or train your Tesseract for your specific needs please review the documentation here

Documentation

Further documentation for this module is available at our wiki.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3

About

A simple module to extend islandora solution pack ingest processes by generating OCR for uploaded images via Tesseract. Enables the generation/parsing of OCR and HCOR data-streams.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%