numerique.moodle: Créer une question à réponse numérique simple
In SARP.moodle: XML Output Functions for Easy Creation of Moodle Questions

numerique.moodle

R Documentation

Créer une question à réponse numérique simple

Description

Cette fonction permet de créer une question dont la réponse est une valeur numérique unique.

Usage

numerique.moodle( texte, bonne.reponse, notes = 100,
                  n.decimales = get( "nombre.chiffres", envir = SARP.Moodle.env ),
                  n.significatifs = NA,
                  titre = "Question num&eacute;rique...",
                  commentaire.global = NA, penalite = NA, note.question = NA,
                  idnum = NA,
                  tolerance.type = 2, tolerance = "auto",
                  unites = NULL, unite.avant = FALSE,
                  unite.penalite = 0.1, unite.visible = FALSE,
                  commentaires = NULL, couleur.consigne = "Orange",
                  temps,
                  fichier.xml = get( "fichier.xml", envir = SARP.Moodle.env ) )

Arguments

`texte`	L'énoncé de la question (une chaîne de caractères). Cet énoncé peut contenir n'importe quel caractère (codage en UTF-8) et n'importe quelles balises HTML.
`bonne.reponse`	La valeur numérique correspondant à la bonne réponse. Depuis Moodle 3, plusieurs valeurs peuvent être proposées.
`notes`	Lorsque plusieurs valeurs peuvent être acceptées comme réponse, la note (en fraction de la note totale de la question) associée à chaque réponse.
`n.decimales`	Le nombre de décimales à conserver pour la bonne réponse (utiliser `NA` pour ne pas arrondir); par défaut, la valeur indiquée à la création du questionnaire est utilisée.
`n.significatifs`	Le nombre de chiffres significatifs à conserver pour la bonne réponse (utiliser `NA` pour ne pas arrondir); par défaut, la valeur indiquée à la création du questionnaire est utilisée.
`titre`	L'intitulé de la question, en HTML.
`fichier.xml`	Le fichier correspondant au questionnaire qui contiendra cette question (par défaut, le dernier créé).
`commentaire.global, penalite, note.question, idnum`	Options communes à toutes les questions Moodle, voyez `debut_question.moodle`.
`tolerance.type`	La façon dont est exprimée la tolérance. Les valeurs possibles sont 1 (tolérance relative: la valeur de la tolérance est un pourcentage de la réponse), 2 (tolérance absolue) et 3 (tolérance « géométrique »).
`tolerance`	La tolérance associée à chaque réponse. Si une seule valeur est fournie, elle sera utilisée pour toutes les réponses. La valeur spéciale `"auto"` calcule une tolérance de `1{,}1\times10^{-n}`, où `n` est le nombre de décimales demandé pour l'arrondi si `n.decimales > 0`, et 0 sinon.
`unites`	Un vecteur de multiplicateurs indiquant les conversions possible d'unités pour la réponse. Les noms de ce vecteurs définissent les unités.
`unite.avant`	Si `TRUE`, l'unité sera affichée et attendue avant la valeur numérique (pour les unités monétaires anglosaxonnes, typiquement). Sinon, elle sera affichée et attendue après la valeur numérique.
`unite.penalite`	La pénalité en cas d'erreur sur l'unité.
`unite.visible`	Si `TRUE`, l'unité peut être choisie dans un menu déroulant. Sinon, elle doit être entrée dans le champ de la réponse, comme un texte.
`commentaires`	Le commentaire à affiche selon la réponse proposée. Il doit y avoir autant de valeurs que de bonne réponses (certaines pouvant être `NA`, pour ne pas avoir de commentaire pour la réponse associée).
`couleur.consigne`	La couleur à utiliser pour afficher le texte de la consigne générée, lorsque l'on précise l'arrondi. Doit être une chaîne de caractères décrivant une couleur reconnaissable en CSS.
`temps`	Le temps conseillé pour répondre à la question, en minutes.

Details

En l'absence de tolérance, la bonne réponse doit être donnée exactement: n'oubliez pas d'arrondir la valeur au bon nombre de décimales, soit en utilisant l'option n.decimales ou n.significatifs, soit avant d'appeler la fonction.

Si n.decimales est précisé et strictement positif, l'arrondi est fait avec la fonction round de R. Dans ce cas, un message est automatiquement ajouté à la fin du texte de la question, précisant le nombre de décimales attendu. Ce texte est sur sa propre ligne (précédé d'une balise HTML  ), en italique (balises HTML  et ) et avec la couleur indiquée par couleur.consigne.

Si n.significatif est précisé et strictement positif, l'arrondi est fait avec la fonction signif de R. Dans ce cas, un message est automatiquement ajouté à la fin du texte de la question, précisant le nombre de chiffres significatifs attendu. Ce texte est sur sa propre ligne (précédé d'une balise HTML  ), en italique (balises HTML  et ) et avec la couleur indiquée par couleur.consigne.

Lorsque vous attendez une réponse entière, pour ne pas avoir d'arrondi, de tolérance ni de consigne associée, forcez le type de bonne.reponse à être un entier, et pas un double (fonction as.integer de R).

La tolérance \tau permet d'accepter toutes les valeurs dans un intervalle [a,b], calculé à partir de la réponse r. Le calcul dépend du type de tolérance demandé: pour le type 1, a=r-\delta et b=r+\delta, avec \delta=\tau\,r. Pour le type 2, \delta=\tau. Pour le type 3, a=r/(1+\tau) et b=r(1+\tau).

Value

Aucune valeur n'est renvoyée par cette fonction.

Author(s)

Emmanuel Curis emmanuel.curis@parisdescartes.fr

Examples

## Not run: 
# Commencer un nouveau questionnaire
q <- debuter_xml.moodle( "exemple.numerique" )

# Catégorie : exemples
categorie.moodle( "Exemples SARP/Numérique" )

# Une question Moodle numérique, avec 3 décimales
numerique.moodle( "Donnez la valeur de &pi;", pi, n.decimales = 3 )

# On termine le questionnaire
finir_xml.moodle( )

# Importez le fichier exemple.numerique.xml dans Moodle pour voir le résultat...
print(
"Importez le fichier exemple.numerique.xml dans Moodle pour voir le résultat..." )

## End(Not run)

SARP.moodle documentation built on June 8, 2023, 6:37 a.m.