ocrd/core-cuda

OCR-D/core-cuda镜像说明

镜像概述

本镜像包含实现https://github.com/OCR-D/spec%E7%9A%84Python%E6%A8%A1%E5%9D%97%E5%8F%8A%E7%9B%B8%E5%85%B3%E5%B7%A5%E5%85%B7%EF%BC%8C%E9%A2%84%E5%AE%89%E8%A3%85%E4%BA%86CUDA%E5%B7%A5%E5%85%B7%E5%8C%85%E5%92%8C%E5%BA%93%EF%BC%8C%E6%98%AFOCR-D%E7%94%9F%E6%80%81%E7%B3%BB%E7%BB%9F%E7%9A%84%E5%9F%BA%E7%A1%80%E7%BB%84%E4%BB%B6%EF%BC%8C%E6%94%AF%E6%8C%81CUDA%E5%8A%A0%E9%80%9F%E7%9A%84%E5%85%89%E5%AD%A6%E5%AD%97%E7%AC%A6%E8%AF%86%E5%88%AB%EF%BC%88OCR%EF%BC%89%E5%A4%84%E7%90%86%E4%BB%BB%E5%8A%A1%E3%80%82%E6%89%80%E6%9C%89%E6%A8%A1%E5%9D%97%E5%9D%87%E5%B7%B2%E5%8F%91%E5%B8%83%E8%87%B3PyPI%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8EPython 3.8及以上版本。

核心功能

1. ocrd_utils：提供日志、路径归一化、坐标计算等通用工具和常量。
2. ocrd_models：封装PAGE-XML、METS、EXIF元数据等文件格式的操作接口。
3. ocrd_modelfactory：从现有数据实例化OCR-D模型的工具。
4. ocrd_validators：验证BagIt、ocrd-tool.json、工作空间、METS等内容的模式和逻辑。
5. ocrd_network：支持OCR-D Web API的组件。
6. ocrd：整合上述模块，提供创建OCR-D处理器和命令行工具的装饰器与类，包含ocrd主CLI。
7. bash库：生成符合OCR-D规范的bash脚本CLI。

使用场景

• 文档数字化项目中的OCR工作流构建与执行。
• OCR-D处理器的开发、测试与部署。
• 需要CUDA加速的高吞吐量OCR处理任务。
• 学术或企业级文档识别与结构化处理场景。

配置说明

大部分行为通过CLI参数配置（使用--help查看），部分通过环境变量调整：

• OCRD_METS_CACHING：设置为true时缓存METS文件访问，提升内存操作速度。
• OCRD_PROFILE：配置CPU/内存 profiling（可选值：CPU、RSS、PSS）。
• OCRD_PROFILE_FILE：指定CPU profile输出文件路径。
• XDG_CONFIG_HOME：ocrd/resources.yml的查找目录（默认$HOME/.config）。
• XDG_DATA_HOME：ocrd-resources数据存储目录（默认$HOME/.local/share）。
• OCRD_DOWNLOAD_RETRIES：下载工作空间文件的重试次数。
• OCRD_DOWNLOAD_TIMEOUT：下载连接/读取超时（秒，逗号分隔）。

Docker部署示例

基础使用（查看帮助）

bash
docker run --gpus all docker.xuanyuan.run/ocrd/core-cuda ocrd --help

运行OCR-D工作空间操作

bash
docker run --gpus all -v $(pwd)/workspace:/workspace docker.xuanyuan.run/ocrd/core-cuda ocrd workspace --help

执行OCR-D处理器（示例）

bash
docker run --gpus all -v $(pwd)/workspace:/workspace docker.xuanyuan.run/ocrd/core-cuda ocrd process ocrd-tesserocr-recognize -I OCR-D-IMG -O OCR-D-OCR

注：需确保Docker环境已配置GPU支持（如nvidia-docker）。