AMC-REGROUPE(1) Auto Multiple Choice AMC-REGROUPE(1)NAME
AMC-regroupe - merge JPEG annotated AMC multiple choice answer sheets to get a PDF file per student.
SYNOPSIS
auto-multiple-choice regroupe --projet project-dir --sujet subject.pdf --modele file-name-model --fich-noms students-list.csv
[--noms-encodage encoding] [--compose]
DESCRIPTION
The command AMC-regroupe.pl merges annotated AMC multiple choice answer sheets (there is one per page) to get a single PDF file per
student.
--data data-dir
gives the directory where data files are (see for example AMC-meptex(1)).
--projet project-dir
Gives the project directory.
--sujet subject.pdf
gives the subject file (as prepared by AMC-prepare(1)). This helps in getting the page size for the subject to make annotated PDF fit
this size.
--fich-noms students-list.csv
sets the students list file name.
--noms-encodage encoding
selects an encoding for file students-list.csv (default is utf-8).
--modele file-name-model
sets a file name model for annotated PDFs. In this model, some sequences will be substituted:
(N)
is replaced by the student's name.
(ID)
is replaced by the student number.
(COL)
is replaced by the value of column COL in the students list for the curent student.
The default value is '(N)-(ID).pdf'.
--compose
When using this option, pages for which there is no scan will be replaced by the corresponding page from the corrected answer sheet.
This option is for example useful when using the separate answer sheet layout: in this case, the annotated answer sheet will not be
readable without the pages with the questions.
When using the --compose option, one must also use the --tex-src (and optionnaly --with, --filter and --filtered-source) option.
--tex-src mcq-source-file
gives the source file for the subject.
--with latex-engine
gives the LaTeX engine (command) to be used to process the (optionaly filtered) source file. latex-engine can be pdflatex or xelatex
for exemple.
--filter filter
sets the filter name to transform the MCQ source file into a LaTeX file (see AMC-prepare(1)).
--filtered-source mcq-latex-file
gives the LaTeX file to make from the source file using specified filter (see AMC-prepare(1)).
--debug file.log
gives a file to fill with debugging information.
AUTHORS
Alexis Bienvenue <paamc@passoire.fr>
Main author
Jean Berard
Translation from French
Georges Khaznadar
Translation from French
COPYRIGHT
Copyright (C) 2008-2012 Alexis Bienvenue
This document can be used according to the terms of the GNU General Public License, version 2 or later.
Auto Multiple Choice 1.1.1 06/19/2012 AMC-REGROUPE(1)
Check Out this Related Man Page
AMC-EXPORT(1) Auto Multiple Choice AMC-EXPORT(1)NAME
AMC-export - exports marks for AMC multiple choice exams.
SYNOPSIS
auto-multiple-choice export --data project-data-dir --module module --fich-noms students-list.csv [--noms-encodage list-encoding]
--o output-file
DESCRIPTION
The AMC-export.pl command exports marks from an Auto Multiple Choice exam.
--data project-data-dir
gives the directory where data files are (see for example AMC-prepare(1)).
--module module
selects a module for export. See below for the modules included in the AMC standard distribution.
--fich-noms students-list.csv
sets the students list file.
--noms-encodage list-encoding
selects an encoding for file students-list.csv (default is utf-8).
--o output-file
gives the output file name.
--option-out options
gives an option for selected module, in the form key=value (see below for possible options for each module). To specify multiple
options, use --option several times.
--sort sort-type
sort the students names, depending on sort-type. If sort-type is l, use line number from students list file to sort. If sort-type is m,
use mark (and name if marks are equal) to sort. If sort-type is i, use student number to sort. If sort-type is n, use name to sort (or
line from students list if equal).
--useall all
if all is 0 or empty, only students with a scaned answer sheet appears in the output. If all is 1, all students in the students list
appears in the output.
MODULES
OpenDocument
With "--module ods", an OpenDocument (for use by OpenOffice or LibreOffice for example) is produced. The following options are recognized:
nom
gives a name for the exam, to be written on the beginning of the sheet.
code
gives an short name for the exam, to be used as a tab name.
columns
sets the list of columns that are to be added to each student. Default value is student.key,student.name.
stats
with a true value, a table will be added with statistics for all questions.
statsindic
with a true value, a table will be added with statistics for all indicative questions.
CSV
With "--module CSV", a CSV file is produced. The following options are recognized:
columns
sets the list of columns that are to be added to each student. Default value is student.copy,student.key,student.name.
decimal
sets the decimal point (default is a dot).
encodage
sets the encoding to use for output (default is utf-8).
separateur
sets the character used between colums (default is a comma).
entoure
sets the character used to enclose strings (default is a double quote).
ticked
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.
List
With "--module List", a PDF file is produced with a list of marks for all students. The following options are recognized:
pagesize
The page size. Default value is a4.
nom
gives the name of the exam, to be printed at the top of the page.
ncols
The number of columns. Default value is 2.
decimal
sets the decimal point (default is a dot).
AUTHORS
Alexis Bienvenue <paamc@passoire.fr>
Main author
Jean Berard
Translation from French
Georges Khaznadar
Translation from French
COPYRIGHT
Copyright (C) 2008-2012 Alexis Bienvenue
This document can be used according to the terms of the GNU General Public License, version 2 or later.
Auto Multiple Choice 1.1.1 06/19/2012 AMC-EXPORT(1)