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-assoc assoc.xml --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.

--mep project-mep-dir

gives the directory where MEP files (prepared by AMC-prepare(1)) can be found.

--cr project-cr-dir

gives the directory where to find individual annotated JPEG files prepared by AMC-annote(1) and where to write annotated students PDFs.

--projet project-dir

When using this option, if --cr is not used, project-cr-dir will be set to project-dir/cr, and if --mep is not used, project-mep-dir will be set to project-dir/mep.

--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-assoc assoc.xml

sets the association file, prepared by AMC-association-auto(1) and/or modified for manual association.

--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) option.

--tex-src mcq.tex

gives the LaTeX source file for the subject.

--with latex-engine

gives the LaTeX engine (command) to be used to process mcq.tex. latex-engine can be pdflatex or xelatex for exemple.

--debug file.log

gives a file to fill with debugging information.