'\" t
.\"     Title: AMC-export
.\"    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\-EXPORT" "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-export \- exports marks for AMC multiple choice exams\&.
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR export \-\-data\ \fIproject\-data\-dir\fR \-\-module\ \fImodule\fR \-\-fich\-noms\ \fIstudents\-list\&.csv\fR [\-\-noms\-encodage\ \fIlist\-encoding\fR] \-\-o\ \fIoutput\-file\fR
.SH "DESCRIPTION"
.PP
The
\fBAMC\-export\&.pl\fR
command exports marks from an Auto Multiple Choice exam\&.
.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\-\-module \fR\fB\fImodule\fR\fR
.RS 4
selects a module for export\&. See below for the modules included in the AMC standard distribution\&.
.RE
.PP
\fB\-\-fich\-noms \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
sets the students list file\&.
.RE
.PP
\fB\-\-noms\-encodage \fR\fB\fIlist\-encoding\fR\fR
.RS 4
selects an encoding for file
\fIstudents\-list\&.csv\fR
(default is utf\-8)\&.
.RE
.PP
\fB\-\-o \fR\fB\fIoutput\-file\fR\fR
.RS 4
gives the output file name\&.
.RE
.PP
\fB\-\-option\-out \fR\fB\fIoptions\fR\fR
.RS 4
gives an option for selected module, in the form
key=value
(see below for possible options for each module)\&. To specify multiple options, use
\fB\-\-option\fR
several times\&.
.RE
.PP
\fB\-\-sort \fR\fB\fIsort\-type\fR\fR
.RS 4
sort the students names, depending on
\fIsort\-type\fR\&. If
\fIsort\-type\fR
is
l, use line number from students list file to sort\&. If
\fIsort\-type\fR
is
m, use mark (and name if marks are equal) to sort\&. If
\fIsort\-type\fR
is
i, use student number to sort\&. If
\fIsort\-type\fR
is
n, use name to sort (or line from students list if equal)\&.
.RE
.PP
\fB\-\-useall \fR\fB\fIall\fR\fR
.RS 4
if
\fIall\fR
is
0
or empty, only students with a scanned answer sheet appears in the output\&. If
\fIall\fR
is
1, all students in the students list appears in the output\&.
.RE
.SH "MODULES"
.SS "OpenDocument"
.PP
With "\fB\-\-module ods\fR", an OpenDocument (for use by OpenOffice or LibreOffice for example) is produced\&. The following options are recognized:
.PP
nom
.RS 4
gives a name for the exam, to be written on the beginning of the sheet\&.
.RE
.PP
code
.RS 4
gives an short name for the exam, to be used as a tab name\&.
.RE
.PP
columns
.RS 4
sets the list of columns that are to be added to each student\&. Default value is
student\&.key,student\&.name\&.
.RE
.PP
stats
.RS 4
with a true value, a table will be added with statistics for all questions\&.
.RE
.PP
statsindic
.RS 4
with a true value, a table will be added with statistics for all indicative questions\&.
.RE
.SS "CSV"
.PP
With "\fB\-\-module CSV\fR", a CSV file is produced\&. The following options are recognized:
.PP
columns
.RS 4
sets the list of columns that are to be added to each student\&. Default value is
student\&.copy,student\&.key,student\&.name\&.
.RE
.PP
decimal
.RS 4
sets the decimal point (default is a dot)\&.
.RE
.PP
encodage
.RS 4
sets the encoding to use for output (default is utf\-8)\&.
.RE
.PP
separateur
.RS 4
sets the character used between columns (default is a comma)\&.
.RE
.PP
entoure
.RS 4
sets the character used to enclose strings (default is a double quote)\&.
.RE
.PP
ticked
.RS 4
if not empty, additional columns (with "CHECKED:" prefix) are included to give all the checked boxes on all the sheets\&. This can be used by an external program to retrieve all the checked boxes when marks are not sufficient\&. Use value
01
to get 0;0;1;1;0 if boxes 3 and 4 are checked, and value
AB
to get CD if boxes 3 and 4 are checked\&.
.RE
.SS "List"
.PP
With "\fB\-\-module List\fR", a PDF file is produced with a list of marks for all students\&. The following options are recognized:
.PP
pagesize
.RS 4
The page size\&. Default value is
a4\&.
.RE
.PP
nom
.RS 4
gives the name of the exam, to be printed at the top of the page\&.
.RE
.PP
ncols
.RS 4
The number of columns\&. Default value is 2\&.
.RE
.PP
decimal
.RS 4
sets the decimal point (default is a dot)\&.
.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