5.4: Matching
- Page ID
- 555717
\( \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}\)
Matching (MATCH) is best for vocabulary, functional associations, and paired relationships. In science courses, it works well for mapping terms to definitions or steps to outcomes.
Matching is strongest when the task is association, not recall of a sentence from a glossary. Prompts should be short and choices should be short, but the pairing should reflect a functional relationship students use in biology. If the correct pairing is obvious from word shape alone, add one distractor choice only when it forces actual thinking.
Inputs
question_text(str)prompts_list(list): items to be matchedchoices_list(list): possible matching answers
Science example (biochemistry)
question_text: Match each macromolecule class with the most typical monomer unit. prompts_list: - Proteins - Nucleic acids - Polysaccharides choices_list: - Amino acids - Nucleotides - Monosaccharides
Official example (OpenWeBWorK PG samples): Matching. Macro reference: PGchoicemacros.
Preferred PGML pattern
Use PopUp from parserPopUp.pl and place each dropdown inline in PGML next to its prompt. This gives a clean matching layout without legacy PG macros.
loadMacros(
"PGstandard.pl",
"PGML.pl",
"parserPopUp.pl",
"PGcourse.pl",
);
$popup1 = PopUp([ '?', 'Amino acids', 'Nucleotides', 'Monosaccharides' ],
'Amino acids');
$popup2 = PopUp([ '?', 'Amino acids', 'Nucleotides', 'Monosaccharides' ],
'Nucleotides');
$popup3 = PopUp([ '?', 'Amino acids', 'Nucleotides', 'Monosaccharides' ],
'Monosaccharides');
BEGIN_PGML
Match each macromolecule class with its monomer.
1. Proteins [_]{$popup1}
2. Nucleic acids [_]{$popup2}
3. Polysaccharides [_]{$popup3}
END_PGML
For advanced matching layouts with tables or formatted columns, see Randomized Matching Problems (Matching Problems).
Complete working examples
Macromolecule matching -- Match each macromolecule class with its monomer unit using PopUp dropdowns.
## TITLE('Match macromolecule classes to monomers')
## DESCRIPTION
## Match each macromolecule class with its monomer unit
## using PopUp dropdown widgets.
## ENDDESCRIPTION
## KEYWORDS('macromolecules','monomers','PopUp','matching')
## DBsubject('Biochemistry')
## DBchapter('Macromolecules')
## DBsection('Structure')
## Date('2026-02-15')
## Author('Author name')
## Institution('Institution name')
DOCUMENT();
loadMacros(
"PGstandard.pl",
"PGML.pl",
"parserPopUp.pl",
"PGcourse.pl",
);
$popup1 = PopUp(
['?', 'Amino acids', 'Nucleotides', 'Monosaccharides'],
'Amino acids');
$popup2 = PopUp(
['?', 'Amino acids', 'Nucleotides', 'Monosaccharides'],
'Nucleotides');
$popup3 = PopUp(
['?', 'Amino acids', 'Nucleotides', 'Monosaccharides'],
'Monosaccharides');
BEGIN_PGML
Match each macromolecule class with its monomer.
1. Proteins [_]{$popup1}
2. Nucleic acids [_]{$popup2}
3. Polysaccharides [_]{$popup3}
END_PGML
ENDDOCUMENT();
Bond type matching -- Match each molecular scenario with the type of bond or interaction involved.
## TITLE('Match molecular interactions to bond types')
## DESCRIPTION
## Match each molecular scenario to the correct bond type
## using PopUp dropdown widgets.
## ENDDESCRIPTION
## KEYWORDS('chemical bonds','matching','PopUp')
## DBsubject('Chemistry')
## DBchapter('Chemical Bonding')
## DBsection('Bond Types')
## Date('2026-02-15')
## Author('Author name')
## Institution('Institution name')
DOCUMENT();
loadMacros(
"PGstandard.pl",
"PGML.pl",
"parserPopUp.pl",
"PGcourse.pl",
);
$popup1 = PopUp(
['?', 'Ionic', 'Covalent', 'Hydrogen'],
'Covalent');
$popup2 = PopUp(
['?', 'Ionic', 'Covalent', 'Hydrogen'],
'Ionic');
$popup3 = PopUp(
['?', 'Ionic', 'Covalent', 'Hydrogen'],
'Hydrogen');
BEGIN_PGML
Match each molecular scenario to the type of bond
or interaction involved.
1. Two atoms share a pair of electrons [_]{$popup1}
2. An electron is transferred from one atom to another [_]{$popup2}
3. A partially positive H is attracted to a nearby electronegative atom [_]{$popup3}
END_PGML
ENDDOCUMENT();
Authoring notes
- Keep the prompts and choices short and parallel.
- If there are obvious one-to-one pairs, add 1-2 extra distractor choices only if it helps learning.


