AUTO-MULTIPLE-CHOI(1)

NAME
auto-multiple-choice-note - computes marks after scans data capture for AMC multiple choice exams.

SYNOPSIS

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

DESCRIPTION

The auto-multiple-choice note command computes marks for all students from the scoring strategy extracted from the LaTeX source file by auto-multiple-choice-prepare(1) and from the data capture reports made by auto-multiple-choice-analyse(1).

--data project-data-dir
    gives the directory where data files are (see for example auto-multiple-choice-meptex(1)).

--seuil threshold
    gives the black ratio threshold for deciding whether a box is ticked or not. When deciding whether a box is checked or not, auto-multiple-choice note compares the black ratio (number of black pixels over total number of pixels) to 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).

--seuil-up upper_threshold
    gives the black ratio threshold over which a box is considered as not being ticked. You can set this value to (for example) 0.6 to allow students to cancel a ticked box filling it completely: 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.

--grain granularity --arrondi rounding
    ask marks to be rounded to a multiple of granularity. 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.

--notemin min
    with this option, all marks below min will be replaced by min.

--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.

--debug file.log
    gives a file to fill with debugging information.

--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.

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.