Description
List questions are similar to Blanks type questions in terms of their application, with some important differences:
- List questions do not support the mathematical formula grader;
- List questions allow only a single response object (entry cell) in the question; and
- List questions allow authors to specify multiple correct (and even incorrect but expected) answers.
Question authors can control the amount of credit awarded for each specified answer. For each specified incorrect answer, authors can define response-specific comments.
Notes
- In List questions, the
\answer
macro requires two arguments:\answer{credit}{answer}
- credit
- The amount of credit that a response matching this answer will receive. Must be a decimal value between 0 and 1, inclusive.
- answer
- The answer against which the student's response is to be compared.
\answer
may appear in each question, but at least one answer must give full (equal to 1.0) credit. - By default, the student response input
cell is displayed as a text box. Using
\display{menu}
will cause the response object to be displayed as a drop-down menu, listing the responses specified with the\answer
macro. - Grading is done by comparing the student
response with each author-specified answer, in order, until
a match is found. The corresponding credit is then
returned. If no match is found, the credit is zero. By
default, the grader is set to use 'exact' grading, so that
all capitalization and punctuation must match, although
multiple spaces are automatically collapsed to one space.
Authors may use the
\grader
macro to select select a different grader. The macro takes one argument, which must be one of the available graders:\grader{exact|relaxed|regex}
- Argument 1 must be one of the following:
-
- exact
- Strings of spaces are collapsed to a single
space, but all capitalization and punctuation
must match.
This is the default. If the optional argument is omitted, it is assumed to beexact
. - relaxed
- Strings of spaces are collapsed to a single space, and case and punctuation are ignored.
- regex
- This provides access to the student response set as a regular expression, for interacting with custom graders created from EDU's Question API.
- The emphasis on comparing the student's response to the specified responses in order is necessary because someone writing regular expression questions might well want to start with a very specific criteria for full credit and then allow more vague criteria for low credit.
- List questions can have multiple comments,
with one assigned to each specified response, and one
default comment. The
\comment
macro will assign its argument as the feedback associated with the preceding\answer
. If a\comment
statement appears in a question prior to any answers, that comment will be the default, to be displayed as feedback if the student's response does not match any of the specified responses.
Examples
% text display, exact grading \begin{question}{List} \qutext{Who was President during the Civil War?} \answer{1.0}{Lincoln} \answer{1.0}{Abraham Lincoln} \answer{0.25}{Jefferson Davis} \end{question}
% text display, relaxed grading \begin{question}{List} \qutext{Who was President during the Civil War?} \grader{relaxed} \answer{1.0}{Lincoln} \comment{Yes, although you should use his first name too.} \answer{1.0}{Abraham Lincoln} \comment{Exactly correct.} \answer{0.25}{Jefferson Davis} \comment{Your answer is partially correct - he was President of the CSA, but not the USA.} \end{question}
% menu display, exact grading \begin{question}{List} \qutext{Who was President during the Civil War?} \display{menu} \answer{0}{Stephen A. Douglass} \comment{No, but if he had been a better debater, perhaps...} \answer{1.0}{Abraham Lincoln} \comment{Correct.} \answer{0.25}{Jefferson Davis} \comment{Your answer is partially correct - he was President of the CSA, but not the USA.} \end{question}
% text display, regex grading \begin{question}{List} \qutext{Who was President during the Civil War?} \answer{1.0}{(l|L)incoln} % "lincoln" or "Lincoln" \answer{0.1}{(l|L).*} % anything beginning with "l" or "L" % Recall that student responses are compared to the specified % responses in order. If the two answers were listed in the % opposite order, it would be impossible to get full credit. \end{question}