4.4: Setup
- Page ID
- 555711
\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)
\( \newcommand{\dsum}{\displaystyle\sum\limits} \)
\( \newcommand{\dint}{\displaystyle\int\limits} \)
\( \newcommand{\dlim}{\displaystyle\lim\limits} \)
\( \newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\)
( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\)
\( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)
\( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\)
\( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)
\( \newcommand{\Span}{\mathrm{span}}\)
\( \newcommand{\id}{\mathrm{id}}\)
\( \newcommand{\Span}{\mathrm{span}}\)
\( \newcommand{\kernel}{\mathrm{null}\,}\)
\( \newcommand{\range}{\mathrm{range}\,}\)
\( \newcommand{\RealPart}{\mathrm{Re}}\)
\( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)
\( \newcommand{\Argument}{\mathrm{Arg}}\)
\( \newcommand{\norm}[1]{\| #1 \|}\)
\( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)
\( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\AA}{\unicode[.8,0]{x212B}}\)
\( \newcommand{\vectorA}[1]{\vec{#1}} % arrow\)
\( \newcommand{\vectorAt}[1]{\vec{\text{#1}}} % arrow\)
\( \newcommand{\vectorB}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\( \newcommand{\vectorC}[1]{\textbf{#1}} \)
\( \newcommand{\vectorD}[1]{\overrightarrow{#1}} \)
\( \newcommand{\vectorDt}[1]{\overrightarrow{\text{#1}}} \)
\( \newcommand{\vectE}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash{\mathbf {#1}}}} \)
\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)
\(\newcommand{\longvect}{\overrightarrow}\)
\( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)
\(\newcommand{\ket}[1]{\left| #1 \right>}\)
\(\newcommand{\bra}[1]{\left< #1 \right|}\)
\(\newcommand{\braket}[2]{\left< #1 \vphantom{#2} \right| \left. #2 \vphantom{#1} \right>}\)
\(\newcommand{\braopket}[3]{\left< #1 \vphantom{#2}\vphantom{#3} \right| #2 \vphantom{#1}\vphantom{#3} \left| #3 \vphantom{#1}\vphantom{#2} \right>}\)
\(\newcommand{\qmvec}[1]{\mathbf{\vec{#1}}}\)
\(\newcommand{\op}[1]{\hat{\mathbf{#1}}}\)
\(\newcommand{\expect}[1]{\langle #1 \rangle}\)
\(\newcommand{\dfn}[1]{\emph{\textbf{#1}}}\)
\(\newcommand{\avec}{\mathbf a}\) \(\newcommand{\bvec}{\mathbf b}\) \(\newcommand{\cvec}{\mathbf c}\) \(\newcommand{\dvec}{\mathbf d}\) \(\newcommand{\dtil}{\widetilde{\mathbf d}}\) \(\newcommand{\evec}{\mathbf e}\) \(\newcommand{\fvec}{\mathbf f}\) \(\newcommand{\nvec}{\mathbf n}\) \(\newcommand{\pvec}{\mathbf p}\) \(\newcommand{\qvec}{\mathbf q}\) \(\newcommand{\svec}{\mathbf s}\) \(\newcommand{\tvec}{\mathbf t}\) \(\newcommand{\uvec}{\mathbf u}\) \(\newcommand{\vvec}{\mathbf v}\) \(\newcommand{\wvec}{\mathbf w}\) \(\newcommand{\xvec}{\mathbf x}\) \(\newcommand{\yvec}{\mathbf y}\) \(\newcommand{\zvec}{\mathbf z}\) \(\newcommand{\rvec}{\mathbf r}\) \(\newcommand{\mvec}{\mathbf m}\) \(\newcommand{\zerovec}{\mathbf 0}\) \(\newcommand{\onevec}{\mathbf 1}\) \(\newcommand{\real}{\mathbb R}\) \(\newcommand{\twovec}[2]{\left[\begin{array}{r}#1 \\ #2 \end{array}\right]}\) \(\newcommand{\ctwovec}[2]{\left[\begin{array}{c}#1 \\ #2 \end{array}\right]}\) \(\newcommand{\threevec}[3]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \end{array}\right]}\) \(\newcommand{\cthreevec}[3]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \end{array}\right]}\) \(\newcommand{\fourvec}[4]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \\ #4 \end{array}\right]}\) \(\newcommand{\cfourvec}[4]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \\ #4 \end{array}\right]}\) \(\newcommand{\fivevec}[5]{\left[\begin{array}{r}#1 \\ #2 \\ #3 \\ #4 \\ #5 \\ \end{array}\right]}\) \(\newcommand{\cfivevec}[5]{\left[\begin{array}{c}#1 \\ #2 \\ #3 \\ #4 \\ #5 \\ \end{array}\right]}\) \(\newcommand{\mattwo}[4]{\left[\begin{array}{rr}#1 \amp #2 \\ #3 \amp #4 \\ \end{array}\right]}\) \(\newcommand{\laspan}[1]{\text{Span}\{#1\}}\) \(\newcommand{\bcal}{\cal B}\) \(\newcommand{\ccal}{\cal C}\) \(\newcommand{\scal}{\cal S}\) \(\newcommand{\wcal}{\cal W}\) \(\newcommand{\ecal}{\cal E}\) \(\newcommand{\coords}[2]{\left\{#1\right\}_{#2}}\) \(\newcommand{\gray}[1]{\color{gray}{#1}}\) \(\newcommand{\lgray}[1]{\color{lightgray}{#1}}\) \(\newcommand{\rank}{\operatorname{rank}}\) \(\newcommand{\row}{\text{Row}}\) \(\newcommand{\col}{\text{Col}}\) \(\renewcommand{\row}{\text{Row}}\) \(\newcommand{\nul}{\text{Nul}}\) \(\newcommand{\var}{\text{Var}}\) \(\newcommand{\corr}{\text{corr}}\) \(\newcommand{\len}[1]{\left|#1\right|}\) \(\newcommand{\bbar}{\overline{\bvec}}\) \(\newcommand{\bhat}{\widehat{\bvec}}\) \(\newcommand{\bperp}{\bvec^\perp}\) \(\newcommand{\xhat}{\widehat{\xvec}}\) \(\newcommand{\vhat}{\widehat{\vvec}}\) \(\newcommand{\uhat}{\widehat{\uvec}}\) \(\newcommand{\what}{\widehat{\wvec}}\) \(\newcommand{\Sighat}{\widehat{\Sigma}}\) \(\newcommand{\lt}{<}\) \(\newcommand{\gt}{>}\) \(\newcommand{\amp}{&}\) \(\definecolor{fillinmathshade}{gray}{0.9}\)
Setup
Setup is where a general prompt becomes a specific, randomized instance. This is where you define values, choose realistic options, and create answer objects for the blanks in the Statement. For randomization patterns and best practices, see Advanced Randomization Techniques. Variables defined here are inserted into the prompt using command substitution. For a catalog of question types and the widgets they use, see Different Question Types.
Setup is the section most life science instructors edit. Think of it as the lab notebook for the problem: if the values, units, or tolerances are wrong here, no amount of prompt editing will fix grading.
How to read this code
The setup section is where the abstract idea of the problem becomes concrete. This is where values are chosen, constrained, and combined into the exact targets the grader will check. If a problem behaves differently across seeds or produces surprising answers, this is the first place to look.
The excerpt below defines the answer objects used later in the statement. Nothing here is visible to students, but everything here controls grading behavior.
$radio1 = RadioButtons( [ 'Red', 'Blue', 'Green', 'None of these' ], 'Blue', ); $radio2 = RadioButtons( [ 'Red', 'Blue', 'Green', 'None of these' ], 2, separator => $SPACE x 5 );
Line notes
| Line or snippet | What it does | What you would change first |
|---|---|---|
RadioButtons(...) |
Creates a radio-button answer object. | Change this if you switch interaction types. |
[ 'Red', 'Blue', 'Green', 'None of these' ] |
Defines what students can select. | Edit when changing the story or options. |
'Blue' |
Sets the correct answer by value. | Use this when clarity matters more than indexing. |
2 |
Sets the correct answer by index (starting at 0). | Use when randomizing or reordering choices. |
separator => $SPACE x 5 |
Controls layout spacing. | Adjust for readability only. |
A frequent source of confusion is changing the prompt text without updating the corresponding answer object. Keeping all answer definitions together in setup makes these mismatches easier to spot.
Why this exists: it turns a story into answer objects and grading rules that the PGML can use.
| Common edits | Common failures |
|---|---|
|
|
Try it now: change one choice, render a variant, and confirm the correct answer still matches the intended option and the layout is readable.
Answer objects and choices
| Answer object | Choice list | Correct answer | Why it exists |
|---|---|---|---|
| radio1 | Red, Blue, Green, None of these | Blue (by value) | Single-choice prompt with a clear correct label. |
| radio2 | Red, Blue, Green, None of these | Index 2 | Same options with a horizontal layout. |
Answer targets are the glue between Setup and Statement: these are the answer objects attached to blanks in the prompt.
Answer targets
| Answer object | Correct answer | How it is set | Used by which blank |
|---|---|---|---|
| radio1 | Blue | Value string | radio1 blank |
| radio2 | Index 2 | Index in list (0-based) | radio2 blank |
Answer object options
| Option | What it controls | When to use it |
|---|---|---|
| Correct answer by value | Chooses the correct option by its label. | When clarity matters more than index tracking. |
| Correct answer by index | Chooses the correct option by position. | When you randomize or reorder choices. |
| separator => $SPACE x 5 | Spacing between choices. | When horizontal layout needs breathing room. |
Broken example: correct answer does not match the story
This problem renders and accepts input, but grading behaves unexpectedly. Students select the correct option according to the prompt, but the system marks it wrong.
$radio = RadioButtons( [ 'ATP', 'ADP', 'AMP' ], 'AMP', );
The statement later asks which molecule has the highest energy.
What went wrong
- The story implies ATP is correct.
- The setup defines AMP as the correct answer.
- The grader is doing exactly what it was told.
How to recognize it
- Multiple students report being marked wrong for the same choice.
- Previewing the problem shows consistent wrong grading.
- The solution displays a different answer than the prompt implies.
How to fix it
Always read the setup and the statement back to back. When changing the story, update the setup first, then confirm the statement still matches.
Keep the choice lists and correct answers aligned with the statement text so the grading intent stays obvious.


