Mike Gerber
db63b46e65
Installing the ppn2ocr requirements fails when pip is not updated (see issue below), so mention the issue in the README. Quoting https://github.com/skvark/opencv-python#frequently-asked-questions: Q: Pip install fails with ModuleNotFoundError: No module named 'skbuild'? Since opencv-python version 4.3.0.*, manylinux1 wheels were replaced by manylinux2014 wheels. If your pip is too old, it will try to use the new source distribution introduced in 4.3.0.38 to manually build OpenCV because it does not know how to install manylinux2014 wheels. However, source build will also fail because of too old pip because it does not understand build dependencies in pyproject.toml. To use the new manylinux2014 pre-built wheels (or to build from source), your pip version must be >= 19.3. Please upgrade pip with pip install --upgrade pip. |
4 years ago | |
|---|---|---|
| data@0cc78464e7 | 4 years ago | |
| ocrd-bugs | 5 years ago | |
| .gitignore | 5 years ago | |
| .gitmodules | 5 years ago | |
| .travis.yml | 4 years ago | |
| Dockerfile-core | 4 years ago | |
| Dockerfile-dinglehopper | 4 years ago | |
| Dockerfile-ocrd_calamari | 4 years ago | |
| Dockerfile-ocrd_olena | 4 years ago | |
| Dockerfile-ocrd_tesserocr | 4 years ago | |
| Dockerfile-sbb_textline_detector | 4 years ago | |
| README-DEV.md | 4 years ago | |
| README.md | 4 years ago | |
| build | 4 years ago | |
| my_ocrd_workflow | 4 years ago | |
| ppn2ocr | 4 years ago | |
| qurator_data_lib.sh | 4 years ago | |
| requirements-ppn2ocr.txt | 5 years ago | |
| run | 4 years ago | |
| run-docker-hub | 4 years ago | |
| zdb2ocr | 5 years ago | |
README.md
My OCR-D workflow
WIP. Given a OCR-D workspace with document images in the OCR-D-IMG file group, this workflow produces:
- Binarized images
- Line segmentation
- OCR text (using Calamari and Tesseract, both with GT4HistOCR models)
- (Given ground truth in OCR-D-GT-PAGE, also an OCR text evaluation report)
If you're interested in the exact processors, versions and parameters, please take a look at the script and possibly the individual Dockerfiles.
Goal
Provide a test environment to produce OCR output for historical prints, using OCR-D, especially ocrd_calamari and sbb_textline_detection, including all dependencies in Docker.
How to use
It's easiest to use it as pre-built containers. To run the containers on an example workspace:
# Download an example workspace
cd /tmp
wget https://qurator-data.de/examples/actevedef_718448162.first-page.zip
unzip actevedef_718448162.first-page.zip
# Run the workflow on it
cd actevedef_718448162.first-page
~/devel/my_ocrd_workflow/run-docker-hub
Build the containers yourself
To build the containers yourself using Docker:
cd ~/devel/my_ocrd_workflow
./build
You may then use the script run to use your self-built containers, analogous to
the example above.
Viewing results
You may then examine the results using PRImA's PAGE Viewer:
java -jar /path/to/JPageViewer.jar \
--resolve-dir . \
OCR-D-OCR-CALAMARI/OCR-D-OCR-CALAMARI_00000024.xml
The workflow also produces OCR evaluation reports using dinglehopper, if ground truth was available:
firefox OCR-D-OCR-CALAMARI-EVAL/OCR-D-OCR-CALAMARI-EVAL_00000024.html
ppn2ocr
The ppn2ocr script produces a METS file with the best images for a given
document in the State Library Berlin (SBB)'s digitized collection.
Install it with an up-to-date pip (otherwise this will fail due to a opencv-python-headless build failure):
pip install -r ~/devel/my_ocrd_workflow/requirements-ppn2ocr.txt
The document must be specified by its PPN, for example:
~/devel/my_ocrd_workflow/ppn2ocr PPN77164308X
cd PPN77164308X
~/devel/my_ocrd_workflow/run-docker-hub -I BEST --skip-validation
This produces a workspace directory PPN77164308X with the OCR results in it;
the results are viewable as explained above.
ppn2ocr requires a working Docker setup and properly set up environment
variables for the proxy configuration. At SBB, please read
howto/docker-proxy.md and howto/proxy-settings-for-shell+python.md
(in qurator's mono-repo).