L'utilisation du paquet automultiplechoice se fait grâce à la ligne

\usepackage[...]{automultiplechoice}

où les pointillés sont remplacés par une liste d'options séparées par des virgules. Les options disponibles sont les suivantes :

Le code LaTeX décrivant le contenu de chaque copie doit être inclus dans un appel à la commande \exemplaire, avec pour premier argument le nombre de copies et pour deuxième argument le code utilisé pour générer une copie.

\exemplaire{50}{ ... }

Vous disposez d'une syntaxe alternative utilisant l'environnement copieexamen, qui a en option le nombre de copies désiré (5 par défaut).

\begin{copieexamen}[50]
...
\end{copieexamen}

	Note
	Cette dernière syntaxe utilise le paquet environ, qui n'est pas disponible dans la distribution TeX Live 2007, encore utilisée dans des distributions Ubuntu jusqu'à la version 9.10 (Karmic Koala).

Pour différencier les copies, la commande \exemplairepair peut être utile. À utiliser sous la forme d'un test de condition.

Le numéro de la copie peut être obtenu par la commande \AMCStudentNumber.

Vous pouvez ajouter une option supplémentaire de zone de notation (voir Position de la note) avec le package tikz.

\usepackage{tikz}

\AMCsetScoreZone{width=1.5em,height=1.5ex,depth=.5ex,position=margins}

Avec l'option ensemble

Dans ce mode, la feuille de réponses est séparée du sujet.

Taper cette commande, après le \begin{document} et avant la commande \exemplaire :

\AMCsetScoreZoneAnswerSheet{width=1.5em,height=1.5ex,depth=.5ex,position=question}

Les grandeurs width, height, depth définissent les dimensions de la case de notation ainsi que son emplacement sur la feuille de réponses. Cette zone invisible est définie pour toutes les questions.

La variable position peut prendre les valeurs : none, question, margin, margins.

	Avertissement
	L'option margins ne fonctionne pas avec AMC-TXT Vous ne pouvez pas modifier votre sujet a posteriori en rajoutant l'une de ces fonctions après l'impression du sujet.

L'inclusion de questions dans des groupes permet de mélanger les questions à l'intérieur de ces groupes, de manière différente pour chaque copie. Chaque groupe de questions devra avoir un nom formé uniquement de lettres non-accentuées.

On peut mettre une à une des questions dans un groupe, comme dans l'exemple suivant :

\element{ungroupe}{
  \begin{question}{facile}
    Alors, combien font un plus un~?
    \begin{reponseshoriz}
      \bonne{deux}
      \mauvaise{zéro}
      \mauvaise{trois}
    \end{reponseshoriz}
  \end{question}
}

	Important
	La constitution du groupe, par les commandes element, doit être faite une seule fois : ces commandes doivent donc être utilisées avant la commande exemplaire, qui va répéter certaines actions pour chaque copie.

Enfin, on restitue les questions du groupe par la commande restituegroupe, comme dans

\restituegroupe{ungroupe}

La manière dont le groupe est restitué peut être contrôlée par le mode du groupe, défini grâce à la commande setgroupmode  (appelé après la création des groupes et avant \exemplaire):

\setgroupmode{mygroup}{XXX}

où XXX peut prendre les valeurs suivantes :

Un mode par défaut peut être choisi pour tous les groupes qui seront créés ensuite (un groupe est créé à la première utilisation de element) :

\setdefaultgroupmode{XXX}

Si cette commande n'est pas utilisée, c'est le mode fixed qui sera utilisé.

On peut manipuler les groupes de questions de manière plus précise grâce aux commandes suivantes : tutoriel mélange

À l'aide de ces commandes, on peut par exemple composer un sujet en prenant 4 questions au hasard dans le groupe GA, 5 questions au hasard dans le groupe GB, toutes les questions du groupe GO, puis en mélangeant le tout, grâce aux commandes suivantes (à mettre à l'intérieur du texte en argument de la commande exemplaire, et en supposant que les groupes GA, GB et tout sont de mode withreplacement ou withoutreplacement) :

\cleargroup{tout}
\copygroup[4]{GA}{tout}
\copygroup[5]{GB}{tout}
\copygroup{GO}{tout}
\restituegroupe{tout}

	Note
	Une valeur nulle est possible, une valeur négative copie tout le groupe.

Le paquet LaTeX automultiplechoice utilise geometry pour gérer les marges et la mise en page. Vous pouvez modifier ses réglages grâce à l'utilisation de la commande \geometry juste avant le \begin{document} - voir la documentation du paquet geometry pour plus de détails. Les valeurs initialisées par AMC sont les suivantes :

\geometry{hmargin=3cm,headheight=2cm,headsep=.3cm,footskip=1cm,top=3.5cm,bottom=2.5cm}

Si vous réduisez les marges pour gagner de la place, gardez à l'esprit que :

Vous pouvez également préciser la taille de papier à utiliser en ajoutant l'option correspondante à la liste donnée en argument à \geometry. Parmi les valeurs possibles, on trouvera a4paper, a5paper, a6paper, b4paper, b5paper, ansibpaper, ansicpaper, ansidpaper, letterpaper, executivepaper, legalpaper.

Pour des petites tailles de papier, il peut aussi être intéressant de modifier la position de l'identifiant de copie (de la forme +1/1/53+) à côté de son équivalent en cases blanches et noires, en haut de chaque page. Ceci est rendu possible par la commande \AMCidsPosition, sous la forme

\AMCidsPosition{pos=p,width=w,height=h}

où p peut valoir none (ne pas écrire cet identifiant), top (l'écrire au-dessus) et side (à côté), et w et h sont les dimensions de la boîte (invisible) qui entoure l'identifiant. Les valeurs par défaut sont les suivantes :

\AMCidsPosition{pos=side,width=4cm,height=3ex}

Concluons par un exemple raisonnable au format A5 :

\geometry{a5paper,hmargin=1.6cm,top=2.5cm}
\AMCidsPosition{pos=top}

	Avertissement
	N'utilisez pas le paquet pgfpages ou toutes autres commandes de mise en page modifiant l'impression du nombre de pages par feuille.

La commande \AMCboxStyle (nouveau nom de la commande \AMCboxDimensions qui reste compatible avec les options ci-dessous) permet de modifier une ou plusieurs dimensions relatives aux cases à cocher :

Les valeurs par défaut des options sont :

\AMCboxStyle{shape=square,size=2.5ex,down=.4ex,rule=.5pt,outsidesep=.1em,color=black}

Pour obtenir des cases plus petites, on pourra, par exemple, utiliser la commande

\AMCboxStyle{size=1.7ex,down=.2ex}

Lors de l'utilisation de l'option ensemble, il est possible de modifier la manière de nommer les cases à cocher (c'est-à-dire ce qui sera inscrit dans chaque case). Le comportement par défaut est d'écrire des lettres majuscules, ou des chiffres si l'option chiffres est utilisée. Pour changer cela, il faut redéfinir la commande \AMCchoiceLabel, qui prend comme unique argument le nom du compteur utilisé pour la numérotation des cases. Ainsi, pour obtenir des lettres minuscules, on utilisera :

\def\AMCchoiceLabel#1{\alph{#1}}

De même, lors de l'utilisation du paquet LaTeX arabxetex, la commande suivante pourra se révéler utile :

\def\AMCchoiceLabel#1{\textLR{\Alph{#1}}}

Pour changer le style des lettres inscrites dans les cases, on pourra également redéfinir la commande \AMCchoiceLabelFormat. Par exemple, pour obtenir des lettres grasses, on utilisera :

\def\AMCchoiceLabelFormat#1{\textbf{#1}}

Pour changer le style des lettres inscrites à l'exterieur des cases, on pourra également redéfinir la commande \AMCoutsideLabelFormat. Par exemple, pour obtenir des lettres grasses, on utilisera :

\def\AMCoutsideLabelFormat#1{\textbf{#1}}

Note

La commande LaTeX pour basculer en mode corrigé (cases bonnes réponses coloriées) est \AMC@correctrue. Vous pouvez créer une commmande pour indiquer à AMC de basculer en mode corrigé même dans le sujet (DOC-sujet.pdf). Le code ci-dessous est à inscrire juste après \begin{document}. \makeatletter \def\AMCforcecorrect{\AMC@correctrue} \makeatother Vous pouvez inclure cette commande pour une question particulière qui sera encadrée par des accolades pour en limiter l'effet. Indiquez un barème nul ou utilisez la commande \QuestionIndicative {\AMCforcecorrect\begin{questionmult}{test}\QuestionIndicative ..... \end{questionmult} }

La façon dont chaque question est présentée peut être modifiée en redéfinissant la commande LaTeX AMCbeginQuestion, dont la définition par défaut est la suivante :

\def\AMCbeginQuestion#1#2{\par\noindent{\bf Question #1} #2\hspace*{1em}}

Le premier paramètre transmis à cette commande est le numéro de question à afficher. Le second paramètre contient \multiSymbole dans le cas dune question à plusieurs réponses possibles, et est vide dans les autres cas. La commande \multiSymbole peut aussi être modifiée : elle a pour charge de différentier les questions à réponses multiples des autres. Par défaut, elle affiche un trèfle :

\def\multiSymbole{$\clubsuit$}

Environnement reponsesperso

La présentation des réponses peut être modifiée de la même façon, si on utilise l'environnement reponsesperso au lieu de reponses ou reponseshoriz, en redéfinissant les trois macros LaTeX suivantes :

\def\AMCbeginAnswer{}
\def\AMCendAnswer{}
\def\AMCanswer#1#2{#1 #2}

Exemple 1

On peut utiliser des cases à cocher pour pénaliser les étudiants rendant leur copie en retard, par exemple (8 points en moins pour un petit retard, et 20 points en moins pour un retard exagéré). Il suffira d'inclure à l'endroit désiré (par exemple dans l'en-tête quelque chose comme ça (ici je demande un fond gris) :

\fcolorbox{black}{gray}{\insertRetard}

où la commande \insertRetard a été définie en-dehors de \exemplaire :

\def\insertRetard{ %
{\def\AMCbeginQuestion##1##2{}\AMCnobloc%
 \begin{questionmult}{00retard}
 \AMCnoCompleteMulti\AMCdontAnnotate%
 \def\AMCbeginAnswer{}\def\AMCendAnswer{}%
 Réservé~\begin{reponsesperso}[o]\mauvaise{R1~}\bareme{b=0,m=-8}\mauvaise{R2}\bareme{b=0,m=-20}\end{reponsesperso}%
 \end{questionmult}}%
}

• la commande \def\AMCbeginQuestion##1##2{} (combinée avec l'utilisation de l'environnement reponsesperso) permet qu'AMC n'écrive pas "Question XX".

• \def\AMCbeginAnswer{}\def\AMCendAnswer{} permettent également d'épurer le résultat.

• \AMCnoCompleteMulti permet de demander à AMC de ne pas rajouter la réponse "aucune de ces réponses n'est correcte" marlgré l'utilisation de questionmult.

• \AMCdontAnnotate demande à AMC de ne pas annoter ces cases là.

	Important
	Lorsque vous êtes à l'intérieur de la commande \exemplaire, il faut doubler les #. \def\AMCanswer##1##2{##1 ##2} \def\AMCbeginQuestion##1##2{}

Utilisation en mathématiques

\begin{questionmult}{formule}\bareme{mz=2}\AMCnoCompleteMulti
  Comment est définie la fonction identité ?
  \begin{reponsesperso}[o]
    \[f(x)=\bonne[$y$]{}\mauvaise[$x$]{}\bonne[$+$]{}\bonne[$x^2$]{}\]
  \end{reponsesperso}
\end{questionmult}

\AMCinterIrep=0pt
\AMCinterBrep=.5ex
\AMCinterIquest=0pt
\AMCinterBquest=3ex
\AMCpostNquest=1.5ex
\AMCpostOquest=7mm
\setlength{\AMChorizAnswerSep}{3em plus 4em}
\setlength{\AMChorizBoxSep}{1em}

Il est aussi possible de modifier la mise en page du formulaire de réponses séparé produit avec l'option ensemble (voir Un exemple avec une feuille de réponses séparée).

L'entrée de codes (par exemple pour que chaque étudiant codifie son numéro d'étudiant lui-même sur sa copie) peut être aisément effectuée à l'aide de la commande LaTeX

\AMCcodeGridInt[options]{identifiant}{nombre}

Les deux arguments de cette commande sont un identifiant de question que vous choisissez ainsi que le nombre de chiffres du codage désiré. On pourra, par exemple, utiliser l'en-tête de copie suivant :

{\setlength{\parindent}{0pt}\hspace*{\fill}\AMCcodeGridInt{etu}{8}\hspace*{\fill}
\begin{minipage}[b]{6.5cm}
$\longleftarrow{}$\hspace{0pt plus 1cm} codez votre numéro d'étu\-diant ci-contre,
et inscrivez votre nom et prénom ci-dessous.

\vspace{3ex}

\hfill\champnom{\fbox{
    \begin{minipage}{.9\linewidth}
      Nom et prénom :

      \vspace*{.5cm}\dotfill

      \vspace*{.5cm}\dotfill
      \vspace*{1mm}
    \end{minipage}
  }}\hfill\vspace{5ex}\end{minipage}\hspace*{\fill}

}

	Note
	Ici l'identifiant est etu qui servira à AMC pour attribuer chaque copie à un étudiant et 8 est le nombre de cases pour le code. Vous devrez sélectionner cet identifiant dans le menu déroulant Titre du code pour association automatique de l'onglet notation lors de l'association automatique des copies (voir la section intitulée « Association »).

Dans le cas de l'utilisation de l'option ensemble, la commande AMCcodeGridInt devra se trouver dans la partie formulaire, c'est-à-dire après la commande AMCdebutFormulaire.

La présentation de ces formulaires de saisie de codes peut être légèrement modifiée en changeant la valeur des dimensions \AMCcodeHspace, \AMCcodeVspace qui représentent les espaces horizontaux et verticaux entre les cases. Les valeurs par défaut sont définies de la manière suivante :

\AMCcodeHspace=.5em
\AMCcodeVspace=.5em

Pour la saisie de codes plus complexes, par exemple comportant des lettres, on pourra utiliser la commande \AMCcodeGrid[options]{identifiant}{description}. L'argument description contient une liste d'ensembles de caractères acceptés, séparés par des virgules. Par exemple, pour saisir un code client dont le premier caractère est une lettre entre A et E, suivi de trois chiffres, on utilisera

\AMCcodeGrid{client}{ABCDE,0123456789,0123456789,0123456789}

Les deux commandes \AMCcodeGrid et \AMCcodeGridInt acceptent des options, séparées par des virgules, dans l'argument optionnel options :

\makeatletter

\def\IDbox{% 
	\begin{minipage}{10cm}
		\noindent\AMCzone[id]{identification\thepage}{) 
			\fbox{%
				\begin{minipage}{\linewidth}
					\noindent Darken the boxes corresponding to your student ID:\\[1.2ex]
					\AMCcodeGrid[h,multi]{id}{ABCDEFGHJKLM,0123456789}
				\end{minipage}%
			}%
		}%
	\end{minipage}
}
\fancypagestyle{AMCpageFull}{% 
	\fancyhf{}%
	\fancyhead[L]{\AMC@LR{\he@dbas{\leavevmode\m@rque{positionHG}}}}%
	\fancyhead[R]{\AMC@LR{\he@dbas{\leavevmode\m@rque{positionHD}}}}%
	\fancyfoot[L]{\AMC@LR{\leavevmode\m@rque{positionBG}}}%
	\fancyfoot[R]{\AMC@LR{\leavevmode\m@rque{positionBD}}}%
	\fancyhead[C]{
		\AMCIDBoxesABC\vspace{4mm}
		\ifAMC@zoneformulaire\IDbox\fi
	}%
	\fancyhfoffset[EOLR]{5mm}%
	\fancyfoot[C]{\AMC@note}%
	\renewcommand{\headrulewidth}{0pt}%
	\renewcommand{\footrulewidth}{0pt}%
}
\makeatother

Si le mélange des question et des réponses ne nous convient pas, on peut toujours en changer en modifiant la graine du générateur aléatoire utilisé pour le mélange, grâce à la commande suivante (à utiliser juste au début du document, et en tous cas en-dehors de la commande exemplaire) :

\AMCrandomseed{1527384}

Si la valeur fournie (à choisir entre 1 et 4194303) est modifiée, alors le mélange sera différent. Bien entendu, une fois les copies d'examen imprimées, il ne faut surtout pas modifier cette valeur !

	Note
	La valeur est enregistrée dans le fichier xy (sous la forme \rngstate{1}{1515}). La valeur par défaut est 1515.

Pour que les sections définies dans votre sujet soient reprises dans la feuille de réponses séparées, utiliser \AMCsection et \AMCsubsection à la place de \section et \subsection (les commandes \AMCsection* et \AMCsubsection* sont également définies, pour des titres de section sans numérotation).

Dans la description du sujet, les commandes LaTeX \label, \ref et \pageref posent problème car elles seront appelées avec les mêmes arguments pour chaque copie produite, ce qui perturbera la numérotation des références. Pour résoudre ce problème, les commandes \AMClabel, \AMCref et \AMCpageref peuvent leur être substituées : elles ajoutent le numéro de la copie avant leur argument avant de le transmettre à \label, \ref et \pageref.

Il faudra en outre penser à remettre les compteurs utilisés à zéro au début de chaque copie. Par exemple, si on veut inclure des références à des images regroupées dans une page à part dans certaines questions, on pourra écrire quelque chose comme

\element{animaux}{
  \begin{figure}[p]
    \centering
    \includegraphics[width=.6\linewidth]{tigre}
    \caption{Un animal}
    \AMClabel{tigre}
  \end{figure}

  \begin{question}{tigre}
    Quel est l'animal sur la photographie de la figure~\AMCref{tigre}
    en page \AMCpageref{tigre}~?
    \begin{reponses}
      \bonne{Un tigre}
      \mauvaise{Une girafe}
      \mauvaise{Un éléphant}
      \mauvaise{Un chat}
    \end{reponses}
  \end{question}
}

en prenant soin d'ajouter au début de l'appel à \exemplaire (lors de la description de l'en-tête des copies) la ligne

\setcounter{figure}{0}

afin que les figures soient numérotées à partir de 1 pour chaque copie. Sans cette dernière commande, la numérotation des figures continuerait d'une copie à l'autre, ce qui n'est pas souhaitable.

Utilisation du paquet Cleveref.

Ce paquet permet d'ordonner les numéros des questions, les pages des questions ou les pages des références par ordre croissant (la documentation http://mirrors.ctan.org/macros/latex/contrib/cleveref/cleveref.pdf)

	Avertissement
	Le paquet doit être déclaré après le paquet automuliplechoice. \usepackage[french]{cleveref}

Lors de l'utilisation de \cref, les références des questions devront être transformées par la commande \AMCstudentlabel, comme dans l'exemple suivant :

\cref{\AMCstudentlabel{dipole},\AMCstudentlabel{cours},\AMCstudentlabel{raisonnement}}

Avec dipole, cours et raisonnement les références des questions sont indexées, respectivement, avec \AMClabel{dipole}, \AMClabel{cours}, \AMClabel{raisonnement}. Les numéros de ces trois questions seront automatiquement classés lors de la compilation.

	Avertissement
	L'utilisation de la commande \exemplaire{} remplace automatiquement les textes suivants par leurs valeurs par défaut en français. Si vous voulez les modifier, préférez donc l'utilisation de \onecopy{} à celle de \exemplaire{}.

Il est possible de personnaliser certain textes insérés par le paquet automultiplechoice, grâce à la commande \AMCtext :

Le code binaire permet à AMC de reconnaître le numéro du sujet et le numéro de la page du sujet.

Pour augmenter le nombre de sujets ou/et de pages par sujet, modifiez les valeurs par défaut des commandes \AMC@NCBetud, \AMC@NCBpage et \AMC@NCBcheck.

Dans le préambule, déclarez les commandes ci-dessous (ici avec les valeurs par défaut).

\makeatletter
\def\AMC@NCBetud{12}
\def\AMC@NCBpage{6}
\def\AMC@NCBcheck{6}
\makeatother          

	Note
	Un mode d'emploi succint se trouve à la fin de la documentation voir Divers).

Grâce au paquet LaTeX fp, dont la documentation se trouve sur http://mirrors.ctan.org/macros/latex/contrib/fp/README et que l'on peut charger grâce à la commande

\usepackage{fp}

ajoutée avant celle correspondant à automultiplechoice, on peut créer des exercices dont les données sont aléatoires. Commençons par un petit exemple :

\begin{question}{addition}
  \FPeval\VQa{trunc(1+random*8,0)}  
  \FPeval\VQb{trunc(4+random*5,0)}
  \FPeval\VQsomme{clip(VQa+VQb)}  
  \FPeval\VQnonA{clip(VQa+VQb-1)}  
  \FPeval\VQnonB{clip(VQa*VQb)}
  \FPeval\VQnonC{clip(VQa-VQb)}

  Quelle est la somme de \VQa{} et \VQb{} ?
  \begin{reponseshoriz}
    \bonne{\VQsomme}
    \mauvaise{\VQnonA}
    \mauvaise{\VQnonB}
    \mauvaise{\VQnonC}
  \end{reponseshoriz}
\end{question}

La commande \FPeval sert à faire des calculs :

Les noms de variables commençant par VQ ont été choisis afin de ne pas interférer avec d'autres commandes LaTeX.

	Note
	Vous pouvez choisir la base de génération des nombres pseudo-aléatoires (obtenus avec random) grâce à la commande \FPseed=entier entier doit être un entier immuable, qui ne changera jamais : ne pas utiliser de valeur liée à la date !

Choix parmi une suite d'intervalles

Le paquet automultiplechoice définit en outre une commande \choixIntervalles qui simplifie ce genre de constructions, comme illustré dans l'exemple suivant :

\begin{question}{inf-expo-indep}
  \FPeval\VQa{trunc(2 + random * 4,0)}
  \FPeval\VQb{trunc(6 + random * 5,0)}
  \FPeval\VQr{VQa/(VQa+VQb)}

  Soient $X$ et $Y$ deux variables aléatoires indépendantes, de lois exponentielles
  de paramètres respectifs \VQa{} et \VQb{}.
  À quel intervalle appartient la probabilité $\mathbb{P}[X<Y]$ ?

  \begin{multicols}{5}
    \begin{reponses}[o]
      \choixIntervalles{\VQr}{0}{1}{0.1}  
    \end{reponses}
  \end{multicols}
\end{question}

Cette ligne insère dix réponses correspondant aux intervalles [0,0.1[ [0.1,0.2[ ... [0.9,1[, tout en indiquant que le bon intervalle est celui qui contient VQr. Les arguments de la commande \choixIntervalle sont les suivants : La bonne réponse, La borne gauche du premier intervalle, La borne droite du dernier intervalle, La longueur de chaque intervalle.

La mise en forme des intervalles peut être modifiée en redéfinissant la commande \AMCintervalFormat, définie originellement par

\def\AMCIntervalFormat#1#2{[#1,\,#2[}

pour suivre une convention différente (on rencontra par exemple souvent l'utilisation de [a,b) à la place de [a,b[).

	Note
	Si vous préférez la virgule comme séparateur décimal, il faut utiliser la commande \num du paquet siunitx ( voir Divers). \def\AMCIntervalFormat#1#2{[\num{#1}-\,\num{#2}[}

Codage du résultat

Vous pouvez également demander aux étudiants de coder leur réponse numérique, grâce à la commande \AMCnumericChoices, comme dans l'exemple suivant :

\begin{questionmultx}{sqrt}
  \FPeval\VQa{trunc(5+random*15,0)}
  Calculez $\sqrt{\VQa}$ et arrondissez le résultat avec deux chiffres
  après la virgule.

  \AMCnumericChoices{sqrt(\VQa)}{digits=3,decimals=2,sign=true,
                 borderwidth=0pt,backgroundcol=lightgray,approx=5}
\end{questionmultx}

Notez l'utilisation de l'environnement questionmultx : nous avons besoin ici d'une question multiple car plusieurs cases doivent être cochées, mais pourtant une seule réponse est correcte, et nous ne souhaitons donc pas afficher le symbole des questions multiples normales.

Options

Les options disponibles dans le deuxième argument de cette commande sont les suivantes :

digits=num

donne le nombre de chiffres à coder (la valeur par défaut est 3).

decimals=num

donne le nombre de chiffres après la virgule (la valeur par défaut est 0). Quand num n'est pas nul, le paquet LaTeX fp doit être chargé.

base=num

donne la base dans laquelle sera écrit le nombre à coder (la valeur par défaut est 10).

significant=bool

avec la valeur true, les chiffres à renseigner sont les premiers chiffres significatifs du premier argument de \AMCnumericChoices.

Par exemple, la bonne réponse à \AMCnumericChoices{56945.23}{digits=2,significant=true} est 57.

exponent=num

demande une saisie en notation scientifique, avec num chiffres pour la puissance de 10.

nozero=bool

avec la valeur true, enlève le choix 0 pour tous les chiffres du nombre à saisir. Cette option peut être utile lors de la saisie de petits (<10) nombres non nuls.

sign=bool

demande (ou non) la saisie d'un signe (la valeur par défaut est true).

exposign=bool

même chose pour l'exposant.

strict=bool

avec la valeur true, une case doit être obligatoirement cochée pour le signe et pour chaque chiffre (même pour le chiffre 0). Avec la valeur false (valeur par défaut), si pour certains chiffres aucune case n'est cochée, ces chiffres seront fixés à la valeur 0.

ignoreblank=bool

avec la valeur true, ignore les cases non cochées. Valable uniquement en base 10.

vertical=bool

avec la valeur true, chaque chiffre sera représenté par une colonne. Avec la valeur false (valeur par défaut), chaque chiffre sera représenté par une ligne.

expovertical=bool

avec la valeur true, la mantisse et l'exposant seront présentés l'un en-dessous de l'autre. Avec la valeur false (valeur par défaut), ils seront présentés l'un à côté de l'autre.

reverse=bool

avec la valeur true (valeur par défaut), en mode vertical, les grandes valeurs des chiffres seront placées en haut plutôt qu'en bas.

vhead=bool

avec la valeur true, en mode vertical, un en-tête sera placé au-dessus de chaque colonne correspondant à un chiffre.

Le texte de cet en-tête est donné par la commande \AMCntextVHead, qui est originellement définie par

\def\AMCntextVHead#1{\emph{b#1}}

Cette définition permet de numéroter les chiffres binaires.

La valeur par défaut est false.

hspace=space

donne l'espace horizontal entre les cases (.5em par défaut).

vspace=space

donne l'espace vertical entre les cases (1ex par défaut).

borderwidth=space

donne l'épaisseur du cadre qui entoure toutes les cases (1mm par défaut).

bordercol=color

donne la couleur du cadre (lightgray par défaut).

backgroundcol=color

donne la couleur du fond (white par défaut).

Tsign=text

donne le texte à inscrire au-dessus des deux cases correspondant au signe (vous pouvez obtenir le même résultat grâce à \def\AMCntextSign{text}, le texte par défaut étant vide).

Tpoint=text

donne le texte correspondant à la virgule (décimale). Il peut également être modifié par \def\AMCdecimalPoint{text}, et la valeur par défaut est \raisebox{1ex}{\bf .}.

Texponent=text

donne le texte affiché entre la partie mantisse et la partie exposant.

Ce texte peut également être modifié par \def\AMCexponent{text}, et sa valeur par defaut est $\times10$\textasciicircum.

scoring=bool

avec la valeur true (valeur par défaut), un barème sera transmis à AMC.

scoreexact=num

donne le score à affecter à une réponse exacte (2 par défaut).

exact=num

donne la distance maximale à la valeur correcte en-dessous de laquelle une réponse sera considérée comme exacte (et sera rétribuée de scoreexact points). La valeur par défaut est 0.

scoreapprox=num

donne le score à affecter à une réponse approximative (1 par défaut).

approx=num

donne la distance maximale à la valeur correcte en-dessous de laquelle une réponse sera considérée comme approximative (et sera rétribuée de scoreapprox points). La valeur par défaut est 0.

	Avertissement
	AMC transforme tous les nombres (décimaux inclus) comme des entiers (en enlevant la virgule) avant de faire la différence et de comparer avec approx. Par exemple, si decimals=2, si la bonne valeur est 3,14 et si la valeur saisie est 3,2 alors la différence entière calculée est 320-314=6, de sorte que les points scoreapprox ne sont acquis que si approx vaut 6 ou plus.

scorewrong=num

donne le score à affecter à une réponse fausse (0 par défaut).

keepas=text

garde la valeur entrée par l'étudiant pour une future utilisation alsocorrect dans une autre question.

Toutes les questions qui suivent celle-ci doivent respecter l'ordre lexicographique des identifiants.

alsocorrect=text

donne une réponse valable basée sur la valeur entrée par l'étudiant dans la question précédente. La formule doit utiliser le code perl :

+, -, *, /, ** (puissance)

 \begin{question}{carre-a}
    \QuestionIndicative
    Choisissez le nombre que vous voulez
    \begin{reponseshoriz}[o]
      \mauvaise{2}\bareme{2,setglobal.Nombre=2}
      \mauvaise{3}\bareme{3,setglobal.Nombre=3}
      \mauvaise{4}\bareme{4,setglobal.Nombre=4}
      \mauvaise{5}\bareme{5,setglobal.Nombre=5}
    \end{reponseshoriz}
  \end{question}

  \begin{questionmultx}{carre-b}
    \AMCdontAnnotate\bareme{MAX=2}
    Quel est son carré ?
    \AMCnumericChoices{}{digits=2,approx=1,alsocorrect=Nombre**2}
  \end{questionmultx}



  \begin{minipage}{.3\linewidth}
    \begin{tikzpicture}
      \draw[fill=blue!50] (0,0) ellipse (1.5 and 0.2);
      \draw (1.5,0) -- (0,5) -- (-1.5,0);
      \draw (1.6,0) -- (2,0);
      \draw (1.6,5) -- (2,5);
      \draw[<->] (1.8,0) -- (1.8,5);
      \node[right] at (1.8,2.5) {$h=5$};
      \draw (0,-0.4) -- (0,-0.8);
      \draw (1.5,-0.4) -- (1.5,-0.8);
      \draw[<->] (0,-0.6) -- (1.5,-0.6);
      \node[below] at (0.75,-0.6) {$r=1.5$};
      \draw[fill=black] (0,0) circle (0.02);
    \end{tikzpicture}
  \end{minipage}
  \begin{minipage}{.65\linewidth}
    \begin{questionmultx}{cone-a}
      Quelle est la surface du disque bleu ?
      \AMCnumericChoices{pi*1.5^2}{digits=3,decimals=2,exponent=2,approx=2,sign=false,
      exposign=true,expovertical=true,keepas=Surface}
    \end{questionmultx}

    \begin{questionmultx}{cone-b}
      Quel est le volume du cône ?
      \AMCnumericChoices{pi*1.5^2*5/3}{digits=3,decimals=2,exponent=2,approx=2,sign=false,
      exposign=true,expovertical=true,alsocorrect=Surface*5/3}
    \end{questionmultx}
  \end{minipage}



  \begin{questionmultx}{pipi2-a}
    Combien vaut $\pi$ ?
    \AMCnumericChoices{pi}{digits=3,decimals=2,sign=false,keepas=Pi}
  \end{questionmultx}

  \begin{questionmultx}{pipi2-b}
    Combien vaut $\pi^2$ ?
    \AMCnumericChoices{pi^2}{digits=3,decimals=2,sign=false,approx=1,alsocorrect=Pi**2}
  \end{questionmultx}

Vous pouvez modifier la valeur par défaut (pour tout votre questionnaire) de toutes ces options grâce à la commande \AMCnumericOpts, comme

\AMCnumericOpts{scoreexact=3,borderwidth=2pt}

Vous pouvez de plus ajouter un texte à la suite des questions, quand la réponse à celle-ci est reléguée à une feuille séparée (par l'utilisation de l'option ensemble), en redéfinissant la commande \AMCntextGoto, comme ceci par exemple :

\def\AMCntextGoto{\par{\bf\emph{Codez la réponse
     sur la feuille de réponses séparée.}}}

Accès aux valeurs

intX

valeur brute entrée par l'étudiant.

intV

bonne valeur brute.

Vous devez déclarer ce paquet, ainsi que les bibliothèques, \usetikzlibrary{arrows,patterns}, après automuliplechoice.

Le paquet LaTeX pgf/tikz, dont la documentation se trouve sur http://www.ctan.org/tex-archive/graphics/pgf/base possède notamment une bibliothèque mathématique que l'on peut charger grâce à la commande :

\usepackage{tikz}

La première précaution à prendre pour avoir des sujets identiques malgré les recompilations latex est de choisir la base de génération des nombres pseudo-aléatoires.

\pgfmathsetseed{2056}

Réaliser un calcul simple

Voici un exemple d'utilisation avec un calcul simple :

\begin{question}{inverse}
  \pgfmathrandominteger{\x}{1}{50}

  Quel est l'inverse de $x=\x$ ?

  \begin{reponses}
    \bonne{\pgfmathparse{1/\x}\pgfmathresult }
    \mauvaise{\pgfmathparse{1/(\x +1))}\pgfmathresult}
    \mauvaise{\pgfmathparse{cos(\x)} \pgfmathresult}
    \mauvaise{\pgfmathparse{\x^(-0.5)}\pgfmathresult}
  \end{reponses}
\end{question}

Les commandes \pgfmathparse et \pgfmathresult permettent respectivement d'effectuer le calcul et d'afficher son résultat.

Il est possible de choisir la mise en forme des résultats en utilisant la commande \pgfmathprintnumber, par exemple, ici on choisit une notation avec trois décimales, en utilisant une virgule comme séparateur décimal.

\begin{question}{inverse3}
  \pgfmathrandominteger{\x}{1}{50}
  \pgfkeys{/pgf/number format/.cd,fixed,fixed zerofill,precision=3,use comma}
  Quel est l'inverse de $x=\pgfmathprintnumber{\x}$ ?

  \begin{reponses}
    \bonne{\pgfmathparse{1/\x}\pgfmathprintnumber{\pgfmathresult}}
    \mauvaise{\pgfmathparse{1/(\x +1))} \pgfmathprintnumber{\pgfmathresult}}
    \mauvaise{\pgfmathparse{cos(\x)} \pgfmathprintnumber{\pgfmathresult}}
    \mauvaise{\pgfmathparse{\x^(-0.5)} \pgfmathprintnumber{\pgfmathresult}}
  \end{reponses}
\end{question}

	Note
	Les commandes \AMCIntervals et \AMCnumericChoices peuvent aussi être utilisées dans ce contexte (voir la section intitulée « Choix parmi une suite d'intervalles » et la section intitulée « Codage du résultat »)

\begin{questionmult}{graphique}
  On considère trois fonctions f(x) dont les tracés sont représentés ci-dessous
  dans un repère orthonormé~:
  \pgfmathrandominteger{\a}{2}{4}
  \begin{center}
    \begin{tikzpicture}[domain=0:4]
      \draw[very thin,color=gray] (-0.1,-4.1) grid (3.9,3.9);
      \draw[->] (-0.2,0) -- (4.2,0) node[right] {$x$};
      \draw[->] (0,-4.2) -- (0,4.2) node[above] {$f(x)$};
      \draw[color=red] plot (\x,{(1+\a/4)*\x-\a}) node[right] {$f_{1} (x)$};
      \draw[color=blue] plot (\x,{\a*sin(\x r)}) node[right] {$f_{2}(x)$};
      \draw[color=orange] plot (\x,{\a*cos(\x r)}) node[right] {$f_{3}(x)$};
    \end{tikzpicture}
  \end{center}
  Alors :
  \begin{reponses}
    \pgfmathrandominteger{\x0}{2}{4}
    \bonne{$f_{2}(\x0)$=\pgfmathparse{\a*sin(\x0 r)} \pgfmathprintnumber{\pgfmathresult}.}
    \bonne{$f_{3}(\x0)$=\pgfmathparse{\a*cos(\x0 r)} \pgfmathprintnumber{\pgfmathresult}.}
    \mauvaise{La fonction $f_{1}(x)$ est une fonction linéaire.}
  \end{reponses}
\end{questionmult}

Il est possible d'utiliser le langage de programmation LUA au sein de documents latex en compilant le sujet grâce à la commande lualatex. Si vous choisissez cette compilation, votre sujet doit être encodé en UTF-8, et il ne faut pas charger le package inputenc. Pour de plus amples informations, lire l'article de Manuel Pégourié-Gonnard présentant le projet à l'adresse suivante : http://dante.ctan.org/tex-archive/info/luatex/lualatex-doc/lualatex-doc.pdf

Pour faire appel au langage LUA, il faut utiliser la commande \directlua. La fonction LUA la plus utile est tex.print qui écrit un résultat calculé par LUA dans le document LaTeX

Encore une fois, si vous utilisez des nombres aléatoires, commencez par choisir la base de génération des nombres pseudo-aléatoires.

\directlua{math.randomseed (2048)}

Voici un exemple très simple de fichier_:

\documentclass[a4paper]{article}
%\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais,bloc,completemulti]{automultiplechoice}
\begin{document}

\exemplaire{10}{

%%% debut de l'en-tête des copies :

\noindent{\bf QCM  \hfill TEST}

\vspace*{.5cm}
\begin{minipage}{.4\linewidth}
  \centering\large\bf Sujet simpliste
\end{minipage}
\champnom{\fbox{\begin{minipage}{.5\linewidth}
Nom et prénom :

\vspace*{.5cm}\dotfill
\vspace*{1mm}
\end{minipage}}}

%%% fin de l'en-tête

\directlua{math.randomseed (2048)}
\directlua{a=math.random()}

\begin{question}{calcul}
  Quelle est la racine carrée de \directlua{tex.print(a)}?

  \begin{reponses}
    \bonne{\directlua{tex.print(math.sqrt(a))}}
    \mauvaise{\directlua{tex.print(math.sqrt(2*a))}}
    \mauvaise{\directlua{tex.print(math.sqrt(a*1.001))}}
  \end{reponses}
\end{question}

}

\end{document}      

Il est aussi possible de mettre en forme les résultats donnés par lua soit en écrivant des fonctions lua, soit en utilisant le package siunitx

	Note
	Les commandes \AMCIntervals et \AMCnumericChoices peuvent aussi être utilisées dans ce contexte (voir la section intitulée « Choix parmi une suite d'intervalles » et la section intitulée « Codage du résultat »)