Difference between revisions of "Scaffold"
(added historical tag and gave updated problem link) |
|||
(8 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{historical}} |
||
+ | |||
+ | <p style="font-size: 120%;font-weight:bold">This problem has been replaced with [https://openwebwork.github.io/pg-docs/sample-problems/Misc/Scaffolding.html a newer version of this problem]</p> |
||
<h2>Simple Scaffolded, MultiPart Problems Worked Sequentially</h2> |
<h2>Simple Scaffolded, MultiPart Problems Worked Sequentially</h2> |
||
<p style="background-color:#eeeeee;border:black solid 1px;padding:3px;"> |
<p style="background-color:#eeeeee;border:black solid 1px;padding:3px;"> |
||
− | <em>This is the PG code to create a scaffolded problem with multiple parts that are displayed sequentially. This way uses a recent macro, <code>scaffold.pl</code> that creates a neat student interface - similar to that of [[CompoundProblem5 |
+ | <em>This is the PG code to create a scaffolded problem with multiple parts that are displayed sequentially. This way uses a recent macro, <code>scaffold.pl</code> that creates a neat student interface - similar to that of [[CompoundProblem5]] but with a much cleaner style for authors. The interface has tabs containing sections of the problem that can dynamically open and close. </em> |
</p> |
</p> |
||
Line 24: | Line 27: | ||
"MathObjects.pl", |
"MathObjects.pl", |
||
"parserMultiAnswer.pl", |
"parserMultiAnswer.pl", |
||
− | "scaffold |
+ | "scaffold.pl", |
"PGcourse.pl", |
"PGcourse.pl", |
||
); |
); |
||
Line 44: | Line 47: | ||
<pre> |
<pre> |
||
Context("Numeric"); |
Context("Numeric"); |
||
− | Context()->variables->are(x => 'Real'); |
||
$a = Compute(random(2,9,1)); |
$a = Compute(random(2,9,1)); |
||
Line 54: | Line 56: | ||
$x1 = (-$b + sqrt($b**2-4*$a*$c))/(2*$a); |
$x1 = (-$b + sqrt($b**2-4*$a*$c))/(2*$a); |
||
$x2 = (-$b - sqrt($b**2-4*$a*$c))/(2*$a); |
$x2 = (-$b - sqrt($b**2-4*$a*$c))/(2*$a); |
||
+ | |||
########################################### |
########################################### |
||
# The scaffold |
# The scaffold |
||
Line 67: | Line 70: | ||
Scaffold::Begin( |
Scaffold::Begin( |
||
can_open => "when_previous_correct", |
can_open => "when_previous_correct", |
||
− | #first_incorrect, |
+ | # "first_incorrect", |
− | # |
+ | # "incorrect", |
− | # |
+ | # "always", or |
− | #never |
+ | # "never" |
− | is_open => "first_incorrect" |
+ | is_open => "first_incorrect", |
− | # |
+ | # "correct_or_first_incorrect", |
− | # |
+ | # "incorrect", |
− | # |
+ | # "always", or |
− | #never |
+ | # "never" |
− | instructor_can_open => " |
+ | instructor_can_open => "always", |
− | + | # "when_previous_correct", |
|
− | + | # "first_incorrect", |
|
− | + | # "incorrect", or |
|
− | + | # "never" |
|
− | + | after_AnswerDate_can_open => "always", |
|
+ | # "when_previous_correct", |
||
+ | # "first_incorrect", |
||
+ | # "incorrect", or |
||
+ | # "never" |
||
+ | hardcopy_is_open => "always", |
||
+ | # "first_incorrect" |
||
+ | # "correct_or_first_incorrect", |
||
+ | # "incorrect", |
||
+ | # "always", or |
||
+ | # "never" |
||
); |
); |
||
</pre> |
</pre> |
||
Line 90: | Line 93: | ||
<td style="background-color:#ffdddd;border:black 1px dashed;"> |
<td style="background-color:#ffdddd;border:black 1px dashed;"> |
||
<pre> |
<pre> |
||
+ | ########################################### |
||
Section::Begin("Part 1: Identify the coefficients"); |
Section::Begin("Part 1: Identify the coefficients"); |
||
BEGIN_PGML |
BEGIN_PGML |
||
Consider the quadratic equation given by [`[$quadratic] = 0`]. |
Consider the quadratic equation given by [`[$quadratic] = 0`]. |
||
− | |||
− | In this exercise, we will consider three different ways to solve this expression. |
||
First, identify the coefficients for the quadratic using the standard form |
First, identify the coefficients for the quadratic using the standard form |
||
Line 152: | Line 154: | ||
Section::End(); |
Section::End(); |
||
+ | ########################################### |
||
</pre> |
</pre> |
||
<td style="background-color:#ffcccc;padding:7px;"> |
<td style="background-color:#ffcccc;padding:7px;"> |
||
Line 158: | Line 161: | ||
The text section of the problem is now broken into the parts that we want the student to work sequentially. Begin sections with <code>Section::Begin("NAME OF SECTION");</code>. This also takes the same arguments as <code>Scaffold::Begin()</code>, but only applies to the section. Similarly, we end the section with <code>Section::End()</code>. |
The text section of the problem is now broken into the parts that we want the student to work sequentially. Begin sections with <code>Section::Begin("NAME OF SECTION");</code>. This also takes the same arguments as <code>Scaffold::Begin()</code>, but only applies to the section. Similarly, we end the section with <code>Section::End()</code>. |
||
</p> |
</p> |
||
+ | |||
+ | <p> |
||
+ | Within a section, use BEGIN_TEXT/END_TEXT or BEGIN_PGML/END_PGML to create the text of the section as usual, and ANS() to assign answer checkers to the blanks that appear within the section. |
||
+ | </p> |
||
+ | <p> |
||
+ | Whatever answer checkers are assigned within a section are the ones that are used to decide when that section can be opened by the student. |
||
+ | </p> |
||
+ | </p> |
||
+ | A section is considered to be "correct" when all the answers contained in it are correct. |
||
+ | </p> |
||
+ | <p> |
||
+ | Warning: Putting the answer checkers outside the sections will change the conditions for when a section can be opened. |
||
+ | </p> |
||
+ | <p> |
||
+ | More documentation is inside [https://github.com/openwebwork/pg/blob/master/macros/scaffold.pl the code on GitHub]. |
||
+ | </p> |
||
+ | |||
<p> |
<p> |
||
Note that MultiAnswer is used in this question to demonstrate that we can use it, unlike in some previous iterations of compound problems. |
Note that MultiAnswer is used in this question to demonstrate that we can use it, unlike in some previous iterations of compound problems. |
||
Line 181: | Line 201: | ||
<p> |
<p> |
||
− | As noted above, there are a number of other |
+ | As noted above, there are a number of other configurations for when sections open and are available to open in the problem. Some are listed here: |
<ul> |
<ul> |
||
− | <li> <code>parts => <i>n</i></code>: The number of parts in the problem. If not provided, defaults to 1, which rather defeats the point of using this in the first place. </li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
− | <li> <code>weights => [<i>n1,...,nm</i>]</code>: The relative weights to give to each part in the problem. For example, weights => [2,1,1] would cause the first part to be worth 50% of the points (twice the amount for each of the other two), while the second and third part would be worth 25% each. If weights are not supplied, the parts are weighted by the number of answer blanks in each part (and you must provide the total number of blanks in all the parts by supplying the totalAnswers option). </li> |
||
+ | can_open => "when_previous_correct", |
||
− | <li> <code>totalAnswers => <i>n</i></code>: The total number of answer blanks in all the parts put together (this is used when computing the per-part scores, if part weights are not provided). </li> |
||
+ | is_open => "first_incorrect" |
||
− | <li> <code>saveAllAnswers => <i>0 or 1</i></code>: Usually, the contents of named answer blanks from previous parts are made available to later parts using variables with the same name as the answer blank. Setting saveAllAnswers to 1 will cause ALL answer blanks to be available (via variables like $AnSwEr1, and so on). If not provided, defaults to 0. </li> |
||
+ | );</pre> - The defaults: only the active section is open, but students can open previous secitons if they want. </li> |
||
− | <li> <code>parserValues => <i>0 or 1</i></code>: Determines whether the answers from previous parts are returned as MathObjects (like those returned from Real(), Vector(), etc) or as strings (the unparsed contents of the student answer). If you intend to use the previous answers as numbers, for example, you would want to set this to 1 so that you would get the final result of any formula the student typed, rather than the formula itself as a character string. If not provided, defaults to 0. </li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
− | <li> <code>nextVisible => <i>type</i></code>: Tells when the "go on to the next part" option is available to the student. The possible types include: <code>ifCorrect</code> (the default; next is available only when all the answers are correct), <code>Always</code> (next is always available (but note that students can't go back once they go on), and <code>Never</code> (the problem controls going on by itself). </li> |
||
+ | can_open => "when_previous_correct", |
||
− | <li> <code>nextStyle => <i>type</i></code>: Determines the style of "next" indicator to display (when it is available). The possible types include: <code>CheckBox</code> (the default), <code>Button</code>, <code>Forced</code> (forces students to go on when they next submit answers), and <code>HTML</code> (provide an arbitrary HTML string). </li> |
||
+ | is_open => "correct_or_first_incorrect" |
||
+ | );</pre> - Sections stay open as the student works through the problem. </li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
+ | can_open => "first_incorrect", |
||
+ | is_open => "first_incorrect" |
||
+ | );</pre>: Students work through the problem seeing only one section at a time, and can't go back to previous secitons.</li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
+ | can_open => "always", |
||
+ | is_open => "first_incorrect" |
||
+ | );</pre> - Students can view and work on any section, but only the first incorrect one is shown initially. </li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
+ | can_open => "always", |
||
+ | is_open => "incorrect" |
||
+ | );</pre> - Students see all the parts initially, but the sections close as the student gets them correct. </li> |
||
+ | <li> <pre>Scaffold::Begin( |
||
+ | can_open => "incorrect", |
||
+ | is_open => "incorrect" |
||
+ | );</pre> - Students see all the parts initially, but the sections close as the student gets them correct, and can't be reopened. </li> |
||
+ | |||
</ul> |
</ul> |
||
(These are all taken directly from the documentation in the macro file.) |
(These are all taken directly from the documentation in the macro file.) |
||
Line 202: | Line 240: | ||
<ul> |
<ul> |
||
− | <li>PG macro: [http://webwork.maa.org/viewvc/system/trunk/pg/macros/compoundProblem.pl?view=markup compoundProblem.pl]</li> |
||
+ | <li>PG macro: </li> |
||
</ul> |
</ul> |
Latest revision as of 09:13, 28 June 2023
This problem has been replaced with a newer version of this problem
Simple Scaffolded, MultiPart Problems Worked Sequentially
This is the PG code to create a scaffolded problem with multiple parts that are displayed sequentially. This way uses a recent macro, scaffold.pl
that creates a neat student interface - similar to that of CompoundProblem5 but with a much cleaner style for authors. The interface has tabs containing sections of the problem that can dynamically open and close.
PG problem file | Explanation |
---|---|
DOCUMENT(); loadMacros( "PGstandard.pl", "PGML.pl", "MathObjects.pl", "parserMultiAnswer.pl", "scaffold.pl", "PGcourse.pl", ); TEXT(beginproblem()); $showPartialCorrectAnswers = 1; |
Initialization:
We need make no changes to the initialization section of the file besides including |
Context("Numeric"); $a = Compute(random(2,9,1)); $c = Compute(random(1,9,1)); $b = Compute(random(2,6,1)); if ($a*$c > 0) {$b += floor(sqrt(4*$a*$c))} $quadratic = Formula("$a x^2 + $b x + $c"); $x1 = (-$b + sqrt($b**2-4*$a*$c))/(2*$a); $x2 = (-$b - sqrt($b**2-4*$a*$c))/(2*$a); ########################################### # The scaffold Scaffold::Begin(); |
Setup:
In the problem set-up section of the file we define some variables that we will use in the problem, as usual. In addition, we begin the scaffold by Scaffold::Begin( can_open => "when_previous_correct", # "first_incorrect", # "incorrect", # "always", or # "never" is_open => "first_incorrect", # "correct_or_first_incorrect", # "incorrect", # "always", or # "never" instructor_can_open => "always", # "when_previous_correct", # "first_incorrect", # "incorrect", or # "never" after_AnswerDate_can_open => "always", # "when_previous_correct", # "first_incorrect", # "incorrect", or # "never" hardcopy_is_open => "always", # "first_incorrect" # "correct_or_first_incorrect", # "incorrect", # "always", or # "never" ); |
########################################### Section::Begin("Part 1: Identify the coefficients"); BEGIN_PGML Consider the quadratic equation given by [`[$quadratic] = 0`]. First, identify the coefficients for the quadratic using the standard form [`ax^2 + bx + c = 0`]: [`a`] = [____]{$a}, [`b`] = [____]{$b}, [`c`] = [____]{$c} END_PGML BEGIN_PGML_SOLUTION Take the coefficient of [`x^2`] for the value of [`a`], the coefficient of [`x`] for [`b`], and the constant for [`c`]. In this case, they are [`a = [$a]`], [`b = [$b]`], and [`c = [$c]`]. END_PGML_SOLUTION Section::End(); ########################################### Section::Begin("Part 2: Solve using the quadratic formula"); $multians1 = MultiAnswer($x1,$x2)->with( singleResult => 0, allowBlankAnswers => 1, checker => sub { my ($correct,$student,$self) = @_; my ($s1, $s2) = @{$student}; my ($c1, $c2) = @{$correct}; return (1,1) if ($c1 == $s1 and $c2 == $s2) or ($c1 == $s2 and $c2 == $s1); return (1,0) if $c1 == $s1 or $c2 == $s1; return (0,1) if $c1 == $s2 or $c2 == $s2; return (0,0); } ); BEGIN_PGML Using the quadratic formula, solve [`[$quadratic] = 0`] >> [`x`] = [______]{$multians1} or [`x`] = [______]{$multians1} << END_PGML BEGIN_PGML_SOLUTION Recall that the quadratic equation is [``x = {-b \pm \sqrt{b^2 - 4ac} \over 2a}``]. You already identified [`a = [$a]`], [`b = [$b]`], and [`c = [$c]`], so the results are: [``x = {-[$b] + \sqrt{[$b]^2 - 4[$a][$c]} \over 2[$a]} = [$x1]``] or [``x = {-[$b] - \sqrt{[$b]^2 - 4[$a][$c]} \over 2[$a]} = [$x2]``]. END_PGML_SOLUTION Section::End(); ########################################### |
Main Text:
The text section of the problem is now broken into the parts that we want the student to work sequentially. Begin sections with Within a section, use BEGIN_TEXT/END_TEXT or BEGIN_PGML/END_PGML to create the text of the section as usual, and ANS() to assign answer checkers to the blanks that appear within the section. Whatever answer checkers are assigned within a section are the ones that are used to decide when that section can be opened by the student. A section is considered to be "correct" when all the answers contained in it are correct. Warning: Putting the answer checkers outside the sections will change the conditions for when a section can be opened. More documentation is inside the code on GitHub. Note that MultiAnswer is used in this question to demonstrate that we can use it, unlike in some previous iterations of compound problems. |
Scaffold::End(); ENDDOCUMENT(); |
Answers and Solutions:
We've included the answers and solutions in each section, so they don't appear here. However, once all of the sections are complete, we close the scaffold with |
As noted above, there are a number of other configurations for when sections open and are available to open in the problem. Some are listed here:
-
Scaffold::Begin( can_open => "when_previous_correct", is_open => "first_incorrect" );
- The defaults: only the active section is open, but students can open previous secitons if they want. -
Scaffold::Begin( can_open => "when_previous_correct", is_open => "correct_or_first_incorrect" );
- Sections stay open as the student works through the problem. -
Scaffold::Begin( can_open => "first_incorrect", is_open => "first_incorrect" );
: Students work through the problem seeing only one section at a time, and can't go back to previous secitons. -
Scaffold::Begin( can_open => "always", is_open => "first_incorrect" );
- Students can view and work on any section, but only the first incorrect one is shown initially. -
Scaffold::Begin( can_open => "always", is_open => "incorrect" );
- Students see all the parts initially, but the sections close as the student gets them correct. -
Scaffold::Begin( can_open => "incorrect", is_open => "incorrect" );
- Students see all the parts initially, but the sections close as the student gets them correct, and can't be reopened.
(These are all taken directly from the documentation in the macro file.)
- PG macro: