| Name | ocrd JSON |
| Version |
2.70.0
JSON |
| download |
| home_page | None |
| Summary | OCR-D framework |
| upload_time | 2024-10-10 14:21:55 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | Apache License 2.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
# OCR-D/core
> Python modules implementing [OCR-D specs](https://github.com/OCR-D/spec) and related tools
[](https://pypi.org/project/ocrd/)
[](https://github.com/OCR-D/core/actions/workflows/docker-image.yml)
[](https://github.com/OCR-D/core/actions/workflows/unit-test.yml)
[](https://codecov.io/gh/OCR-D/core)
[](https://scrutinizer-ci.com/g/OCR-D/core)
[](https://scrutinizer-ci.com/g/OCR-D/core)
[](https://gitter.im/OCR-D/Lobby)
<!-- BEGIN-MARKDOWN-TOC -->
* [Introduction](#introduction)
* [Installation](#installation)
* [Command line tools](#command-line-tools)
* [`ocrd` CLI](#ocrd-cli)
* [`ocrd-dummy` CLI](#ocrd-dummy-cli)
* [Configuration](#configuration)
* [Packages](#packages)
* [ocrd_utils](#ocrd_utils)
* [ocrd_models](#ocrd_models)
* [ocrd_modelfactory](#ocrd_modelfactory)
* [ocrd_validators](#ocrd_validators)
* [ocrd_network](#ocrd_network)
* [ocrd](#ocrd)
* [bash library](#bash-library)
* [Testing](#testing)
* [See Also](#see-also)
<!-- END-MARKDOWN-TOC -->
## Introduction
This repository contains the python packages that form the base for tools within the
[OCR-D ecosphere](https://github.com/topics/ocr-d).
All packages are also published to [PyPI](https://pypi.org/search/?q=ocrd).
## Installation
**NOTE** Unless you want to contribute to OCR-D/core, we recommend installation
as part of [ocrd_all](https://github.com/OCR-D/ocrd_all) which installs a
complete stack of OCR-D-related software.
The easiest way to install is via `pip`:
```sh
pip install ocrd
# or just the functionality you need, e.g.
pip install ocrd_modelfactory
```
All Python software released by [OCR-D](https://github.com/OCR-D) requires Python 3.8 or higher.
**NOTE** Some OCR-D-Tools (or even test cases) _might_ reveal an unintended behavior if you have specific environment modifications, like:
* using a custom build of [ImageMagick](https://github.com/ImageMagick/ImageMagick), whose format delegates are different from what OCR-D supposes
* custom Python logging configurations in your personal account
## Command line tools
**NOTE:** All OCR-D CLI tools support a `--help` flag which shows usage and
supported flags, options and arguments.
### `ocrd` CLI
* [CLI usage](https://ocr-d.de/core/api/ocrd/ocrd.cli.html)
* [Introduction to `ocrd workspace`](https://github.com/OCR-D/ocrd-website/wiki/Intro-ocrd-workspace-CLI)
* [OCR-D user guide](https://ocr-d.de/en/use)
### `ocrd-dummy` CLI
A minimal [OCR-D processor](https://ocr-d.de/en/user_guide#using-the-ocr-d-processors) that copies from `-I/-input-file-grp` to `-O/-output-file-grp`
## Configuration
Almost all behaviour of the OCR-D/core software is configured via CLI options and flags, which can be listed with the `--help` flag that all CLI support.
Some parts of the software are configured via environment variables:
* `OCRD_METS_CACHING`: If set to `true`, access to the METS file is cached, speeding in-memory search and modification.
* `OCRD_PROFILE`: This variable configures the built-in CPU and memory profiling. If empty, no profiling is done. Otherwise expected to contain any of the following tokens:
* `CPU`: Enable CPU profiling of processor runs
* `RSS`: Enable RSS memory profiling
* `PSS`: Enable proportionate memory profiling
* `OCRD_PROFILE_FILE`: If set, then the CPU profile is written to this file for later peruse with a analysis tools like [snakeviz](https://jiffyclub.github.io/snakeviz/)
* `PATH`: Search path for processor executables (affects `ocrd process` and `ocrd resmgr`).
* `HOME`: Directory to look for `ocrd_logging.conf`, fallback for unset XDG variables (see below).
* `XDG_CONFIG_HOME`: Directory to look for `./ocrd/resources.yml` (i.e. `ocrd resmgr` user database) – defaults to `$HOME/.config`.
* `XDG_DATA_HOME`: Directory to look for `./ocrd-resources/*` (i.e. `ocrd resmgr` data location) – defaults to `$HOME/.local/share`.
* `OCRD_DOWNLOAD_RETRIES`: Number of times to retry failed attempts for downloads of workspace files.
* `OCRD_DOWNLOAD_TIMEOUT`: Timeout in seconds for connecting or reading (comma-separated) when downloading.
* `OCRD_METS_CACHING`: Whether to enable in-memory storage of OcrdMets data structures for speedup during processing or workspace operations.
* `OCRD_MAX_PROCESSOR_CACHE`: Maximum number of processor instances (for each set of parameters) to be kept in memory (including loaded models) for processing workers or processor servers.
* `OCRD_NETWORK_SERVER_ADDR_PROCESSING`: Default address of Processing Server to connect to (for `ocrd network client processing`).
* `OCRD_NETWORK_SERVER_ADDR_WORKFLOW`: Default address of Workflow Server to connect to (for `ocrd network client workflow`).
* `OCRD_NETWORK_SERVER_ADDR_WORKSPACE`: Default address of Workspace Server to connect to (for `ocrd network client workspace`).
* `OCRD_NETWORK_RABBITMQ_CLIENT_CONNECT_ATTEMPTS`: Number of attempts for a worker to create its queue. Helpful if the rabbitmq-server needs time to be fully started.
## Packages
### ocrd_utils
Contains utilities and constants, e.g. for logging, path normalization, coordinate calculation etc.
See [README for `ocrd_utils`](./README_ocrd_utils.md) for further information.
### ocrd_models
Contains file format wrappers for PAGE-XML, METS, EXIF metadata etc.
See [README for `ocrd_models`](./README_ocrd_models.md) for further information.
### ocrd_modelfactory
Code to instantiate [models](#ocrd-models) from existing data.
See [README for `ocrd_modelfactory`](./README_ocrd_modelfactory.md) for further information.
### ocrd_validators
Schemas and routines for validating BagIt, `ocrd-tool.json`, workspaces, METS, page, CLI parameters etc.
See [README for `ocrd_validators`](./README_ocrd_validators.md) for further information.
### ocrd_network
Components related to OCR-D Web API
See [README for `ocrd_network`](./README_ocrd_network.md) for further information.
### ocrd
Depends on all of the above, also contains decorators and classes for creating OCR-D processors and CLIs.
Also contains the command line tool `ocrd`.
See [README for `ocrd`](./README_ocrd.md) for further information.
## bash library
Builds a bash script that can be sourced by other bash scripts to create OCRD-compliant CLI.
See [README for `bashlib`](./README_bashlib.md) for further information.
## Testing
Download assets (`make assets`)
Test with local files: `make test`
- Test with remote assets:
- `make test OCRD_BASEURL='https://github.com/OCR-D/assets/raw/master/data/'`
## See Also
- [OCR-D Specifications](https://https://ocr-d.de/en/spec/) ([Repo](https://github.com/ocr-d/spec))
- [OCR-D core API documentation](https://ocr-d.de/core) (built here via `make docs`)
- [OCR-D Website](https://ocr-d.de) ([Repo](https://github.com/ocr-d/ocrd-website))
Raw data
{
"_id": null,
"home_page": null,
"name": "ocrd",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Konstantin Baierer <unixprog@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/aa/26/329d27a10677033002411a4745ee9fd3f8ae635b9ef5a99733f448c09908/ocrd-2.70.0.tar.gz",
"platform": null,
"description": "# OCR-D/core\n\n> Python modules implementing [OCR-D specs](https://github.com/OCR-D/spec) and related tools\n\n[](https://pypi.org/project/ocrd/)\n[](https://github.com/OCR-D/core/actions/workflows/docker-image.yml)\n[](https://github.com/OCR-D/core/actions/workflows/unit-test.yml)\n[](https://codecov.io/gh/OCR-D/core)\n[](https://scrutinizer-ci.com/g/OCR-D/core)\n[](https://scrutinizer-ci.com/g/OCR-D/core)\n\n[](https://gitter.im/OCR-D/Lobby)\n\n\n<!-- BEGIN-MARKDOWN-TOC -->\n* [Introduction](#introduction)\n* [Installation](#installation)\n* [Command line tools](#command-line-tools)\n\t* [`ocrd` CLI](#ocrd-cli)\n\t* [`ocrd-dummy` CLI](#ocrd-dummy-cli)\n* [Configuration](#configuration)\n* [Packages](#packages)\n\t* [ocrd_utils](#ocrd_utils)\n\t* [ocrd_models](#ocrd_models)\n\t* [ocrd_modelfactory](#ocrd_modelfactory)\n\t* [ocrd_validators](#ocrd_validators)\n\t* [ocrd_network](#ocrd_network)\n\t* [ocrd](#ocrd)\n* [bash library](#bash-library)\n* [Testing](#testing)\n* [See Also](#see-also)\n\n<!-- END-MARKDOWN-TOC -->\n\n## Introduction\n\nThis repository contains the python packages that form the base for tools within the\n[OCR-D ecosphere](https://github.com/topics/ocr-d).\n\nAll packages are also published to [PyPI](https://pypi.org/search/?q=ocrd).\n\n## Installation\n\n**NOTE** Unless you want to contribute to OCR-D/core, we recommend installation\nas part of [ocrd_all](https://github.com/OCR-D/ocrd_all) which installs a\ncomplete stack of OCR-D-related software.\n\nThe easiest way to install is via `pip`:\n\n```sh\npip install ocrd\n\n# or just the functionality you need, e.g.\n\npip install ocrd_modelfactory\n```\n\nAll Python software released by [OCR-D](https://github.com/OCR-D) requires Python 3.8 or higher.\n\n**NOTE** Some OCR-D-Tools (or even test cases) _might_ reveal an unintended behavior if you have specific environment modifications, like:\n* using a custom build of [ImageMagick](https://github.com/ImageMagick/ImageMagick), whose format delegates are different from what OCR-D supposes\n* custom Python logging configurations in your personal account\n\n## Command line tools\n\n**NOTE:** All OCR-D CLI tools support a `--help` flag which shows usage and\nsupported flags, options and arguments.\n\n### `ocrd` CLI\n\n* [CLI usage](https://ocr-d.de/core/api/ocrd/ocrd.cli.html)\n* [Introduction to `ocrd workspace`](https://github.com/OCR-D/ocrd-website/wiki/Intro-ocrd-workspace-CLI)\n* [OCR-D user guide](https://ocr-d.de/en/use)\n\n### `ocrd-dummy` CLI\n\nA minimal [OCR-D processor](https://ocr-d.de/en/user_guide#using-the-ocr-d-processors) that copies from `-I/-input-file-grp` to `-O/-output-file-grp`\n\n## Configuration\n\nAlmost all behaviour of the OCR-D/core software is configured via CLI options and flags, which can be listed with the `--help` flag that all CLI support.\n\nSome parts of the software are configured via environment variables:\n\n* `OCRD_METS_CACHING`: If set to `true`, access to the METS file is cached, speeding in-memory search and modification.\n* `OCRD_PROFILE`: This variable configures the built-in CPU and memory profiling. If empty, no profiling is done. Otherwise expected to contain any of the following tokens:\n * `CPU`: Enable CPU profiling of processor runs\n * `RSS`: Enable RSS memory profiling\n * `PSS`: Enable proportionate memory profiling\n* `OCRD_PROFILE_FILE`: If set, then the CPU profile is written to this file for later peruse with a analysis tools like [snakeviz](https://jiffyclub.github.io/snakeviz/)\n\n* `PATH`: Search path for processor executables (affects `ocrd process` and `ocrd resmgr`).\n* `HOME`: Directory to look for `ocrd_logging.conf`, fallback for unset XDG variables (see below).\n\n* `XDG_CONFIG_HOME`: Directory to look for `./ocrd/resources.yml` (i.e. `ocrd resmgr` user database) \u2013 defaults to `$HOME/.config`.\n* `XDG_DATA_HOME`: Directory to look for `./ocrd-resources/*` (i.e. `ocrd resmgr` data location) \u2013 defaults to `$HOME/.local/share`.\n\n* `OCRD_DOWNLOAD_RETRIES`: Number of times to retry failed attempts for downloads of workspace files.\n* `OCRD_DOWNLOAD_TIMEOUT`: Timeout in seconds for connecting or reading (comma-separated) when downloading.\n\n* `OCRD_METS_CACHING`: Whether to enable in-memory storage of OcrdMets data structures for speedup during processing or workspace operations.\n\n* `OCRD_MAX_PROCESSOR_CACHE`: Maximum number of processor instances (for each set of parameters) to be kept in memory (including loaded models) for processing workers or processor servers.\n\n* `OCRD_NETWORK_SERVER_ADDR_PROCESSING`: Default address of Processing Server to connect to (for `ocrd network client processing`).\n* `OCRD_NETWORK_SERVER_ADDR_WORKFLOW`: Default address of Workflow Server to connect to (for `ocrd network client workflow`).\n* `OCRD_NETWORK_SERVER_ADDR_WORKSPACE`: Default address of Workspace Server to connect to (for `ocrd network client workspace`).\n* `OCRD_NETWORK_RABBITMQ_CLIENT_CONNECT_ATTEMPTS`: Number of attempts for a worker to create its queue. Helpful if the rabbitmq-server needs time to be fully started.\n\n\n## Packages\n\n### ocrd_utils\n\nContains utilities and constants, e.g. for logging, path normalization, coordinate calculation etc.\n\nSee [README for `ocrd_utils`](./README_ocrd_utils.md) for further information.\n\n### ocrd_models\n\nContains file format wrappers for PAGE-XML, METS, EXIF metadata etc.\n\nSee [README for `ocrd_models`](./README_ocrd_models.md) for further information.\n\n### ocrd_modelfactory\n\nCode to instantiate [models](#ocrd-models) from existing data.\n\nSee [README for `ocrd_modelfactory`](./README_ocrd_modelfactory.md) for further information.\n\n### ocrd_validators\n\nSchemas and routines for validating BagIt, `ocrd-tool.json`, workspaces, METS, page, CLI parameters etc.\n\nSee [README for `ocrd_validators`](./README_ocrd_validators.md) for further information.\n\n### ocrd_network\n\nComponents related to OCR-D Web API\n\nSee [README for `ocrd_network`](./README_ocrd_network.md) for further information.\n\n### ocrd\n\nDepends on all of the above, also contains decorators and classes for creating OCR-D processors and CLIs.\n\nAlso contains the command line tool `ocrd`.\n\nSee [README for `ocrd`](./README_ocrd.md) for further information.\n\n## bash library\n\nBuilds a bash script that can be sourced by other bash scripts to create OCRD-compliant CLI.\n\nSee [README for `bashlib`](./README_bashlib.md) for further information.\n\n## Testing\n\nDownload assets (`make assets`)\n\nTest with local files: `make test`\n\n- Test with remote assets:\n - `make test OCRD_BASEURL='https://github.com/OCR-D/assets/raw/master/data/'`\n\n## See Also\n\n - [OCR-D Specifications](https://https://ocr-d.de/en/spec/) ([Repo](https://github.com/ocr-d/spec))\n - [OCR-D core API documentation](https://ocr-d.de/core) (built here via `make docs`)\n - [OCR-D Website](https://ocr-d.de) ([Repo](https://github.com/ocr-d/ocrd-website))\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "OCR-D framework",
"version": "2.70.0",
"project_urls": {
"Documentation": "https://ocr-d.de/core",
"Homepage": "https://ocr-d.de",
"Issues": "https://github.com/OCR-D/core/issues",
"Repository": "https://github.com/OCR-D/core"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79e720343916c0a33a405888510405876f90a994d33be0ebf2534a53551ad493",
"md5": "27a4bf68b12c28b09a05afc747a8948b",
"sha256": "5ee05fca14803f10802dd28f144b2e4f786af2404eccdc4bb91ca774088ac736"
},
"downloads": -1,
"filename": "ocrd-2.70.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "27a4bf68b12c28b09a05afc747a8948b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 348465,
"upload_time": "2024-10-10T14:21:53",
"upload_time_iso_8601": "2024-10-10T14:21:53.464865Z",
"url": "https://files.pythonhosted.org/packages/79/e7/20343916c0a33a405888510405876f90a994d33be0ebf2534a53551ad493/ocrd-2.70.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aa26329d27a10677033002411a4745ee9fd3f8ae635b9ef5a99733f448c09908",
"md5": "79457addb41a4133ed9870962fe44db3",
"sha256": "128dab789d029385df073976d4f74b32debe22570b66e4b4de34295a9570d6d9"
},
"downloads": -1,
"filename": "ocrd-2.70.0.tar.gz",
"has_sig": false,
"md5_digest": "79457addb41a4133ed9870962fe44db3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 337582,
"upload_time": "2024-10-10T14:21:55",
"upload_time_iso_8601": "2024-10-10T14:21:55.630102Z",
"url": "https://files.pythonhosted.org/packages/aa/26/329d27a10677033002411a4745ee9fd3f8ae635b9ef5a99733f448c09908/ocrd-2.70.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 14:21:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCR-D",
"github_project": "core",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"circle": true,
"requirements": [],
"tox": true,
"lcname": "ocrd"
}
