task.md

OMR Scanner Development Task List

• Planning & Setup
  • Explore existing demo_omr.py to understand layout.
  • Create implementation plan.
• Synthetic Data Generation
  • Refactor demo_omr.py for reusability.
  • Create src/generate_test_image.py to create a filled OMR sheet image mimicking the PDF layout.
  • Verify the generated image matches constraints (dimensions, bubble positions).
• Documentation
  • Create comprehensive README.md.
• OMR Scanner Implementation
  • Create src/omr_scanner.py.
  • Implement image loading and preprocessing (grayscale, thresholding).
  • Implement ROI extraction (finding the specific question blocks).
  • Implement bubble detection logic (finding marked bubbles).
  • processing logic for Roll Number.
  • processing logic for Subject Questions.
• Data Export & Analysis
  • Implement CSV export of scanned data.
  • Create src/analyze_results.py for basic analysis (scoring, stats).
• Verification
  • Test scanner with synthetic images.
  • Verify accuracy and handle edge cases (empty bubbles, double marking).