AUTO-MULTIPLE-CHOI(1)

πŸ“¦ version 1.7.0, in arch rolling, nixpkgs unstable

πŸ’… AUTO-MULTIPLE-CHOI(1) β€” like, the auto-multiple-choice-analyse page, bestie

okay so real talk, this is the manual page for Auto Multiple Choice, and this specific one is auto-multiple-choice-analyse. Sounds fancy, is fancy. Let's get into it ✨

✨ 名前 (NAME) ✨

auto-multiple-choice-analyse β€” literally the thing that goes brrr on your scanned AMC multiple-choice answer sheets and automatically recognizes the marks 🎯 no manual counting, no tears, periodt.

🌸 概要 (SYNOPSIS) 🌸

auto-multiple-choice analyse --projet project-dir
                     [--seuil-coche threshold] [--tol-marque tol]
                     [--list-fichiers files-list.txt | scan-files...]

πŸ¦‹ 解θͺ¬ (DESCRIPTION) πŸ¦‹

okay so the auto-multiple-choice analyse command does automatic mark recognition on scanned images of AMC multiple-choice exam answer sheets. Iconic. But listen β€” you cannot just roll up in here and run it cold πŸ₯Ά. Before you even think about calling auto-multiple-choice analyse, you gotta:

  1. call auto-multiple-choice-prepare(1) first to create the work documents (--mode s) and the MEP files (--mode m), and
  2. process the layout with auto-multiple-choice-meptex(1).

That's the pipeline, respect the pipeline πŸ’œ

πŸ’– the directory options

  • --data data-dir β€” tells it where the data files live (peep auto-multiple-choice-meptex(1) and friends for context). Default is project-dir/data, easy.
  • --cr project-cr-dir β€” sets the directory where the images used for mark recognition get created. For the record: the zoomed box images land in the zooms subdirectory, the name-field images are stored as name-*.jpg files, and the layout result images are stored as page-*.jpg files. Very organized, we love a structured queen πŸ‘‘
  • --projet project-dir β€” if you're not using --cr, then passing this option sets project-cr-dir to project-dir/cr for you. Convenient!

πŸŽ€ how to tell it which scan files to process (two ways, pick one)

  • drop the filenames straight in as arguments, or
  • list the filenames in a plain file (one filename per line, fr fr) and point at that file with --list-fichiers files-list.txt.

🌈 the mark-recognition parameter options

  • --prop proportion β€” sets the proportion of the area of each box that gets used to decide whether there's a mark in it or not. Default value is 0.8.
  • --bw-threshold threshold β€” this one's used when converting grayscale scan images to black and white. Bigger value = more pixels get treated as black. Smaller value = more pixels get treated as white. The threshold must be between 0 and 1 (not optional, bestie 🚨). Default value is 0.6.
  • --ignore-red β€” with this option, only the red channel of a color scanned image is used. What that does: anything on the scan that was filled in with red gets completely ignored πŸ™ˆ. Super useful when the boxes themselves are printed in red.
  • --tol-marque tol β€” defines the tolerance when detecting the markers in the four corners of the scanned image. Detection works by hunting for black connected regions whose size is close to the target size target (the exact marker size you'd get if printing and scanning were absolutely perfect, which, lol, mood). If tol is a plain real number, a size counts as "close" if it's between (1-tol)*target and (1+tol)*target. If tol is in the "tinf,tsup" form (where tinf and tsup are real numbers), then the range is (1-tinf)*target to (1+tsup)*target. Standard value is 0.2.
  • --multiple β€” use this one when the exam questions were copied, i.e. several candidates could be answering the same exam questions. In that case each answer sheet gets assigned a copy number so the sheets sharing the same exam question number can be told apart πŸ‘―
  • --pre-allocate copy_id β€” this one goes together with --multiple. The copy number for each scan starts at copy_id and gets assigned in the same order as the scan images you passed as arguments.
  • --try-three | --no-try-three β€” says whether it should still process when only three of the four corner markers can be recognized. Sometimes life gives you three corners πŸ‹
  • --debug file.log β€” names the file where the debug info gets written.

πŸ‘‘ θ‘—θ€… (AUTHORS) πŸ‘‘

  • Bienvenue Alexis[FAMILY Given] <paamc@passoire.fr> β€” main author ✨
  • Sarkar Anirvan[FAMILY Given] β€” author and editor
  • Kagotani Hiroto[FAMILY Given] β€” editor
  • BrΓ©al FrΓ©dΓ©ric[FAMILY Given] β€” author and editor
  • BΓ©rard Jean[FAMILY Given] β€” French version β†’ English version translation
  • Khaznadar Georges[FAMILY Given] β€” French version β†’ English version translation
  • Kagotani Hiroto[FAMILY Given] β€” English version β†’ Japanese version translation

the multilingual teamwork?? we stan 🫢

Copyright Β© 2008-2018 Alexis BienvenΓΌe

This document can be used under the terms of the GNU General Public License version 2 or later.

heads up bestie: the license line is the actual legal bit, so don't go remixing it β€” GNU GPL v2 or later, exactly like it says πŸ’…

okay that's the whole page, you're basically an AMC mark-recognition expert now, no cap 🌟 mwah, go scan some sheets β€” this was Auto Multiple Choice 1.7.0, dated 2025-04-17, signing off from your favorite AUTO-MULTIPLE-CHOI(1) bestie πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from