Skip to main content
Chemistry LibreTexts

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 matched
    • choices_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.

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