Skip to main content

Bubble Vision: Optical Mark Reader

Extract answer choices from scanned jpg bubble forms.

Graphical User Interface

$ omrcmd.py

Command Line

$ omrcmd.py [options] imagedir
imagedir

Input image directory (front side). Lowest numbered image identifies the key.

–backdir=BACKDIR

Optional back side image directory

–form=FORM

Set the form string (default and only supported=”882E”)

–help

Show this help message and exit

Output

validation images

Answer bubble means and reference box fits drawn over each input image.

results.xlsx
summary

Image path, name box image, and total score for each test.

questioninfo

Answer choice counts by question. Key excluded.

scoring

Answer choice matches key (0/1). Same indices as choices. Score is 0 if key is -1.

choices

Answer choice matrix. Tests in rows and questions in columns. 0-4=A-E, -1=n/a.

Install

$ pip install omr
$ pip install --upgrade omr
$ pip uninstall omr

Example Validation Image

https://raw.github.com/GregoryCMiller/omr/master/ExampleValidation.jpg

Troubleshooting

  • Windows

    • $ omrcmd.py --help gives omrcmd.py: error: too few arguments

      • fix argument passing to “py” file associations from python %1 to python %1 %*

    • unable to find vcvarsall.bat

      • I was able to use $ easy_install Pillow when pip failed to install Pillow 2.2.1

Author

Greg Miller gmill002@gmail.com

Metadata

Release files for omr 0.0.73

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for omr 0.0.73
File Size Uploaded Provenance Actions
omr-0.0.73.tar.gz 11.9 kB Without provenance Details for omr-0.0.73.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for omr 0.0.73
File Interpreter ABI Platform Actions
omr-0.0.73.linux-x86_64.tar.gz Details for omr-0.0.73.linux-x86_64.tar.gz

Total release size: 35.6 kB

Release files / omr-0.0.73.tar.gz

Download URL omr-0.0.73.tar.gz
Size 11.9 kB
Tags Source
SHA-256 checksum
How to use checksums
8feca62c1ceab22aeebe74533960f51d32813943195ba0f05dc73f1e3231374f
BLAKE2b-256 checksum
How to use checksums
3cf37dc710fbb164e87156534bd99ba87622ec324e54d0cd5f700f3064f71ed8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / omr-0.0.73.linux-x86_64.tar.gz

Download URL omr-0.0.73.linux-x86_64.tar.gz
Size 23.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ccac7a09c27233548155362766af7a83a82b331fa4544239cf3fdc7cdc7fe3f0
BLAKE2b-256 checksum
How to use checksums
e4a8e1a87320696286274506538696787e294d62fb1d4f9f41578c8e9db8bb40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for omr 0.0.73

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page