AUTO-MULTIPLE-CHOI(1)

💅 NAME 💅

auto-multiple-choice-note — the little legend that computes marks after scans data capture for AMC multiple choice exams. Yes bestie, this is the glow-up step where all those ticked boxes finally become numbers. 🎀

This is a page from the Auto Multiple Choice manual, and honestly? It's giving "math teacher but make it iconic". ✨

---

🦋 SYNOPSIS 🦋

auto-multiple-choice note --data project-data-dir [--seuil threshold]
                     [--grain granularity] [--arrondi rounding]
                     [--notemin min] [--notemax max] [--no-plafond |
                     --plafond]

---

🌸 DESCRIPTION 🌸

Okay so. The auto-multiple-choice note command computes marks for all students, and it does that using two things:

• the scoring strategy extracted from the LaTeX source file by auto-multiple-choice-prepare(1) 👑
• the data capture reports made by auto-multiple-choice-analyse(1) 📝

That's it, that's the whole job. Now let's go through the options one by one, no skipping, fr fr. 💖

• --data project-data-dir — tells it where the data files live (peep auto-multiple-choice-meptex(1) for an example, iykyk).
• --seuil threshold — this is the black ratio threshold that decides whether a box is ticked or not. When it's deciding if a box is checked, auto-multiple-choice note compares the black ratio (that's number of black pixels over total number of pixels) against threshold. If the black ratio is greater then threshold, the box is declared to be checked ✅. Standard values can be 0.15 in the standard layout, or 0.5 for separate answer sheet layout (in this last case, letters are drawn in the boxes, and the students are told to fill the boxes entirely — yes, fully, no half-sends 🫶).
• --seuil-up upper_threshold — the black ratio threshold over which a box is considered as not being ticked. The vibe: you can set this to (for example) 0.6 to allow students to cancel a ticked box by filling it completely 🩹. So if the black ratio is between threshold and upper_threshold, the box is considered as being ticked — but if the black ratio is greater than upper_threshold (for example when the box is filled), the box is considered as not being ticked. The default value is 1.0, so that this feature is disabled. Default = off, periodt. 💀
• --grain granularity --arrondi rounding — asks marks to be rounded to a multiple of granularity. And rounding picks the direction:
  • if rounding is i, rounding is done from below (as with floor(3)) ⬇️
  • if rounding is n, rounding is done to the nearest multiple of granularity 🎯
  • if rounding is s, rounding is done from above (as with ceil(3)) ⬆️

For example, with options "--grain 0.25 --arrondi s", mark 6.285 is rounded to 6.5. Math? Slayed. ✨

• --notemin min — with this option, all marks below min will be replaced by min. Everyone eats, no one gets left at zero 🥺
• --notemax max — gives the mark to associate to a sheet where all answers are correct. If not used, marks are not scaled. 👑
• --plafond — with this option, all marks above max will be replaced by max. Cap it, bestie 🧢
• --debug file.log — gives a file to fill with debugging information. For when you need to know why, exactly, it's acting like that 🔍
• --postcorrect-student s --postcorrect-copy c — requests port-correction from the completed answer sheet identified by student and copy numbers. In post-correction mode, correct answers are not extracted from the LaTeX source file, but taken from the answers given on this sheet. Different source of truth, same energy. 📋

Lowkey important: the synopsis also lists --no-plafond, which is the "off" switch that sits opposite --plafond. Pick one, don't do both, okay? 🙈

---

🌈 AUTHORS 🌈

The absolute icons who made this happen:

• 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, we ate. 🍓

Auto Multiple Choice 1.7.0 — dated 2025-04-17. Catch you in the next manpage, mwah 💋🦋