A filled-in Circle answer sheet for Ahsan Mir, with 40 rows of bubbles

Bubble sheets, marked.

Circle reads the filled bubbles and the handwritten name on every sheet, checks them against your key and hands back the class in a spreadsheet.

Free. The scans never leave your computer.

Step 1: It sees ink, not paper.

Each pixel is judged against the 11 by 11 pixels around it, so a shadow across the page or a grey photocopy still separates cleanly into ink and paper.

Step 2: It finds the two answer grids.

Circle traces every outline on the page and keeps the three biggest. The leftmost is the instructions box, so it is set aside. The other two are straightened, even when the photo was taken at an angle.

Step 3: It measures all 200 bubbles.

Each bubble gets four tests: edge pixels, contrast, dark area and black area. The cut-offs come from this sheet alone, so a light pencil class and a heavy pen class are judged on their own terms. Two passes out of four means filled.

Edge pixels
< 631
Contrast (variance)
> 8,069
Dark area
> 19.0%
Black pixels
> 3,485

This sheet’s cut-offs. Row 3 has three bubbles that pass, so it is flagged, not guessed.

Step 4: It reads the name.

The first and last name rows are cut into 14 boxes. Each letter is cleaned up, scaled to 28 by 28 pixels and read by a small neural network. A letter it is less than 90% sure of is left out for you to check.

First name
  1. A1.00
  2. H0.91
  3. S1.00
  4. A1.00
  5. N1.00
Last name
  1. M1.00
  2. I0.99
  3. R1.00

Step 5: Then it marks.

Green where the student was right. Red on a wrong pick, with the right answer in yellow beside it. Yellow alone where the row was left blank or had more than one bubble filled.

  • Right 27
  • Wrong, right answer in yellow 5
  • Blank, or more than one filled 8

Now you set the key.

This is the same sheet and the same reading. Fill in a key and Circle marks it again on the spot.

27 of 40 correct

Skip the 40 key rows
  1. Question 1
  2. Question 2
  3. Question 3
  4. Question 4
  5. Question 5
  6. Question 6
  7. Question 7
  8. Question 8
  9. Question 9
  10. Question 10
  11. Question 11
  12. Question 12
  13. Question 13
  14. Question 14
  15. Question 15
  16. Question 16
  17. Question 17
  18. Question 18
  19. Question 19
  20. Question 20
  1. Question 21
  2. Question 22
  3. Question 23
  4. Question 24
  5. Question 25
  6. Question 26
  7. Question 27
  8. Question 28
  9. Question 29
  10. Question 30
  11. Question 31
  12. Question 32
  13. Question 33
  14. Question 34
  15. Question 35
  16. Question 36
  17. Question 37
  18. Question 38
  19. Question 39
  20. Question 40

That is the whole reader, running on one sheet. How Circle reads a sheet covers the details, or print the sheet and try it on your own class.

What you get back

  1. Marked sheets

    Every sheet comes back in green, red and yellow with the score in the corner. Download the whole class as one zip.

  2. Names from handwriting

    Names are read from the boxes students filled in, so the spreadsheet is labelled before you touch it. Fix any letter in one click.

    read as Ahsan Mir

  3. One spreadsheet

    A row per student with the name, the score and every answer, plus the key. It opens in Excel, Numbers and Google Sheets.

  4. Question by question

    How many got each question right, and which wrong option pulled the rest. A question most of the class missed is usually a question worth reading again.

  5. The last word is yours

    Rows with no answer or two answers are flagged. Look at the bubbles, set the answer yourself, and the score updates.

The scans stay on your computer.

Circle downloads its reader once, about 4 MB, and runs it inside this browser tab. Photos of your students’ sheets are never uploaded anywhere. Your account keeps the key, the names and the scores, so you can reopen a class next week.

Before you scan

  1. Print the Circle sheet at 100% on A4. Circle only reads this sheet.
  2. Students fill each bubble completely, with a blue or black pen.
  3. Names go in capitals, one letter per box. Circle reads A to Z.
  4. Scan or photograph each sheet flat, with both answer grids fully in the frame.
  5. Upload JPG, PNG or WebP files, or a zip of them.
  6. A test can have up to 40 questions, each with options A to E.

A filled bubble looks like this:

The blank Circle answer sheet: name boxes, the black band, and 40 rows of five bubbles
The Circle answer sheet. A4, one page.Download PDF