AUTO-MULTIPLE-CHOI(1)

auto-multiple-choice-analyse 💅✨

hi bestie 🫶 welcome to the auto-multiple-choice manual page AUTO-MULTIPLE-CHOI(1) — section 1, the one that reads your scan files so you don't have to. pull up a chair, this one's a banger.

---

🎀 NAME 🎀

auto-multiple-choice-analyse — automatic data capture from scans for AMC multiple choice exams. it's giving "the computer grades the bubble sheets for you" and honestly? iconic. 👑

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

the auto-multiple-choice analyse command does automatic data capture from scans of completed answer sheets of an AMC multiple choice questionnaire. like, it looks at the scan, finds the boxes, figures out which ones got ticked. main character behaviour, fr fr.

bestie, listen: before you call auto-multiple-choice analyse, you should have already called auto-multiple-choice-prepare(1) to make the working documents (--mode s), and the layout should have been processed with auto-multiple-choice-meptex(1). do it out of order and you're gonna have a bad time. 😭

---

✨ the directory options ✨

• --data data-dir — tells you where the data files live (peep auto-multiple-choice-meptex(1) for an example). if you don't say anything, it defaults to project-dir/data.
• --cr project-cr-dir — gives a directory where the image reports of the data capture get created. and when we say reports we mean: zooms on the boxes in a zooms sub-directory, name field extraction as a name-*.jpg file, and the layout report as a page-*.jpg file. very demure, very mindful. 🎀
• --projet project-dir — when you use this one, and you did not use --cr, then project-cr-dir gets set to project-dir/cr for you. convenient bestie behaviour. 💖

---

📁 giving it your scan files 📁

there are two ways to hand over the names of the scan files to process, and you only need one:

• you can just give these names as arguments, or
• you can write these names into a plain file — one filename per line — and use --list-fichiers files-list.txt to give the name of that file.

---

🔥 the data capture parameters 🔥

some parameters for data capture can be set with these options:

• --prop proportion — sets the proportion of each box that gets measured to decide whether the box is ticked or not. default value is 0.8.
• --bw-threshold threshold — this parameter gets used when converting the grayscale scan file to black and white. want more black pixels? use a greater value. want more white pixels? use a smaller value. the threshold must be between 0 and 1. the default value is 0.6.
• --ignore-red — with this option, only the red channel will be used from color scans. so everything written in red gets ignored in the scan. lowkey useful when the boxes are printed in red. 🍓
• --tol-marque tol — defines the tolerance when detecting the four marks in the scan's corners. these marks get detected by looking for black connected components whose dimensions are close to the target dimension (that's the exact dimensions of the marks, if the printing/scanning process were perfectly accurate). if tol is a real number, the accepted dimensions are those between (1-tol)*target and (1+tol)*target. if tol is "tinf,tsup" (where tinf and tsup are real numbers), the accepted dimensions are those between (1-tinf)*target and (1+tsup)*target. a standard value is 0.2.
• --multiple — use this one when the scans are photocopies from some subjects (meaning different students can have the same subject). in that case, copy numbers get allocated to students so their answer sheets — with the same subject number — can be told apart. slay. 💅
• --pre-allocate copy_id — this one can be used together with --multiple. the copy numbers used for the scans will start from copy_id, in the same order as the scans given as arguments.
• --try-three | --no-try-three — use one of these to tell it whether you allow processing of scans where only three corner marks are present. 🙈
• --debug file.log — gives a file to fill with debugging information.

---

💜 AUTHORS 💜

• Alexis Bienvenüe <paamc@passoire.fr> — Main author 👑
• Anirvan Sarkar — Author and Editor
• Hiroto Kagotani — Editor
• Frédéric Bréal — Author and Editor
• Jean Bérard — Translation from French
• Georges Khaznadar — Translation from French

---

🌈 COPYRIGHT 🌈

Copyright © 2008-2025 Alexis Bienvenüe

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

---

and that's the whole page, bestie. no notes. periodt. ✨

Auto Multiple Choice 1.7.0 · 2025-04-17 — that's the version and the date, mwah 💋 go forth and analyse those scans, you absolute legend 🫶💖