Deploy OCR/OMR backend to HF Spaces

.dockerignore

@@ -0,0 +1,6 @@
+.git
+.env
+.claude
+__pycache__
+*.pyc
+outputs/

.env.example

@@ -0,0 +1,10 @@
+# Required
+GEMINI_API_KEY=your_gemini_api_key
+SUPABASE_URL=your_supabase_project_url
+SUPABASE_ANON_KEY=your_supabase_anon_key
+
+# Optional (auto-detected on Linux, only needed for custom installs)
+# TESSERACT_CMD=/usr/bin/tesseract
+# POPPLER_PATH=/usr/bin
+# PORT=7860
+# FLASK_DEBUG=false

.gitattributes

@@ -1,35 +1,44 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+# Auto detect text files and perform LF normalization
+* text=auto
+Images/OCRSheet.jpg filter=lfs diff=lfs merge=lfs -text
+Images/OcrSheetMarked.jpg filter=lfs diff=lfs merge=lfs -text
+Images/omr_answer_key.pdf filter=lfs diff=lfs merge=lfs -text
+Images/omr_answer_key.png filter=lfs diff=lfs merge=lfs -text
+Images/OMRSheet.jpg filter=lfs diff=lfs merge=lfs -text
+Images/OMRSheet2.jpg filter=lfs diff=lfs merge=lfs -text
+Images/OMRSheet3.jpg filter=lfs diff=lfs merge=lfs -text
+Images/OMRTest.jpg filter=lfs diff=lfs merge=lfs -text
+Images/question_paper.png filter=lfs diff=lfs merge=lfs -text
+Images/test.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/inputs/OMRImage.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/outputs/CheckedOMRs/OcrSheetMarked.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/outputs/CheckedOMRs/OMRImage.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/outputs/CheckedOMRs/OMRSheet.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/outputs/Images/CheckedOMRs/OMRSheet.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/answer-key/weighted-answers/images/adrian_omr.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/Sandeep-1507/omr-1.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/Sandeep-1507/omr-2.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/Sandeep-1507/omr-3.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/Shamanth/omr_sheet_01.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UmarFarootAPS/scans/scan-type-1.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UmarFarootAPS/scans/scan-type-2.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UPSC-mock/answer_key.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UPSC-mock/scan-angles/angle-1.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UPSC-mock/scan-angles/angle-2.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/community/UPSC-mock/scan-angles/angle-3.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample1/MobileCamera/sheet1.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample2/AdrianSample/adrian_omr.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample3/colored-thick-sheet/rgb-100-gsm.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample3/xeroxed-thin-sheet/grayscale-80-gsm.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample4/IMG_20201116_143512.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample4/IMG_20201116_150717658.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample4/IMG_20201116_150750830.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample5/ScanBatch1/camscanner-1.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample5/ScanBatch2/camscanner-2.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample6/doc-scans/sample_roll_01.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample6/doc-scans/sample_roll_02.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample6/doc-scans/sample_roll_03.jpg filter=lfs diff=lfs merge=lfs -text
+OMRChecker/samples/sample6/reference.png filter=lfs diff=lfs merge=lfs -text
+OMRChecker/src/tests/test_samples/sample2/sample.jpg filter=lfs diff=lfs merge=lfs -text
+output/test_ocr_res_img.jpg filter=lfs diff=lfs merge=lfs -text
+output/test_preprocessed_img.jpg filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,188 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# App outputs
+outputs/
+.claude/
+
+# Temp/debug images
+Images/debug_*.png
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor  
+#  Cursor is an AI-powered code editor.`.cursorignore` specifies files/directories to 
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore

Dockerfile

@@ -0,0 +1,30 @@
+FROM python:3.11-slim
+
+# System deps: tesseract, poppler, opencv libs
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    tesseract-ocr \
+    poppler-utils \
+    libgl1 \
+    libglib2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install CPU-only PyTorch first (avoids ~4GB of NVIDIA CUDA libs)
+RUN pip install --no-cache-dir torch torchvision --index-url https://download.pytorch.org/whl/cpu
+
+# Install remaining Python deps
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Create required directories
+RUN mkdir -p OMRChecker/inputs outputs/Results outputs/CheckedOMRs outputs/Manual outputs/Evaluation Images
+
+# HF Spaces expects port 7860
+ENV PORT=7860
+EXPOSE 7860
+
+CMD ["python", "app.py"]

Images/omr_answer_key.pdf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:879c8f7aa369a6f0cbc65f9a5279a18ae42a35d541ba53e70b140178e83acf3f
+size 105714

OMRChecker/.pre-commit-config.yaml

@@ -0,0 +1,59 @@
+exclude: "__snapshots__/.*$"
+default_install_hook_types: [pre-commit, pre-push]
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: check-yaml
+        stages: [commit]
+      - id: check-added-large-files
+        args: ['--maxkb=300']
+        fail_fast: false
+        stages: [commit]
+      - id: pretty-format-json
+        args: ['--autofix', '--no-sort-keys']
+      - id: end-of-file-fixer
+        exclude_types: ["csv", "json"]
+        stages: [commit]
+      - id: trailing-whitespace
+        stages: [commit]
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+        stages: [commit]
+  - repo: https://github.com/psf/black
+    rev: 23.3.0
+    hooks:
+      - id: black
+        fail_fast: true
+        stages: [commit]
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.0.0
+    hooks:
+      - id: flake8
+        args:
+          - "--ignore=E501,W503,E203,E741,F541" # Line too long, Line break occurred before a binary operator, Whitespace before ':'
+        fail_fast: true
+        stages: [commit]
+  - repo: local
+    hooks:
+      - id: pytest-on-commit
+        name: Running single sample test
+        entry:  python3 -m pytest -rfpsxEX --disable-warnings --verbose -k sample1
+        language: system
+        pass_filenames: false
+        always_run: true
+        fail_fast: true
+        stages: [commit]
+  - repo: local
+    hooks:
+      - id: pytest-on-push
+        name: Running all tests before push...
+        entry: python3 -m pytest -rfpsxEX --disable-warnings --verbose --durations=3
+        language: system
+        pass_filenames: false
+        always_run: true
+        fail_fast: true
+        stages: [push]

OMRChecker/.pylintrc

@@ -0,0 +1,43 @@
+[BASIC]
+# Regular expression matching correct variable names. Overrides variable-naming-style.
+# snake_case with single letter regex -
+variable-rgx=[a-z0-9_]{1,30}$
+
+# Good variable names which should always be accepted, separated by a comma.
+good-names=x,y,pt
+
+[MESSAGES CONTROL]
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifiers separated by comma (,) or put this
+# option multiple times (only on the command line, not in the configuration
+# file where it should appear only once). You can also use "--disable=all" to
+# disable everything first and then reenable specific checks. For example, if
+# you want to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use "--disable=all --enable=classes
+# --disable=W".
+disable=import-error,
+        unresolved-import,
+        too-few-public-methods,
+        missing-docstring,
+        relative-beyond-top-level,
+        too-many-instance-attributes,
+        bad-continuation,
+        no-member
+
+# Note: bad-continuation is a false positive showing bug in pylint
+# https://github.com/psf/black/issues/48
+
+
+[REPORTS]
+# Set the output format. Available formats are text, parseable, colorized, json
+# and msvs (visual studio). You can also give a reporter class, e.g.
+# mypackage.mymodule.MyReporterClass.
+output-format=text
+
+# Tells whether to display a full report or only the messages.
+reports=no
+
+# Activate the evaluation score.
+score=yes

OMRChecker/CODE_OF_CONDUCT.md

@@ -0,0 +1,133 @@
+<!-- https://www.contributor-covenant.org/version/2/1/code_of_conduct/code_of_conduct.md -->
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

OMRChecker/CONTRIBUTING.md

@@ -0,0 +1,32 @@
+# How to contribute
+So you want to write code and get it landed in the official OMRChecker repository?
+First, fork our repository into your own GitHub account, and create a local clone of it as described in the installation instructions.
+The latter will be used to get new features implemented or bugs fixed.
+
+Once done and you have the code locally on the disk, you can get started. We advise you to not work directly on the master branch,
+but to create a separate branch for each issue you are working on. That way you can easily switch between different work,
+and you can update each one for the latest changes on the upstream master individually.
+
+
+# Writing Code
+For writing the code just follow the [Pep8 Python style](https://peps.python.org/pep-0008/) guide, If there is something unclear about the style, just look at existing code which might help you to understand it better.
+
+Also, try to use commits with [conventional messages](https://www.conventionalcommits.org/en/v1.0.0/#summary).
+
+
+# Code Formatting
+Before committing your code, make sure to run the following command to format your code according to the PEP8 style guide:
+```.sh
+pip install -r requirements.dev.txt && pre-commit install
+```
+
+Run `pre-commit` before committing your changes:
+```.sh
+git add .
+pre-commit run -a
+```
+
+# Where to contribute from
+
+- You can pickup any open [issues](https://github.com/Udayraj123/OMRChecker/issues) to solve.
+- You can also check out the [ideas list](https://github.com/users/Udayraj123/projects/2/views/1)

OMRChecker/Contributors.md

@@ -0,0 +1,22 @@
+# Contributors
+
+- [Udayraj123](https://github.com/Udayraj123)
+- [leongwaikay](https://github.com/leongwaikay)
+- [deepakgouda](https://github.com/deepakgouda)
+- [apurva91](https://github.com/apurva91)
+- [sparsh2706](https://github.com/sparsh2706)
+- [namit2saxena](https://github.com/namit2saxena)
+- [Harsh-Kapoorr](https://github.com/Harsh-Kapoorr)
+- [Sandeep-1507](https://github.com/Sandeep-1507)
+- [SpyzzVVarun](https://github.com/SpyzzVVarun)
+- [asc249](https://github.com/asc249)
+- [05Alston](https://github.com/05Alston)
+- [Antibodyy](https://github.com/Antibodyy)
+- [infinity1729](https://github.com/infinity1729)
+- [Rohan-G](https://github.com/Rohan-G)
+- [UjjwalMahar](https://github.com/UjjwalMahar)
+- [Kurtsley](https://github.com/Kurtsley)
+- [gaursagar21](https://github.com/gaursagar21)
+- [aayushibansal2001](https://github.com/aayushibansal2001)
+- [ShamanthVallem](https://github.com/ShamanthVallem)
+- [rudrapsc](https://github.com/rudrapsc)

OMRChecker/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024-present Udayraj Deshmukh and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

OMRChecker/README.md

@@ -0,0 +1,359 @@
+# OMR Checker
+
+Read OMR sheets fast and accurately using a scanner 🖨 or your phone 🤳.
+
+## What is OMR?
+
+OMR stands for Optical Mark Recognition, used to detect and interpret human-marked data on documents. OMR refers to the process of reading and evaluating OMR sheets, commonly used in exams, surveys, and other forms.
+
+#### **Quick Links**
+
+- [Installation](#getting-started)
+- [User Guide](https://github.com/Udayraj123/OMRChecker/wiki)
+- [Contributor Guide](https://github.com/Udayraj123/OMRChecker/blob/master/CONTRIBUTING.md)
+- [Project Ideas List](https://github.com/users/Udayraj123/projects/2/views/1)
+
+<hr />
+
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Udayraj123/OMRChecker/pull/new/master) <!-- [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-brightgreen.svg)](https://github.com/Udayraj123/OMRChecker/wiki/TODOs) -->
+[![GitHub pull-requests closed](https://img.shields.io/github/issues-pr-closed/Udayraj123/OMRChecker.svg)](https://github.com/Udayraj123/OMRChecker/pulls?q=is%3Aclosed)
+[![GitHub issues-closed](https://img.shields.io/github/issues-closed/Udayraj123/OMRChecker.svg)](https://GitHub.com/Udayraj123/OMRChecker/issues?q=is%3Aissue+is%3Aclosed)
+[![Ask me](https://img.shields.io/badge/Discuss-on_Github-purple.svg?style=flat-square)](https://github.com/Udayraj123/OMRChecker/issues/5)
+
+<!-- [![GitHub contributors](https://img.shields.io/github/contributors/Udayraj123/OMRChecker.svg)](https://GitHub.com/Udayraj123/OMRChecker/graphs/contributors/) -->
+
+[![GitHub stars](https://img.shields.io/github/stars/Udayraj123/OMRChecker.svg?style=social&label=Stars✯)](https://GitHub.com/Udayraj123/OMRChecker/stargazers/)
+[![Join](https://img.shields.io/badge/Join-Discord_group-purple.svg?style=flat-square)](https://discord.gg/qFv2Vqf)
+
+<!-- [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/gist/Udayraj123/a125b1531c61cceed5f06994329cba66/omrchecker-on-cloud.ipynb) -->
+
+## 🎯 Features
+
+A full-fledged OMR checking software that can read and evaluate OMR sheets scanned at any angle and having any color.
+
+| Specs <img width=200/> | ![Current_Speed](https://img.shields.io/badge/Speed-200+_OMRs/min-blue.svg?style=flat-square) ![Min Resolution](https://img.shields.io/badge/Min_Resolution-640x480-blue.svg?style=flat-square) <img width=200/> |
+| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 💯 **Accurate**        | Currently nearly 100% accurate on good quality document scans; and about 90% accurate on mobile images.                                                                                                          |
+| 💪🏿 **Robust**          | Supports low resolution, xeroxed sheets. See [**Robustness**](https://github.com/Udayraj123/OMRChecker/wiki/Robustness) for more.                                                                                |
+| ⏩ **Fast**            | Current processing speed without any optimization is 200 OMRs/minute.                                                                                                                                            |
+| ✅ **Customizable**    | [Easily apply](https://github.com/Udayraj123/OMRChecker/wiki/User-Guide) to custom OMR layouts, surveys, etc.                                                                                                    |
+| 📊 **Visually Rich**   | [Get insights](https://github.com/Udayraj123/OMRChecker/wiki/Rich-Visuals) to configure and debug easily.                                                                                                        |
+| 🎈 **Lightweight**     | Very minimal core code size.                                                                                                                                                                                     |
+| 🏫 **Large Scale**     | Tested on a large scale at [Technothlon](https://en.wikipedia.org/wiki/Technothlon).                                                                                                                             |
+| 👩🏿‍💻 **Dev Friendly**    | [Pylinted](http://pylint.pycqa.org/) and [Black formatted](https://github.com/psf/black) code. Also has a [developer community](https://discord.gg/qFv2Vqf) on discord.                                          |
+
+Note: For solving interesting challenges, developers can check out [**TODOs**](https://github.com/Udayraj123/OMRChecker/wiki/TODOs).
+
+See the complete guide and details at [Project Wiki](https://github.com/Udayraj123/OMRChecker/wiki/).
+
+<!-- 💁🏿‍♂️ **User Friendly** - WIP, Help by contributing! -->
+
+## 💡 What can OMRChecker do for me?
+
+Once you configure the OMR layout, just throw images of the sheets at the software; and you'll get back the marked responses in an excel sheet!
+
+Images can be taken from various angles as shown below-
+
+<p align="center">
+	<img alt="sample_input" width="400" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/Progress/2019-04-26/images/sample_input.PNG">
+</p>
+
+### Code in action on images taken by scanner:
+
+<p align="center">
+	<img alt="document_scanner" height="300" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/mini_scripts/outputs/gif/document_scanner.gif">
+
+</p>
+
+### Code in action on images taken by a mobile phone:
+
+<p align="center">
+	<img alt="checking_xeroxed_mobile" height="300" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/mini_scripts/outputs/gif/checking_xeroxed_mobile.gif">
+</p>
+
+## Visuals
+
+### Processing steps
+
+See step-by-step processing of any OMR sheet:
+
+<p align="center">
+	<a href="https://github.com/Udayraj123/OMRChecker/wiki/Rich-Visuals">
+		<img alt="rotation_stack" width="650" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/Progress/2019-04-26/images/rotation.PNG">
+	</a>
+	<br>
+	*Note: This image is generated by the code itself!*
+</p>
+
+### Output
+
+Get a CSV sheet containing the detected responses and evaluated scores:
+
+<p align="center">
+	<a href="https://github.com/Udayraj123/OMRChecker/wiki/Rich-Visuals">
+		<img alt="csv_output" width="550" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/Progress/2019-04-26/images/csv_output.PNG">
+	</a>
+</p>
+
+We now support [colored outputs](https://github.com/Udayraj123/OMRChecker/wiki/%5Bv2%5D-About-Evaluation) as well. Here's a sample output on another image -
+<p align="center">
+	<a href="https://github.com/Udayraj123/OMRChecker/wiki/%5Bv2%5D-About-Evaluation">
+		<img alt="colored_output" width="550" src="./docs/assets/colored_output.jpg">
+	</a>
+</p>
+
+#### There are many more visuals in the wiki. Check them out [here!](https://github.com/Udayraj123/OMRChecker/wiki/Rich-Visuals)
+
+## Getting started
+
+![Setup Time](https://img.shields.io/badge/Setup_Time-20_min-blue.svg)
+
+**Operating system:** OSX or Linux is recommended although Windows is also supported.
+
+### 1. Install global dependencies
+
+![opencv 4.0.0](https://img.shields.io/badge/opencv-4.0.0-blue.svg) ![python 3.5+](https://img.shields.io/badge/python-3.5+-blue.svg)
+
+To check if python3 and pip is already installed:
+
+```bash
+python3 --version
+python3 -m pip --version
+```
+
+<details>
+	<summary><b>Install Python3</b></summary>
+
+To install python3 follow instructions [here](https://www.python.org/downloads/)
+
+To install pip - follow instructions [here](https://pip.pypa.io/en/stable/installation/)
+
+</details>
+<details>
+<summary><b>Install OpenCV</b></summary>
+
+**Any installation method is fine.**
+
+Recommended:
+
+```bash
+python3 -m pip install --user --upgrade pip
+python3 -m pip install --user opencv-python
+python3 -m pip install --user opencv-contrib-python
+```
+
+More details on pip install openCV [here](https://www.pyimagesearch.com/2018/09/19/pip-install-opencv/).
+
+</details>
+
+<details>
+
+<summary><b>Extra steps(for Linux users only)</b></summary>
+
+<b>Installing missing libraries(if any):</b>
+
+On a fresh computer, some of the libraries may get missing in event after a successful pip install. Install them using following commands[(ref)](https://www.pyimagesearch.com/2018/05/28/ubuntu-18-04-how-to-install-opencv/):
+
+```bash
+sudo apt-get install -y build-essential cmake unzip pkg-config
+sudo apt-get install -y libjpeg-dev libpng-dev libtiff-dev
+sudo apt-get install -y libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
+sudo apt-get install -y libatlas-base-dev gfortran
+```
+
+</details>
+
+### 2. Install project dependencies
+
+Clone the repo
+
+```bash
+git clone https://github.com/Udayraj123/OMRChecker
+cd OMRChecker/
+```
+
+Install pip requirements
+
+```bash
+python3 -m pip install --user -r requirements.txt
+```
+
+_**Note:** If you face a distutils error in pip, use `--ignore-installed` flag in above command._
+
+<!-- Wiki should not get cloned -->
+
+### 3. Run the code
+
+1. First copy and examine the sample data to know how to structure your inputs:
+   ```bash
+   cp -r ./samples/sample1 inputs/
+   # Note: you may remove previous inputs (if any) with `mv inputs/* ~/.trash`
+   # Change the number N in sampleN to see more examples
+   ```
+2. Run OMRChecker:
+   ```bash
+   python3 main.py
+   ```
+
+Alternatively you can also use `python3 main.py -i ./samples/sample1`.
+
+Each example in the samples folder demonstrates different ways in which OMRChecker can be used.
+
+### Common Issues
+
+<details>
+<summary>
+	1. [Windows] ERROR: Could not open requirements file<br>
+	</summary>
+Command: <code>python3 -m pip install --user -r requirements.txt</code>
+<br>
+	Link to Solution:  <a href="https://github.com/Udayraj123/OMRChecker/issues/54#issuecomment-1264569006">#54</a>
+</details>
+<details>
+<summary>
+2. [Linux] ERROR: No module named pip<br>
+</summary>
+Command: <code>python3 -m pip install --user --upgrade pip</code>
+<br>
+	Link to Solution: <a href="https://github.com/Udayraj123/OMRChecker/issues/70#issuecomment-1268094136">#70</a>
+</details>
+
+## OMRChecker for custom OMR Sheets
+
+1. First, [create your own template.json](https://github.com/Udayraj123/OMRChecker/wiki/User-Guide).
+2. Configure the tuning parameters.
+3. Run OMRChecker with appropriate arguments (See full usage).
+<!-- 4. Add answer key( TODO: add answer key/marking scheme guide)  -->
+
+## Full Usage
+
+```
+python3 main.py [--setLayout] [--inputDir dir1] [--outputDir dir1]
+```
+
+Explanation for the arguments:
+
+`--setLayout`: Set up OMR template layout - modify your json file and run again until the template is set.
+
+`--inputDir`: Specify an input directory.
+
+`--outputDir`: Specify an output directory.
+
+<details>
+<summary>
+ <b>Deprecation logs</b>
+</summary>
+
+- The old `--noCropping` flag has been replaced with the 'CropPage' plugin in "preProcessors" of the template.json(see [samples](https://github.com/Udayraj123/OMRChecker/tree/master/samples)).
+- The `--autoAlign` flag is deprecated due to low performance on a generic OMR sheet
+- The `--template` flag is deprecated and instead it's recommended to keep the template file at the parent folder containing folders of different images
+</details>
+
+<!-- #### Testing the code
+Datasets to test on :
+Low Quality Dataset(For CV Based methods)) (1.5 GB)
+Standard Quality Dataset(For ML Based methods) (3 GB)
+High Quality Dataset(For custom processing) (6 GB)
+-->
+
+## FAQ
+
+<details>
+<summary>
+<b>Why is this software free?</b>
+</summary>
+
+This project was born out of a student-led organization called as [Technothlon](https://technothlon.techniche.org.in). It is a logic-based international school championship organized by students of IIT Guwahati. Being a non-profit organization, and after seeing it work fabulously at such a large scale we decided to share this tool with the world. The OMR checking processes still involves so much tediousness which we aim to reduce dramatically.
+
+We believe in the power of open source! Currently, OMRChecker is in an intermediate stage where only developers can use it. We hope to see it become more user-friendly as well as robust from exposure to different inputs from you all!
+
+[![Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
+
+</details>
+
+<details>
+<summary>
+<b>Can I use this code in my (public) work?</b>
+</summary>
+
+OMRChecker can be forked and modified. You are encouraged to play with it and we would love to see your own projects in action!
+
+It is published under the [MIT license](https://github.com/Udayraj123/OMRChecker/blob/master/LICENSE).
+
+</details>
+
+<details>
+<summary>
+<b>What are the ways to contribute?</b>
+</summary>
+
+<!-- - Help OMRChecker reach more people by giving a star! The Goal is to reach top position for the [OMR Topic](https://github.com/topics/omr) -->
+
+- Join the developer community on [Discord](https://discord.gg/qFv2Vqf) to fix [issues](https://github.com/Udayraj123/OMRChecker/issues) with OMRChecker.
+
+- If this project saved you large costs on OMR Software licenses, or saved efforts to make one. Consider donating an amount of your choice(donate section).
+
+<!-- ![☕](https://miro.medium.com/fit/c/256/256/1*br7aoq_JVfxeg73x5tF_Sw.png) -->
+<!-- [![paypal.me](https://www.paypalobjects.com/en_GB/i/btn/btn_donate_SM.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Z5BNNK7AVFVH8&source=url) -->
+<!-- https://www.amazon.in/hz/wishlist/ls/3V0TDQBI3T8IL -->
+
+</details>
+
+## Credits
+
+_A Huge thanks to:_
+_**Adrian Rosebrock** for his exemplary blog:_ https://pyimagesearch.com
+
+_**Harrison Kinsley** aka sentdex for his [video tutorials](https://www.youtube.com/watch?v=Z78zbnLlPUA&list=PLQVvvaa0QuDdttJXlLtAJxJetJcqmqlQq) and many other resources._
+
+_**Satya Mallic** for his resourceful blog:_ https://www.learnopencv.com
+
+_And to other amazing people from all over the globe who've made significant improvements in this project._
+
+_Thank you!_
+
+<!--
+OpencV
+matplotlib
+some SO answers from roughworks
+prof
+-->
+
+## Related Projects
+
+Here's a snapshot of the [Android OMR Helper App (archived)](https://github.com/Udayraj123/AndroidOMRHelper):
+
+<p align="center">
+	<a href="https://github.com/Udayraj123/AndroidOMRHelper">
+		<img height="300" src="https://raw.githubusercontent.com/wiki/Udayraj123/OMRChecker/extras/Progress/2019-04-26/images/app_flow.PNG">
+	</a>
+</p>
+
+## Stargazers over time
+
+[![Stargazers over time](https://starchart.cc/Udayraj123/OMRChecker.svg)](https://starchart.cc/Udayraj123/OMRChecker)
+
+---
+
+<h2 align="center">Made with ❤️ by Awesome Contributors</h2>
+
+<a href="https://github.com/Udayraj123/OMRChecker/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Udayraj123/OMRChecker" />
+</a>
+
+---
+
+### License
+
+[![GitHub license](https://img.shields.io/github/license/Udayraj123/OMRChecker.svg)](https://github.com/Udayraj123/OMRChecker/blob/master/LICENSE)
+
+For more details see [LICENSE](https://github.com/Udayraj123/OMRChecker/blob/master/LICENSE).
+
+### Donate
+
+<a href="https://www.buymeacoffee.com/Udayraj123" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a> [![paypal](https://www.paypalobjects.com/en_GB/i/btn/btn_donate_LG.gif)](https://www.paypal.me/Udayraj123/500)
+
+_Find OMRChecker on_ [**_Product Hunt_**](https://www.producthunt.com/posts/omr-checker/) **|** [**_Reddit_**](https://www.reddit.com/r/computervision/comments/ccbj6f/omrchecker_grade_exams_using_python_and_opencv/) **|** [**Discord**](https://discord.gg/qFv2Vqf) **|** [**Linkedin**](https://www.linkedin.com/pulse/open-source-talks-udayraj-udayraj-deshmukh/) **|** [**goodfirstissue.dev**](https://goodfirstissue.dev/language/python) **|** [**codepeak.tech**](https://www.codepeak.tech/) **|** [**fossoverflow.dev**](https://fossoverflow.dev/projects) **|** [**Interview on Console by CodeSee**](https://console.substack.com/p/console-140) **|** [**Open Source Hub**](https://opensourcehub.io/udayraj123/omrchecker)
+
+ <!-- [***Hacker News***](https://news.ycombinator.com/item?id=20420602) **|** -->
+ <!-- **|** [***Swyya***](https://www.swyya.com/projects/omrchecker) -->

OMRChecker/inputs/template.json

@@ -0,0 +1,37 @@
+{
+  "pageDimensions": [
+    1122,
+    1600
+  ],
+  "bubbleDimensions": [
+    48,
+    50
+  ],
+  "fieldBlocks": {
+    "q01block": {
+      "origin": [
+        100,
+        175
+      ],
+      "bubblesGap": 55,
+      "labelsGap": 67,
+      "fieldLabels": [
+        "q1..10"
+      ],
+      "fieldType": "QTYPE_MCQ4"
+    },
+    "q02block": {
+      "origin": [
+        100,
+        845
+      ],
+      "bubblesGap": 58,
+      "labelsGap": 70,
+      "fieldLabels": [
+        "q11..20"
+      ],
+      "fieldType": "QTYPE_MCQ4"
+    }
+  }
+  
+}

OMRChecker/main.py

@@ -0,0 +1,99 @@
+"""
+
+ OMRChecker
+
+ Author: Udayraj Deshmukh
+ Github: https://github.com/Udayraj123
+
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+from src.entry import entry_point
+from src.logger import logger
+
+
+def parse_args():
+    # construct the argument parse and parse the arguments
+    argparser = argparse.ArgumentParser()
+
+    argparser.add_argument(
+        "-i",
+        "--inputDir",
+        default=["inputs"],
+        # https://docs.python.org/3/library/argparse.html#nargs
+        nargs="*",
+        required=False,
+        type=str,
+        dest="input_paths",
+        help="Specify an input directory.",
+    )
+
+    argparser.add_argument(
+        "-d",
+        "--debug",
+        required=False,
+        dest="debug",
+        action="store_false",
+        help="Enables debugging mode for showing detailed errors",
+    )
+
+    argparser.add_argument(
+        "-o",
+        "--outputDir",
+        default="outputs",
+        required=False,
+        dest="output_dir",
+        help="Specify an output directory.",
+    )
+
+    argparser.add_argument(
+        "-a",
+        "--autoAlign",
+        required=False,
+        dest="autoAlign",
+        action="store_true",
+        help="(experimental) Enables automatic template alignment - \
+        use if the scans show slight misalignments.",
+    )
+
+    argparser.add_argument(
+        "-l",
+        "--setLayout",
+        required=False,
+        dest="setLayout",
+        action="store_true",
+        help="Set up OMR template layout - modify your json file and \
+        run again until the template is set.",
+    )
+
+    (
+        args,
+        unknown,
+    ) = argparser.parse_known_args()
+
+    args = vars(args)
+
+    if len(unknown) > 0:
+        logger.warning(f"\nError: Unknown arguments: {unknown}", unknown)
+        argparser.print_help()
+        exit(11)
+    return args
+
+
+def entry_point_for_args(args):
+    if args["debug"] is True:
+        # Disable tracebacks
+        sys.tracebacklimit = 0
+    for root in args["input_paths"]:
+        entry_point(
+            Path(root),
+            args,
+        )
+
+
+if __name__ == "__main__":
+    args = parse_args()
+    entry_point_for_args(args)

OMRChecker/outputs/AdrianSample/Manual/ErrorFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5"

OMRChecker/outputs/AdrianSample/Manual/MultiMarkedFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5"

OMRChecker/outputs/AdrianSample/Results/Results_07PM.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5"

OMRChecker/outputs/Images/Manual/ErrorFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/outputs/Images/Manual/MultiMarkedFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/outputs/Images/Results/Results_10PM.csv

@@ -0,0 +1,2 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"
+"OMRSheet.jpg","inputs\Images\OMRSheet.jpg","outputs\Images\CheckedOMRs\OMRSheet.jpg","0","C","D","A","C","B","C","C","D","D","B","B","B","D","C","C","ABCD","B","ABCD","C","ABCD"

OMRChecker/outputs/Manual/ErrorFiles.csv

@@ -0,0 +1,3 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"
+"OMRSheet.jpg","inputs\OMRSheet.jpg","outputs\Manual\ErrorFiles\OMRSheet.jpg","NA","","","","","","","","","","","","","","","","","","","",""
+"OMRSheet.jpg","inputs\OMRSheet.jpg","outputs\Manual\ErrorFiles\OMRSheet.jpg","NA","","","","","","","","","","","","","","","","","","","",""

OMRChecker/outputs/Manual/MultiMarkedFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/outputs/MobileCamera/Manual/ErrorFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","Roll","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/outputs/MobileCamera/Manual/MultiMarkedFiles.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","Roll","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/outputs/MobileCamera/Results/Results_09PM.csv

@@ -0,0 +1 @@
+"file_id","input_path","output_path","score","Roll","q1","q2","q3","q4","q5","q6","q7","q8","q9","q10","q11","q12","q13","q14","q15","q16","q17","q18","q19","q20"

OMRChecker/pyproject.toml

@@ -0,0 +1,18 @@
+[tool.black]
+exclude = '''
+(
+  /(
+      \.eggs         # exclude a few common directories in the
+    | \.git          # root of the project
+    | \.venv
+    | _build
+    | build
+    | dist
+  )/
+  | foo.py           # also separately exclude a file named foo.py in
+                     # the root of the project
+)
+'''
+include = '\.pyi?$'
+line-length = 88
+target-version = ['py37']

OMRChecker/pytest.ini

@@ -0,0 +1,6 @@
+# pytest.ini
+[pytest]
+minversion = 7.0
+addopts = -qq --capture=no
+testpaths =
+    src/tests

OMRChecker/requirements.dev.txt

@@ -0,0 +1,7 @@
+-r requirements.txt
+flake8>=6.0.0
+freezegun>=1.2.2
+pre-commit>=3.3.3
+pytest-mock>=3.11.1
+pytest>=7.4.0
+syrupy>=4.0.4

OMRChecker/requirements.txt

@@ -0,0 +1,8 @@
+deepmerge>=1.1.0
+dotmap>=1.3.30
+jsonschema>=4.17.3
+matplotlib>=3.7.1
+numpy>=1.25.0
+pandas>=2.0.2
+rich>=13.4.2
+screeninfo>=0.8.1