'\" t
.\"     Title: AMC-annote
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 10/24/2014
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.2.1
.\"  Language: English
.\"
.TH "AMC\-ANNOTE" "1" "10/24/2014" "Auto Multiple Choice 1\&.2\&.1" "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-annote \- completed answer sheets annotation after marking for AMC multiple choice exams\&.
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR annote \-\-projet\ \fIproject\-dir\fR \-\-data\ \fIproject\-data\-dir\fR \-\-fich\-assoc\ \fIassoc\&.xml\fR [annotation\ options...]
.SH "DESCRIPTION"
.PP
The
\fBAMC\-annote\&.pl\fR
command annotates papers scans with scores for all questions, global score and mark, resulting in JPEG files (one for each page)\&.
.PP
\fB\-\-projet \fR\fB\fIproject\-dir\fR\fR
.RS 4
sets the project directory\&.
.RE
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
gives the directory where data files are (see for example
\fBAMC-prepare\fR(1))\&.
.RE
.PP
\fB\-\-cr \fR\fB\fIproject\-cr\-dir\fR\fR
.RS 4
sets the project reports directory, where to find data capture reports prepared by
\fBAMC-analyse\fR(1), and where to output annotated scans\&. Default value is
\fIproject\-dir\fR/cr\&.
.RE
.PP
\fB\-\-fich\-noms \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
sets the students list file name\&.
.RE
.PP
\fB\-\-noms\-encodage \fR\fB\fIencoding\fR\fR
.RS 4
selects an encoding for file
\fIstudents\-list\&.csv\fR
(default is utf\-8)\&.
.RE
.PP
\fB\-\-qualite \fR\fB\fIqual\fR\fR
.RS 4
sets JPEG quality for output files\&. Default value is 65\&.
.RE
.PP
\fB\-\-taille\-max \fR\fB\fImaxsize\fR\fR
.RS 4
sets the maximal size for output files (in the format
\fIwidth\fRx\fIheight\fR, in pixels)\&. Default value is
1000x1500\&.
.RE
.PP
\fB\-\-pointsize\-nl \fR\fB\fIlines\fR\fR
.RS 4
sets the size of texts requiring that with this size, the number of text lines that fits on the page height must be
\fIlines\fR\&. Default value is
60\&.
.RE
.PP
\fB\-\-verdict \fR\fB\fIheader\fR\fR
.RS 4
sets 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:
.PP
%S
.RS 4
is replaced by the student total score\&.
.RE
.PP
%M
.RS 4
is replaced by the maximum total score\&.
.RE
.PP
%s
.RS 4
is replaced by the student mark\&.
.RE
.PP
%m
.RS 4
is replaced by the maximum mark\&.
.RE
.PP
%(ID)
.RS 4
is replaced by the student\*(Aqs name\&.
.RE
.PP
%(\fICOL\fR)
.RS 4
is replaced by the value of column
\fICOL\fR
in the students list for the curent student\&.
.RE
.RE
.PP
\-\-verdict\-question \fIperl\-expression\fR
.RS 4
sets 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:
.PP
%S
.RS 4
is replaced by the student score for this question\&.
.RE
.PP
%M
.RS 4
is replaced by the maximum score for this question\&.
.RE
.PP
%s
.RS 4
is the same as
%S, but rounded to
\fInc\fR
significant digits (see option
\fB\-\-ch\-sign\fR)\&.
.RE
.PP
%m
.RS 4
is the same as
%M, but rounded to
\fInc\fR
significant digits (see option
\fB\-\-ch\-sign\fR)\&.
.RE
.sp
A standard value for this option is
"\e"%s/%m\e""\&. You can also use tests (with the perl syntax
( TEST ? IF\-YES : IF\-NO )) to write
\fIValid\fR
if the score is the maximal score, or
\fIFailed\fR
if not, using
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-verdict\-question "(%S==%M ? \e"Valid\e" : \e"Failed\e")"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-ch\-sign \fR\fB\fInc\fR\fR
.RS 4
Sets the number
\fInc\fR
of significant digits to use when printing global mark\&.
.RE
.PP
\fB\-\-symbols \fR\fB\fIsymbols\-definition\fR\fR
.RS 4
defines how boxes will be annotated\&. symbols\-definition is a comma separated list of
\fIH\fR\-\fIA\fR:\fIshape\fR:\fIcolour\fR
constructs, where
\fIH\fR
is
0
or
1
depending on wether the box has to be checked or not,
\fIA\fR
is
0
or
1
depending on wether the box is actually checked or not,
\fIshape\fR
is one of
none,
circle,
mark,
box
and
\fIcoulour\fR
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"\&.
.RE
.PP
\fB\-\-position \fR\fB\fIpos\fR\fR
.RS 4
sets the position of individual questions scores\&.
\fIpos\fR
may be \*(Aqnone\*(Aq (do dot write individual scores), \*(Aqmarge\*(Aq (write scores in the margin) or \*(Aqcase\*(Aq (write scores at the left of the left\-most box for the question\&.
.RE
.PP
\fB\-\-ecart \fR\fB\fIdx\fR\fR
.RS 4
sets the horizontal space to let between individual question score and the leftmost box when
\fB\-\-position case\fR
is used\&.
.RE
.PP
\fB\-\-ecart\-marge \fR\fB\fIx\fR\fR
.RS 4
sets the x position for individual questions scores when written in the margin (in
\fIem\fR
units)\&.
.RE
.PP
\fB\-\-line\-width \fR\fB\fIlw\fR\fR
.RS 4
sets the line width for symbols drwan on the scans (in pixels)\&. Default value is 2\&.
.RE
.PP
\fB\-\-indicatives \fR\fB\fIbool\fR\fR
.RS 4
say if indicative questions are to be annotated (use 1 for a true value; default is false)\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
gives a file to fill with debugging information\&.
.RE
.SH "AUTHORS"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
Main author
.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-2013 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