AUTO-MULTIPLE-CHOI(1)

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

πŸ’– AUTO-MULTIPLE-CHOI(1) πŸ’–

okay so you opened the manual page for Auto Multiple Choice (AMC for short), bestie, and honestly? this one's a whole vibe. it's the auto-multiple-choice note command and it's about to do math on your exam sheets. sit down, grab a snack πŸ“

✨ 名前 / NAME ✨

auto-multiple-choice-note β€” grades AMC multiple-choice exam papers πŸŽ€

so like, the name is literally the whole job description. it grades. that's it. that's the function.

✨ 概要 / 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 here's the tea β˜• β€” the auto-multiple-choice note command takes the grading criteria that auto-multiple-choice-prepare(1) pulled out of your LaTeX source file, plus the mark-recognition data that auto-multiple-choice-analyse(1) made, and computes the score for every single answer sheet. it's giving "the final boss of the AMC pipeline" energy πŸ‘‘

now let's meet the flags, one by one, no skips:

  • --data project-data-dir β€” tells the command which directory your data files live in (peep auto-multiple-choice-meptex(1) and friends if you need the lore) πŸ“
  • --seuil threshold β€” sets the black-pixel-ratio threshold that decides whether a box counts as marked or not. when it's checking a box, auto-multiple-choice note compares the black pixel ratio (that's black pixels Γ· total pixels, iykyk πŸ–€) against threshold. if the black pixel ratio is greater than threshold, the box gets declared MARKED, periodt. the standard value is 0.15 for a normal layout, and around 0.5 for the separate-answer-sheet layout β€” you know, the one where there's already text printed inside the box and the test-taker is told to fill the box completely πŸ’…
  • --seuil-up upper_threshold β€” this is the upper limit: if the black pixel ratio climbs above this, the box gets judged as not marked. set it to (for example) 0.6 and a test-taker can cancel their own mark by filling the box completely. so basically: ratio between threshold and upper_threshold β†’ box is marked βœ…, ratio over upper_threshold (fully filled) β†’ box is not marked ❌. the default value is 1.0, which means this whole feature is switched off by default. no cap, no cancel πŸ™ˆ
  • --grain granularity / --arrondi rounding β€” rounds the score so it's a multiple of granularity. if rounding is i, it rounds down (like floor(3) does). if rounding is n, it rounds to the nearest. if rounding is s, it rounds up (like ceil(3) does). example, bestie: with the options --grain 0.25 --arrondi s, a score of 6.285 gets rounded to 6.5. math ate that ✨
  • --notemin min β€” use this and every score below min gets swapped for min. nobody fails, we don't do that here 🫢
  • --notemax max β€” sets the max score awarded to an all-correct answer sheet. if you don't use this, scores stay as raw points (η΄ η‚Ή), no scaling, no drama.
  • --plafond β€” use this and every score above max gets swapped for max. it's the ceiling, literally 🌈
  • --debug file.log β€” pick the file where debug info gets written. for when you need to see what's happening under the hood πŸ”
  • --postcorrect-student s / --postcorrect-copy c β€” asks for post-correction at grading time using the answer sheet given by the student number and the exam/question number. in this post-correction mode, the correct answers get taken from this answer sheet's answers instead of from the LaTeX source file. iconic behaviour, ngl πŸ‘‘

✨ θ‘—θ€… / AUTHORS ✨

  • Bienvenue Alexis[FAMILY Given] <paamc@passoire.fr> β€” main author 🧚
  • Sarkar Anirvan[FAMILY Given] β€” author & editor ✍️
  • Kagotani Hiroto[FAMILY Given] β€” editor βœ‚οΈ
  • BrΓ©al FrΓ©dΓ©ric[FAMILY Given] β€” author & editor ✍️
  • BΓ©rard Jean[FAMILY Given] β€” French β†’ English translation 🌍
  • Khaznadar Georges[FAMILY Given] β€” French β†’ English translation 🌍
  • Kagotani Hiroto[FAMILY Given] β€” English β†’ Japanese translation 🌍

copyright Β© 2008-2018 Alexis BienvenΓΌe πŸ‘‘

this document can be used under the terms of the GNU General Public License version 2 or later. that's GNU GPL v2-or-later, no cap, respect the license πŸ”₯

fr fr bestie, read the license before you redistribute. it's giving legal but make it cute πŸŽ€

okay that's the whole page!! this was Auto Multiple Choice 1.7.0, dated 2025-04-17, and you were reading AUTO-MULTIPLE-CHOI(1) πŸ’œ go grade some exams and slay βœ¨πŸ’…πŸ¦‹

πŸ“¦ where this page comes from