AMC-annote — completed answer sheets annotation after marking for AMC multiple choice exams.
auto-multiple-choice annote --projet
project-dir --data
project-data-dir --fich-assoc
assoc.xml [annotation options...]
The AMC-annote.pl command annotates papers scans with scores for all questions, global score and mark, resulting in JPEG files (one for each page).
--projet
project-dirsets the project directory.
--data
project-data-dirgives the directory where data files are (see for example AMC-prepare(1)).
--cr
project-cr-dirsets the project reports directory, where to find data
capture reports prepared by AMC-analyse(1), and where to output annotated scans. Default
value is
.project-dir/cr
--fich-noms
students-list.csvsets the students list file name.
--noms-encodage
encodingselects an encoding for file
students-list.csv (default is
utf-8).
--qualite
qualsets JPEG quality for output files. Default value is 65.
--taille-max
maxsizesets the maximal size for output files (in the format
,
in pixels). Default value is
widthxheight1000x1500.
--pointsize-nl
linessets the size of texts requiring that with this size, the
number of text lines that fits on the page height must be
lines. Default value is
60.
--verdict
headersets the text header to be printed on each first page of the students copies. This text may contain CR characters for multi-line headers. Some sequences are substituted in it:
%Sis replaced by the student total score.
%Mis replaced by the maximum total score.
%sis replaced by the student mark.
%mis replaced by the maximum mark.
%(ID)is replaced by the student's name.
%(COL)is replaced by the value of column
COL in the students list for
the curent student.
perl-expressionsets the text to be printed next to all questions, through
a perl expression to be evaluated (if you need a simple text,
simply quote it with "). Some sequences are
substituted in it before evaluation:
%Sis replaced by the student score for this question.
%Mis replaced by the maximum score for this question.
%sis the same as %S, but rounded to
nc significant digits (see
option --ch-sign).
%mis the same as %M, but rounded to
nc significant digits (see
option --ch-sign).
A standard value for this option is
"\"%s/%m\"". You can also use tests (with the perl
syntax ( TEST ? IF-YES : IF-NO )) to write
Valid if the score is the maximal score, or
Failed if not, using
--verdict-question "(%S==%M ? \"Valid\" : \"Failed\")"
--ch-sign
ncSets the number nc of
significant digits to use when printing global mark.
--symbols
symbols-definitiondefines how boxes will be annotated. symbols-definition is
a comma separated list of
constructs, where H-A:shape:colourH is
0 or 1 depending on wether
the box has to be checked or not, A
is 0 or 1 depending on
wether the box is actually checked or not,
shape is one of
none, circle,
mark, box and
coulour is a colour (name or #RGB,
see ImageMagick or GraphicsMagick documentation for details).
Default value is
"0-0:none,0-1:circle:red,1-0:mark:red,1-1:mark:blue".
--position
possets the position of individual questions scores.
pos may be 'none'
(do dot write individual scores), 'marge'
(write scores in the margin) or 'case' (write
scores at the left of the left-most box for the question.
--ecart
dxsets the horizontal space to let between individual
question score and the leftmost box when --position
case is used.
--ecart-marge
xsets the x position for individual questions scores when written in the margin (in em units).
--line-width
lwsets the line width for symbols drwan on the scans (in pixels). Default value is 2.
--indicatives
boolsay if indicative questions are to be annotated (use 1 for a true value; default is false).
--debug
file.loggives a file to fill with debugging information.