OCRmyPDFローカルデプロイ&使い方チュートリアル
OCRmyPDF は、スキャンしたPDFファイルに検索・コピー可能なOCRテキストレイヤーを追加することを主な目的としたツールで、多言語対応、画像の最適化、傾き補正、ページのクリーニング、自動回転などの機能を備えています。以下にOCRmyPDFのローカルデプロイ方法を説明します。

OCRmyPDFローカルデプロイ方法
OCRmyPDFはさまざまなインストール方法を提供しており、お使いのオペレーティングシステムやニーズに応じて選択できます。
1. システムパッケージマネージャーを使用したインストール
Debian/Ubuntu:
apt install ocrmypdf
Fedora:
dnf install ocrmypdf tesseract-osd
macOS (Homebrew):
brew install ocrmypdf
Windows Subsystem for Linux:
apt install ocrmypdf
2. Python pipを使用したインストール
最新バージョンをインストールしたい場合や、システムパッケージマネージャーが提供するバージョンが古い場合は、pipを使用できます。
pip install ocrmypdf
または、pipxを使用して分離されたPython環境を作成することもできます。
pipx install ocrmypdf
3. Dockerを使用したインストール
Dockerを使用している場合、以下のコマンドでOCRmyPDFのDockerイメージをインストールできます。
docker pull jbarlow83/ocrmypdf
実行時には、入力ファイルと出力ファイルをコンテナにマウントできます。
docker run -v /path/to/input.pdf:/input.pdf -v /path/to/output.pdf:/output.pdf jbarlow83/ocrmypdf /input.pdf /output.pdf
4. ソースコードからのインストール
ソースコードからインストールする場合(例:開発や最新機能のテスト)には、GitHubリポジトリをクローンしてインストールできます。
git clone https://github.com/ocrmypdf/OCRmyPDF.git cd OCRmyPDF pip install -e .
依存関係
Python 3.10 以上
Ghostscript 9.54 以上
Tesseract 4.1.1 以上
jbig2enc 0.29 以上(オプション、出力ファイルサイズの最適化に使用)
pngquant 2.5 以上(オプション、PNG画像の最適化に使用)
unpaper 6.1 以上(オプション、画像クリーニングに使用)
注意事項
32ビットサポート:OCRmyPDFは32ビットシステムをサポートしていないため、64ビット版の使用を推奨します。
Windowsユーザー:互換性の問題を回避するため、Windows Subsystem for LinuxまたはDockerの使用を推奨します。
macOSユーザー:Homebrewでインストールできますが、Tesseractの言語パック(tesseract-langなど)を追加でインストールする必要があります。
インストールの確認
インストールが完了したら、以下のコマンドでOCRmyPDFが正常にインストールされたかを確認できます。
ocrmypdf --version
OCRmyPDF使用チュートリアル
1. OCRテキストレイヤーの追加
コア機能:スキャンしたPDFファイルに検索可能なテキストレイヤーを追加し、ドキュメントの内容をコピー可能・検索可能にします。
コマンド例:
ocrmypdf input.pdf output.pdf
2. 多言語サポート
機能説明:100以上の言語をサポートしており、ユーザーはドキュメントの言語に応じて適切な言語パックを選択し、OCRの精度を向上させることができます。
コマンド例:
ocrmypdf --language chi_sim input.pdf output.pdf # 簡体字中国語 ocrmypdf --language eng input.pdf output.pdf # 英語
3. 画像最適化
機能説明:PDF内の画像を最適化し、解像度の調整や画像サイズの圧縮などを行い、画質を保ちながらより小さいファイルを生成します。
コマンド例:
ocrmypdf --optimize 3 input.pdf output.pdf # 最強の最適化
4. 傾き補正とクリーニング
機能説明:OCRを実行する前に、画像の傾き補正(傾きの修正)やクリーニング(汚れやノイズの除去)を行い、OCRの精度を向上させます。
コマンド例:
ocrmypdf --deskew --clean input.pdf output.pdf
5. ページの自動回転
機能説明:ページの方向を自動検出し、すべてのページの方向を揃えて回転させることで、読み取りや処理を容易にします。
コマンド例:
ocrmypdf --rotate-pages input.pdf output.pdf
6. PDF/A形式への変換
機能説明:出力ファイルをPDF/A形式に変換します。これは長期保存に適した国際標準のアーカイブ形式です。
コマンド例:
ocrmypdf --output-type pdfa input.pdf output.pdf
7. 重複ページの削除
機能説明:PDF内の重複ページを自動検出して削除し、ファイルサイズを削減します。
コマンド例:
ocrmypdf --remove-background input.pdf output.pdf
8. 背景除去
機能説明:PDFページの背景を除去し、文字をより鮮明にして読みやすくします。
コマンド例:
ocrmypdf --remove-background input.pdf output.pdf
9. PDF/A形式の生成
機能説明:長期アーカイブや保存に適したPDF/A標準に準拠したファイルを生成します。
コマンド例:
ocrmypdf --output-type pdfa input.pdf output.pdf
10. 既にOCR済みのページのスキップ
機能説明:PDF内の一部のページに既にテキストレイヤーが含まれている場合、それらのページをスキップして重複処理を回避できます。
コマンド例:
ocrmypdf --skip-text input.pdf output.pdf
11. カスタムDPI
機能説明:OCR処理時の画像解像度(DPI)を指定できます。デフォルト値は300 DPIです。
コマンド例:
ocrmypdf --dpi 350 input.pdf output.pdf
12. モノクロ画像への変換
機能説明:カラーまたはグレースケール画像をモノクロ画像に変換し、ファイルサイズを削減します。
コマンド例:
ocrmypdf --output-type pdf --monochrome input.pdf output.pdf
13. ログファイルの生成
機能説明:詳細なログファイルを生成し、デバッグや処理プロセスの記録を容易にします。
コマンド例:
ocrmypdf --log-file output.log input.pdf output.pdf
14. バッチ処理
機能説明:スクリプトやコマンドラインツール(GNU Parallelなど)と組み合わせることで、複数のPDFファイルをバッチ処理できます。
コマンド例:
for file in *.pdf; do ocrmypdf "$file" "output_$file" done
15. 複数の入力形式のサポート
のファイル生成 PDF には、TIFF、PNG などが含まれます。サンプルコマンド:
ocrmypdf input.tiff output.pdf
16. PDFの圧縮
機能説明:OCR処理後、PDFファイルをさらに圧縮してファイルサイズを削減できます。
サンプルコマンド:
ocrmypdf --optimize 3 input.pdf output.pdf
17. PDF/A-2bまたはPDF/A-2uへの変換
機能説明:PDF/A-2bまたはPDF/A-2u規格に準拠したファイルを生成し、さまざまなニーズに対応します。
サンプルコマンド:
ocrmypdf --output-type pdfa-2b input.pdf output.pdf ocrmypdf --output-type pdfa-2u input.pdf output.pdf
18. Unicode対応
機能説明:Unicode文字をサポートし、多言語ドキュメントの正確な処理を保証します。
サンプルコマンド:
ocrmypdf --language chi_sim --language eng input.pdf output.pdf
19. 出力ファイル名のカスタマイズ
機能説明:出力ファイルの名前をカスタマイズでき、管理や識別が容易になります。
サンプルコマンド:
ocrmypdf input.pdf "output_with_date_$(date +%Y%m%d).pdf"
20. コマンドライン引数のサポート
機能説明:コマンドライン引数を通じて、OCRmyPDFのさまざまな機能を柔軟に構成できます。
サンプルコマンド:
ocrmypdf --help
OCRmyPDFローカルデプロイおよび使用方法:https://ocrmypdf.readthedocs.io/en/latest/installation.html
脚本プランナー▸
AIアプリ
AIニュース 