Use of AMC : Auto Multiple Choice





Install

I use Ubuntu 16.04.
Install AMC
     $ sudo add-apt-repository ppa:alexis.bienvenue/test && sudo apt-get update && sudo apt-get install auto-multiple-choice

Build the exam

A complete documentation can be found here
The video explained quickly (in French) how AMC works. This video is used with Windows and a virtualbox.
The best is to treat an example.
You need to have a separate file with all the questions related to you lesson. For instance, I have a Lyx file named 'Quiz_loc_store.lyx'
I export in Latex to get 'quiz_loc_store.tex'
Just before the exam, I prepare my file named 'myexam.tex' (see few lines below). This file has two questions. Each question has 5 propositions that can be either true or false. If the student has only correct answers than he gets 8 points (4 points per question). Each wrong answer remove one point. But the student never gets a mark lower than zero for each questions.
To generate the right number of copies. For instance '\onecopy{60}' in the Latex file if you have 60 students.
\documentclass[a4paper]{article}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{amsfonts}
\usepackage{amsmath}
\usepackage[box,separateanswersheet]{automultiplechoice}   
\usepackage{amsmath}
\usepackage{amssymb}
\begin{document}
\AMCrandomseed{1237893}
\def\AMCformQuestion#1{\vspace{\AMCformVSpace}\par {\sc Question #1:} }   
\element{general}{
  \begin{questionmult}{plus}  {(all for 4) - }\scoring{haut=4}  
    Que vaut $1+2$ ?.      
    \begin{choices}
      \correctchoice{$3$}
      \correctchoice{$2+1$}
      \correctchoice{$4-1$}
      \wrongchoice{$7$}
      \wrongchoice{$8$}
    \end{choices}
  \end{questionmult}
}
\element{general}{
  \begin{questionmult}{moins}  {(all for 4) - }\scoring{haut=4}  
    Que vaut $4-1$ ?.      
    \begin{choices}
      \correctchoice{$3$}
      \correctchoice{$2+1$}
      \correctchoice{$4-1$}
      \wrongchoice{$7$}
      \wrongchoice{$8$}
    \end{choices}
  \end{questionmult}}
\onecopy{6}{    
\noindent{\bf QCM  \hfill UV 3.7}
\begin{center}\em
  All documents allowed. Questions using the sign \multiSymbole{} may have zero, one or several correct answers.
\end{center}
\vspace{1ex}
\shufflegroup{general}
\insertgroup{general}
\AMCcleardoublepage    
\AMCformBegin    
{\large\bf Answer sheet:}
\hfill \namefield{\fbox{    
    \begin{minipage}{.5\linewidth}
      Firstname and lastname:      
      \vspace*{.5cm}\dotfill
      \vspace*{1mm}
    \end{minipage}
  }}
\begin{center}
  \bf\em Answers must be given exclusively on this sheet: 
  answers given on the other sheets will be ignored.
\end{center}
\AMCform    
\clearpage    
}  
\end{document}
\grid

Use AMC to generate all exams in pdf

Start AMC typing under a terminal
     $ auto-multiple-choice
A small window associated to AMC should open.

In the menu:
'New Project' and choose a name such as 'exam_mardi'
The chosen directory will be in 'Home/MC-project'
template + Forward + [en] Documentation + Separate answers + Apply
Replace the text in 'separate.tex' with your own tex file (for instance in myexam.tex).
Put the number of N students in \onecopy{N}


Tab 'Preparation'
Check your file : 'Edit Source File'
'Update_Documents' generates the file 'Doc_sujet.pdf' that you have to print for your students.

Exam

Once the exam has been done, sort all copies with respect to the name in an alphabetic order. Scan all copies filled by the students. You get a single pdf file.
Pour le scanner, il faut procéder à quelques réglages sur le scanner : Application + type original : Texte + type fichier pdf.
With an editor, generate a .csv file containing the names of all students. It can be named for instance 'NomPrenom.csv' and saved in Home/MC-project. Inside you have a text similar to what follows:
NOM:Prenom
JAULIN:Luc
LE BARS:Fabrice
If you are from ENSTA-Bretagne, you can build this file from Aurion using a Copy-Paste-Replace procedure.

Use AMC for correction

Tab 'Data Capture'
Select 'Automatic'
Different answer sheets

Tab 'Marking'
click on 'Mark'.
Set File : 'NomPrenom.csv'
Primary key from this list : NOM
The association should be manual, if the students have written their names by hand, on the separate sheet.

Tab 'Reports' Export a CSV file.
A csc file with the marks are in the folder 'exports'
To generate a pdf file so that the students can see the correction, ssk for one file for all students.
Click on 'Annotate papers'