'\" t
.\"     Title: AMC-analyse
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-01-21
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.5.0~rc1
.\"  Language: English
.\"
.TH "AMC\-ANALYSE" "1" "2021-01-21" "Auto Multiple Choice 1\&.5\&.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-analyse \- automatic data capture from scans for AMC multiple choice exams\&.
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR analyse \-\-projet\ \fIproject\-dir\fR [\-\-seuil\-coche\ \fIthreshold\fR] [\-\-tol\-marque\ \fItol\fR] [\-\-list\-fichiers\ \fIfiles\-list\&.txt\fR | \fIscan\-files\fR...]
.SH "DESCRIPTION"
.PP
The
\fBAMC\-analyse\&.pl\fR
command performs automatic data capture from scans of completed answer sheets of an AMC multiple choice questionnaire\&. Before calling
\fBAMC\-analyse\&.pl\fR,
\fBAMC-prepare\fR(1)
should have been called to make working documents (\fB\-\-mode s\fR) and the layout should have been processed with
\fBAMC-meptex\fR(1)\&.
.PP
\fB\-\-data \fR\fB\fIdata\-dir\fR\fR
.RS 4
gives the directory where data files are (see for example
\fBAMC-meptex\fR(1))\&. Defaults to
\fIproject\-dir\fR/data\&.
.RE
.PP
\fB\-\-cr \fR\fB\fIproject\-cr\-dir\fR\fR
.RS 4
gives a directory where to create image reports of the data capture (zooms on the boxes in a
zooms
sub\-directory, name filed extraction as a
name\-*\&.jpg
file, and layout report as a
page\-*\&.jpg
file)\&.
.RE
.PP
\fB\-\-projet \fR\fB\fIproject\-dir\fR\fR
.RS 4
When using this option, if
\fB\-\-cr\fR
is not used,
\fIproject\-cr\-dir\fR
will be set to
\fIproject\-dir\fR/cr\&.
.RE
.PP
Giving the names of the scan files to process can be done in two ways:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
these names can be given as arguments,
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
these names can be written to a plain file (one filename per line), using the
\fB\-\-list\-fichiers \fR\fB\fIfiles\-list\&.txt\fR\fR
to give the name of this file\&.
.RE
.PP
Some parameters for data capture may be set using the following options:
.PP
\fB\-\-prop \fR\fB\fIproportion\fR\fR
.RS 4
sets the proportion of each box that will be measured to decide if the box is ticked or not\&. Default value is 0\&.8\&.
.RE
.PP
\fB\-\-bw\-threshold \fR\fB\fIthreshold\fR\fR
.RS 4
This parameter is used when converting the grayscale scan file to black and white\&. To get more black pixels, use a greater value\&. To get more white pixels, use a smaller value\&. The threshold must be between 0 and 1\&. The default value is 0\&.6\&.
.RE
.PP
\fB\-\-ignore\-red\fR
.RS 4
With this option, only red channel will be used from color scans\&. This way, all that is written in red will be ignored in the scan\&. This can be useful when the boxes are printed in red\&.
.RE
.PP
\fB\-\-tol\-marque \fR\fB\fItol\fR\fR
.RS 4
defines the tolerance when detecting the four marks in the scans corners\&. These marks are detected looking for black connected components which dimensions are
\fIclosed\fR
to the target dimension
\fItarget\fR
(exact dimensions of the marks if printing/scanning process where perfectly accurate)\&. If
\fItol\fR
is a real number, accepted dimensions are those between (1\-\fItol\fR)*\fItarget\fR
and (1+\fItol\fR)*\fItarget\fR\&. If
\fItol\fR
is "\fItinf\fR,\fItsup\fR" (where
\fItinf\fR
and
\fItsup\fR
are real numbers), accepted dimensions are those between (1\-\fItinf\fR)*\fItarget\fR
and (1+\fItsup\fR)*\fItarget\fR\&. A standard value is 0\&.2\&.
.RE
.PP
\fB\-\-multiple\fR
.RS 4
This option is to be used when the scans are photocopies from some subjects (different students can have the same subject)\&. In this case,
\fIcopy\fR
numbers are allocated to students so that their answer sheets, with the same subject number, can be differentiated\&.
.RE
.PP
\fB\-\-pre\-allocate \fR\fB\fIcopy_id\fR\fR
.RS 4
This option can be used in conjunction with
\fB\-\-multiple\fR\&. The copy numbers used for the scans will start from
\fIcopy_id\fR, in the same order than the scans given as arguments\&.
.RE
.PP
\-\-try\-three | \-\-no\-try\-three
.RS 4
Use one of these options to tell if you allow processing of scans where only three corner marks are present\&.
.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
\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-2021 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