Skip to main content
Chemistry LibreTexts

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

    How to read this code reference.
    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.

    How to read this code: common edits and common failures.
    Common edits Common failures
    • Edit choice lists or correct answers.
    • Adjust layout spacing or ordering.
    • Correct answer no longer matches the choice list.
    • Statement references the wrong answer object.

    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 objects and choices reference.
    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 targets: answer object, correct answer, how it is set, and more.
    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

    Answer object options: option, what it controls, and when to use it.
    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.


    This page titled 4.4: Setup was last modified on Fri, 27 Feb 2026 15:20:39 GMT and is shared under a CC BY 4.0 license and was authored, remixed, and/or curated by Neil R. Voss.