Udayraj123 / OMRChecker

Evaluate OMR sheets fast and accurately using a scanner 🖨 or your phone 🤳.
MIT License
766 stars 318 forks source link

[Beginner][Getting Familiar] Submit your sample image and template! #40

Open Udayraj123 opened 2 years ago

Udayraj123 commented 2 years ago

As you setup OMRChecker and run samples according to the Readme, you would maybe want to try it on new public images or some of your own. This issue is created to accept new submissions. This is your chance to feature your template and image in the samples section!

Where can I find OMR sheets? (ideas)

Steps to follow -

  1. Pick any OMR sheet image(s) that you can use publicly.
  2. Design a template overlay for the image(using --setLayout flag). Discuss on discord for any issues faced.
  3. Make sure to see it generates correct output. Rename images properly.
  4. Compress your images to jpg 80% - this will keep cloning the repository less bandwidth consuming.
  5. Put it in samples/community folder and raise a PR.

Note: this issue is marked with the hacktoberfest label. Follow #hacktoberfest-discussions on Discord for further details .

P.S. We are looking for someone to make template for popular examinations like JEE or UPSC in case of India.

issac5693 commented 2 years ago

should the sample image be a omr one ad what is a template

Udayraj123 commented 2 years ago

@issac5693 Yes it should look like any of the existing samples.

what is a template A template.json file is needed for OMRChecker to identify the bubble positions to use (see image)

image

Checkout User Guide for more details

You can find both template json files and sample images here: https://github.com/Udayraj123/OMRChecker/tree/master/samples

Antibodyy commented 2 years ago

Hello there. Can you assign me this issue?

Udayraj123 commented 2 years ago

Hi @Antibodyy can you create a PR or a draft PR for this? Then I can assign it to you. Hope you've started a discussion discord as well

sandptel commented 2 years ago

@Udayraj123 I want to try this same with a sample NEET 2022 OMR sheet,it can be shown publicaly.Should I do it?

Udayraj123 commented 2 years ago

@Sandeep-1507 that would be great actually! As long as you can reference its source where you got the image from. We should be fine. Also we can avoid showing any student name, if present we can blur it.

Udayraj123 commented 2 years ago

linking https://github.com/Udayraj123/OMRChecker/pull/64

sandptel commented 2 years ago

Can I add more samples? @Udayraj123

Udayraj123 commented 2 years ago

yes can do! just make sure there's some new varieties

Udayraj123 commented 2 years ago

Added ideas for different types of OMR sheets.

ShamanthVallem commented 1 year ago

Hello @Udayraj123 can I take this issue?

amankumar003 commented 1 year ago

hello @Udayraj123 I want to add my contribution to this repo by adding contribution to this my first issue, can you assign this to me ??

Udayraj123 commented 1 year ago

Sure you can go ahead. Prepare a template for a new OMR Sheet

Udayraj123 commented 1 year ago

@ShamanthVallem I saw your PR, I think it can qualify just go through Contributing.md

ShamanthVallem commented 1 year ago

@Udayraj123 please review my PR #108, I updated the template.json file

RohanHBTU commented 1 year ago

@Udayraj123 please review my PR #110 and share the required improvements.

Udayraj123 commented 1 year ago

In case anyone wants to work on a new template - check this Survey template: https://www.cse.iitd.ac.in/~aseth/udai/OMRProj/test/2circle-3-small.gif

sunnanxuan commented 8 months ago

Hello , I am new developer and looking to do my 1st contribution here. I came across this issue and am very interested in contributing to the project by providing the requested sample image. I hope I can use this issue to help me familiar with the process to solve issues on github with fork, clone, commit, push and pull request

Udayraj123 commented 8 months ago

Hello @sunnanxuan, welcome to the OMRChecker community! Sure, try out the instructions in Readme and share your sample once you get the setup ready. Feel free to join the discord channel for quicker updates :)

Udayraj123 commented 7 months ago

Adding links to a few public images of OMR sheets :

Dxuian commented 3 weeks ago

still open ?

Udayraj123 commented 3 weeks ago

Hey @Dxuian, yes it's a continuous issue i.e. 1 PR per sample. We're still looking for a variety of samples to be added. If you pick this up, please make sure the image size is compressed and under 1500 pixels in width.

Dxuian commented 3 weeks ago

ive added #227 please review

samuelIkoli commented 3 days ago

@Udayraj123 I made a PR for a sample document, please review 🙏 .

Udayraj123 commented 2 days ago

Hey @samuelIkoli, thanks for the submission. You may check my review comments

samuelIkoli commented 20 hours ago

[Feature] Support for sortType and sortOrder in outputColumns #209

Thank you very much for the reply, I have checked your review comments and worked on them.