'\" t
.\"     Title: AMC-note
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2018-12-29
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.4.0
.\"  Language: English
.\"
.TH "AMC\-NOTE" "1" "2018-12-29" "Auto Multiple Choice 1\&.4\&.0" "Auto Multiple Choice"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
AMC-note \- computes marks after scans data capture for AMC multiple choice exams\&.
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR note \-\-data\ \fIproject\-data\-dir\fR [\-\-seuil\ \fIthreshold\fR] [\-\-grain\ \fIgranularity\fR] [\-\-arrondi\ \fIrounding\fR] [\-\-notemin\ \fImin\fR] [\-\-notemax\ \fImax\fR] [\-\-no\-plafond | \-\-plafond]
.SH "DESCRIPTION"
.PP
The
\fBAMC\-note\&.pl\fR
command computes marks for all students from the scoring strategy extracted from the LaTeX source file by
\fBAMC-prepare\fR(1)
and from the data capture reports made by
\fBAMC-analyse\fR(1)\&.
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
gives the directory where data files are (see for example
\fBAMC-meptex\fR(1))\&.
.RE
.PP
\fB\-\-seuil \fR\fB\fIthreshold\fR\fR
.RS 4
gives the black ratio threshold for deciding whether a box is ticked or not\&. When deciding whether a box is checked or not,
\fBAMC\-note\&.pl\fR
compares the black ratio (number of black pixels over total number of pixels) to
\fIthreshold\fR\&. If the black ratio is greater then
\fIthreshold\fR, 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)\&.
.RE
.PP
\fB\-\-seuil\-up \fR\fB\fIupper_threshold\fR\fR
.RS 4
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
\fIthreshold\fR
and
\fIupper_threshold\fR, the box is considered as being ticked, but if the black ratio is greater than
\fIupper_threshold\fR
(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\&.
.RE
.PP
\fB\-\-grain \fR\fB\fIgranularity\fR\fR\fB \-\-arrondi \fR\fB\fIrounding\fR\fR
.RS 4
ask marks to be rounded to a multiple of
\fIgranularity\fR\&. If
\fIrounding\fR
is \*(Aqi\*(Aq, rounding is done from below (as with
\fBfloor\fR(3))\&. If
\fIrounding\fR
is \*(Aqn\*(Aq, rounding is done to the nearest multiple of
\fIgranularity\fR\&. If
\fIrounding\fR
is \*(Aqs\*(Aq, rounding is done from above (as with
\fBceil\fR(3))\&. For example, with options "\fB\-\-grain 0\&.25 \-\-arrondi s\fR", mark 6\&.285 is rounded to 6\&.5\&.
.RE
.PP
\fB\-\-notemin \fR\fB\fImin\fR\fR
.RS 4
with this option, all marks below
\fImin\fR
will be replaced by
\fImin\fR\&.
.RE
.PP
\fB\-\-notemax \fR\fB\fImax\fR\fR
.RS 4
gives the mark to associate to a sheet where all answers are correct\&. If not used, marks are not scaled\&.
.RE
.PP
\fB\-\-plafond\fR
.RS 4
with this option, all marks above
\fImax\fR
will be replaced by
\fImax\fR\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
gives a file to fill with debugging information\&.
.RE
.PP
\fB\-\-postcorrect\-student \fR\fB\fIs\fR\fR\fB \-\-postcorrect\-copy \fR\fB\fIc\fR\fR
.RS 4
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\&.
.RE
.SH "AUTHORS"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
Main author
.RE
.PP
\fBAnirvan Sarkar\fR
.RS 4
Author and Editor
.RE
.PP
\fBHiroto Kagotani\fR
.RS 4
Editor
.RE
.PP
\fBFr\('ed\('eric Br\('eal\fR
.RS 4
Author and Editor
.RE
.PP
\fBJean B\('erard\fR
.RS 4
Translation from French
.RE
.PP
\fBGeorges Khaznadar\fR
.RS 4
Translation from French
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2008-2018 Alexis Bienven\(:ue
.br
.PP
This document can be used according to the terms of the GNU General Public License, version 2 or later.
.sp