Difference between revisions of "Derivative Graph Matching Flash Applet Sample Problem"

From WeBWorK_wiki
Jump to navigation Jump to search
 
(28 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
<em>This sample problem shows how to use the derivative graph matching applet.</em>
 
<em>This sample problem shows how to use the derivative graph matching applet.</em>
 
</p>
 
</p>
  +
<p style="background-color:#93BED2;border:black solid 1px;padding:3px;">This applet and WeBWorK problem are based upon work supported by the National Science Foundation under Grant Number DUE-0941388.</p>
  +
<p style="background-color:#ffccff;border:black solid 1px;padding:3px;">Click here to see a problem like this in action: [https://testcourses.webwork.maa.org/webwork2/FlashAppletDemos/variousAppletProblems/7/?effectiveUser=practice2&displayMode=MathJax&user=practice2&key=S1JJoPFkF8APKB9rQOQ2uQ6jT5qGMFC7 testcourses.webwork.maa.org/webwork2/FlashAppletDemos]</p>
 
<p>
 
<p>
  +
[[File:DerGraphMatch.jpg]]
  +
<br>
 
A standard WeBWorK PG file with an embedded applet has six sections:
 
A standard WeBWorK PG file with an embedded applet has six sections:
 
</p>
 
</p>
Line 17: Line 21:
 
</ol>
 
</ol>
 
<p>
 
<p>
The sample file attached to this page shows this; below the file is shown to the left, with a second column on its right that explains the different parts of the problem that are indicated above. A screenshot of the applet embedded in this WeBWorK problem is shown below:<br>
+
The sample file attached to this page shows this; below the file is shown to the left, with a second column on its right that explains the different parts of the problem that are indicated above. A screenshot of the applet embedded in this WeBWorK problem is shown above.<br>
[[File:DerGraphMatch.jpg]]
+
<br><br>
<br>
+
The student can draw on the graph tiles by pressing 'p'. One of the graph tiles in the screenshot is shown with the critical points marked along the x-axes. Pressing 'p' again turns off drawing and allows dragging of the graph tile. Pressing 'u' erases the drawing on the most recently selected tile. One of the tiles shows six buttons which when pressed will shade the graph marking the regions where the function is positive, negative, increasing, decreasing or concave up or down. Several of the tiles in the screen shot are shaded. Three of the tiles can be seen to be shaded in the same part of the graph. These tiles match, that is, they are the function and its first two derivatives.
There are other sample problems using applets: [[GraphLimit Flash Applet Sample Problem]], [[GraphLimit Flash Applet Sample Problem 2]]
+
<br><br>
  +
Graph tiles are transparent. This can help the student identify which tiles match. Instructions for the applet are provided within the applet. Different instructions appear depending on what is under the mouse.
  +
<br><br>
  +
There are other sample problems using applets: <br>
  +
[[GraphLimit Flash Applet Sample Problem]]<br>
  +
[[GraphLimit Flash Applet Sample Problem 2]]<br>
  +
[[trigwidget Applet Sample Problem]]<br>
  +
[[uSub Applet Sample Problem]]<br>
 
</p>
 
</p>
<table cellspacing="0" cellpadding="2" border="0">
 
  +
<tr valign="top">
 
  +
<th> PG problem file </th>
 
  +
{|style=" background-color:#ffffff;" cellpadding="10" cellspacing="0" border="1"
<th> Explanation </th>
 
  +
! scope="col" width="30%"| PG problem file
</tr>
 
  +
! scope="col" width="70%"| Explanation
<tr valign="top">
 
  +
|- style=" background-color:#ddddff;"
<td style="background-color:#ddddff;border:black 1px dashed;">
 
  +
| <pre>
<pre>
 
  +
 
##DESCRIPTION
 
##DESCRIPTION
## understanding derivatives graphically
+
## understanding derivatives graphically
 
##ENDDESCRIPTION
 
##ENDDESCRIPTION
   
Line 48: Line 52:
 
## Problem1('')
 
## Problem1('')
   
########################################################################
+
###################################################
# This work is supported in part by the National Science Foundation
+
# This work is supported in part by the
# under the grant DUE-0941388.
+
# National Science Foundation under the
########################################################################
+
# grant DUE-0941388.
</pre>
+
###################################################
</td>
+
</pre>
<td style="background-color:#ccccff; padding:7px;">
+
|
 
<p>
 
<p>
 
This is the <strong>tagging and description</strong> section of the problem. Note that any line that begins with a "#" character is a <em>comment</em> for other authors who read the problem, and is not interpreted by WeBWorK.
 
This is the <strong>tagging and description</strong> section of the problem. Note that any line that begins with a "#" character is a <em>comment</em> for other authors who read the problem, and is not interpreted by WeBWorK.
Line 66: Line 70:
 
[http://hobbes.la.asu.edu/Holt/keywords.html list of keywords]. The list of keywords should be comma separated and quoted (e.g., KEYWORDS('calculus','derivatives')).
 
[http://hobbes.la.asu.edu/Holt/keywords.html list of keywords]. The list of keywords should be comma separated and quoted (e.g., KEYWORDS('calculus','derivatives')).
 
</p>
 
</p>
</td>
 
  +
|- style=" background-color:#ddffdd;"
</tr>
+
| <pre>
<tr valign="top">
+
DOCUMENT();
<td style="background-color:#ddffdd;border:black 1px dashed;">
 
<pre>
 
DOCUMENT(); # This should be the first executable line in the problem.
 
   
 
loadMacros(
 
loadMacros(
Line 77: Line 81:
 
);
 
);
 
</pre>
 
</pre>
</td>
+
| <p>
<td style="background-color:#ccffcc;padding:7px;">
 
<p>
 
 
This is the <strong>initialization section</strong> of the problem. The first executed line of the problem <strong>must</strong> be the <code>DOCUMENT();</code> command. Note that every command <em>must end with a semicolon</em>.
 
This is the <strong>initialization section</strong> of the problem. The first executed line of the problem <strong>must</strong> be the <code>DOCUMENT();</code> command. Note that every command <em>must end with a semicolon</em>.
 
</p>
 
</p>
Line 83: Line 87:
 
The <code>loadMacros</code> command loads information that works behind the scenes. For our purposes we can usually just load the macros shown here and not worry about things further.
 
The <code>loadMacros</code> command loads information that works behind the scenes. For our purposes we can usually just load the macros shown here and not worry about things further.
 
</p>
 
</p>
</td>
 
  +
|- style=" background-color:#ffffdd;"
</tr>
+
| <pre>
<tr valign="top">
 
<td style="background-color:#ffffdd;border:black 1px dashed;">
 
<pre>
 
 
# Set up problem
 
# Set up problem
 
TEXT(beginproblem());
 
TEXT(beginproblem());
Line 97: Line 101:
 
}
 
}
   
$isit2der = 1; #match first and second derivatives
+
#match first and second derivatives
  +
$isit2der = 1;
 
</pre>
 
</pre>
</td>
+
| <p>
<td style="background-color:#ffffcc;padding:7px;">
 
<p>
 
 
This is the <strong>problem set-up section</strong> of the problem.
 
This is the <strong>problem set-up section</strong> of the problem.
 
</p>
 
</p>
Line 105: Line 109:
 
The derGraphMatchWW.swf applet requires the student to match three sets of graphs. If <code>$isit2der</code> is set to zero, the student must match three pairs of graphs of functions and their derivatives. If <code>$isit2der</code> is set to one, the student must match three triples of graphs of functions and their first and second derivatives. The screenshot above shows the applet with <code>$isit2der=1</code>. <code>$showSolutions</code> is turned on when the due date is passed. The solutions are shown within the applet. The problem author can add some explanatory text in the pg file. The applet shows the graphs in the correct positions with shading turned on so that the student can see the function is concave up where its derivative is increasing and the second derivative is positive.
 
The derGraphMatchWW.swf applet requires the student to match three sets of graphs. If <code>$isit2der</code> is set to zero, the student must match three pairs of graphs of functions and their derivatives. If <code>$isit2der</code> is set to one, the student must match three triples of graphs of functions and their first and second derivatives. The screenshot above shows the applet with <code>$isit2der=1</code>. <code>$showSolutions</code> is turned on when the due date is passed. The solutions are shown within the applet. The problem author can add some explanatory text in the pg file. The applet shows the graphs in the correct positions with shading turned on so that the student can see the function is concave up where its derivative is increasing and the second derivative is positive.
 
</p>
 
</p>
<p>
 
  +
|- style=" background-color:#ccffff;"
The applet has solution/hint information embedded in it. When <code>$hintState=0</code>, this information is not shown. When <code>$hintState=1</code>, this information is revealed. The <code>time</code> parameter tracks the current date and time. The conditional compares that to the due date for the problem set (in the <code>$dueDate</code> scalar variable) and sets <code>$hintState</code> to 1 if the due date has passed and leaves <code>$hintState</code> set to 0 if the assignment is not yet due.
 
  +
| <pre>
</p>
 
  +
###################################
<p>
 
  +
# Create link to applet
The four variables <code>$x1</code>, <code>$x2</code>, <code>$x3</code> and <code>$x4</code> are the x-coordinates of four points on the graph that the applet will set to be a removable discontinuity, a jump discontinuity or a cusp. The order of these phenomena is random as are the y-values chosen. The x-coordinates must be between -10 and 10.
 
  +
###################################
</p>
 
  +
$appletName = "derGraphMatchWW";
</td>
 
  +
$applet = FlashApplet(
</tr>
 
  +
codebase
<tr valign="top">
 
  +
=> findAppletCodebase("$appletName.swf"),
<td style="background-color:#ccffff;border:black 1px dashed;">
 
  +
appletName
<pre>
 
  +
=> $appletName,
##########################################################################
 
  +
appletId => $appletName,
# How to use the Graph_Test applet.
 
  +
setStateAlias => 'setXML',
# Purpose: The purpose of this applet is to ask graphical limit questions
 
  +
getStateAlias => 'getXML',
# Use of applet: The applet state consists of the following fields:
 
  +
setConfigAlias => 'setConfig',
# qType - question type: limits, continuity, first_derivative,
 
  +
getConfigAlias => 'getConfig',
# second_derivative
 
  +
maxInitializationAttempts => 5,
# hintState - context sensitive help is either on or off.
 
  +
answerBoxAlias => 'answerBox',
# Generally turned on after dueDate
 
  +
height => '600',
# problemSeed - the seed sets the random parameters that control which
 
  +
width => '550',
# graph is chosen. If the seed is changed, the graph is changed.
 
  +
bgcolor => '#ffffff',
##########################################################################
 
  +
debugMode => 0,
# qType = first_derivative
 
  +
submitActionScript =>
# get_interval_info - given a type of interval returns a list of intervals
 
  +
qq{getQE("answerBox").value
# with that characteristic
 
  +
=getApplet("$appletName").getAnswer() },
# Valid types are - increasing, decreasing, constant, up, down, straight
 
# up, down and straight pertain to the concavity of the function on the
 
# interval
 
# sample function call: get_interval_info("increasing")
 
# describe_interval - given an interval and a type, the function returns
 
# information about the interval.
 
# Valid types are -
 
# updown (for concavity information),
 
# posneg1 (for sign of first derivative),
 
# posneg2 (for sign of second derviative),
 
# incdec (for whether function is increasing or decreasing on the
 
# interval.
 
# sample function call: describe_interval($x1,$x2,"updown")
 
# right_limits - returns a list of points (a,b) such that
 
# lim_{x\to a^-}f(x)=b, but lim_{x\to a^+}f(x)\= b
 
# left_limits - returns a list of points (a,b) such that
 
# lim_{x\to a^+}f(x)=b, but lim_{x\to a^-}f(x)\= b
 
# neither_limits - returns a list of points (a,b) such that
 
# lim_{x\to a^-}f(x)\=lim_{x\to a^+}f(x)\= f(a)=b
 
# get_intervals returns a list of intervals on which f(x) is continuous.
 
# get_f_of_x - given x value, returns f(x).
 
# returns NaN for x notin [-10,10].
 
# getf_list - given x value and string returns
 
# "function" - returns f(x)
 
# "leftlimit" - returns lim_{x->a^-}f(x)
 
# "rightlimit" - returns lim_{x->a^+}f(x)
 
# "limit" - returns lim_{x->a}f(x) or "DNE"
 
#
 
# What does the applet do?
 
# The applet draws a graph with jumps, a cusp and discontinuities
 
# When turned on, there is context sensitive help.
 
##############################################################################
 
###################################
 
# Create link to applet
 
###################################
 
$appletName = "Graph_Limit";
 
$applet = FlashApplet(
 
codebase => findAppletCodebase("$appletName.swf"),
 
appletName => $appletName,
 
appletId => $appletName,
 
setStateAlias => 'setXML',
 
getStateAlias => 'getXML',
 
setConfigAlias => 'setConfig',
 
maxInitializationAttempts => 10, # number of attempts to initialize applet
 
#answerBoxAlias => 'answerBox',
 
height => '475',
 
width => '425',
 
bgcolor => '#ffffff',
 
debugMode => 0,
 
submitActionScript => qq{
 
getQE("inc").value=getApplet("$appletName").get_interval_info("increasing");
 
getQE("dec").value=getApplet("$appletName").get_interval_info("decreasing");
 
getQE("constant").value=getApplet("$appletName").get_interval_info("constant");
 
},
 
 
);
 
);
 
 
###################################
 
###################################
# Configure applet
+
# Configure applet
###################################
+
###################################
 
 
# configuration consists of hintState, question type, and random seed,
 
  +
#initialization data - problem setup
# and x-coordinates of four points where jumps, discontinuities or cusps
 
  +
# $problemSeed - random seed
# occur.
 
  +
# used to setup problem
$applet->configuration(qq{<xml><hintState>$showHint</hintState><qtype>limits</qtype>
 
  +
# $isit2der - set to 1 if student
<seed>$problemSeed</seed><xlist x1='$x1' x2='$x2' x3='$x3' x4='$x4' /></xml>});
 
  +
# must match function
$applet->initialState(qq{<xml><hintState>$showHint</hintState><qtype>limits</qtype>
 
  +
# to first and second derivate
<seed>$problemSeed</seed><xlist x1='$x1' x2='$x2' x3='$x3' x4='$x4' /></xml>});
 
  +
# - set to 0 if student
  +
# must match function
  +
# to first derivative
  +
# $showSolution - set to 1 if
  +
# $dueDate is passed, 0 otherwise
  +
# success - 0 if work not complete yet
  +
  +
$applet->configuration(qq{<xml>
  +
<seed>$problemSeed</seed>
  +
<isit2der>$isit2der</isit2der>
  +
<showSolution>$showSolution</showSolution>
  +
<stat success="0"/></xml>});
  +
$applet->initialState(qq{<xml>
  +
<seed>$problemSeed</seed>
  +
<isit2der>$isit2der</isit2der>
  +
<showSolution>$showSolution</showSolution>
  +
<stat success="0"/></xml>});
   
TEXT( MODES(TeX=>'object code', HTML=>$applet->insertAll(
+
TEXT( MODES(TeX=>'object code',
  +
HTML=>$applet->insertAll(
 
debug=>0,
 
debug=>0,
includeAnswerBox=>0,
+
includeAnswerBox=>1,
# reinitialize_button=>$permissionLevel>=10,
 
 
)));
 
)));
 
 
BEGIN_TEXT
 
<input type="hidden" name="inc" id="inc" />
 
<input type="hidden" name="dec" id="dec" />
 
<input type="hidden" name="constant" id="constant" />
 
END_TEXT
 
 
$answerString1 = $inputs_ref->{inc};
 
my $correctAnswer1 = List($answerString1);
 
 
$answerString2 = $inputs_ref->{dec};
 
my $correctAnswer2 = List($answerString2);
 
 
$answerString3 = $inputs_ref->{constant};
 
my $correctAnswer3 = List($answerString3);
 
 
 
 
</pre>
 
</pre>
</td>
+
| <p>
<td style="background-color:#ccffff;padding:7px;">
 
<p>
 
 
This is the <strong>Applet link section</strong> of the problem.
 
This is the <strong>Applet link section</strong> of the problem.
 
</p><br>
 
</p><br>
Line 227: Line 174:
 
Those portions of the code that begin the line with <code>#</code> are comments and can be omitted or replaced with comments appropriate to your particular problem.
 
Those portions of the code that begin the line with <code>#</code> are comments and can be omitted or replaced with comments appropriate to your particular problem.
 
</p>
 
</p>
<p>You must include the section that follows <code># Create link to applet</code>. If you are embedding a different applet, from the Graph_Limit applet, put your applet name in place of 'Graph_Limit' in the line <code>$appletName = "Graph_Limit";</code>. Enter the height of the applet in the line <code>height => '475',</code> in place of 475 and the width in the line <code>width => '425',</code> in place of 425.
+
<p>You must include the section that follows <code># Create link to applet</code>. If you are embedding a different applet, from the derGraphMatchWW applet, put your applet name in place of 'derGraphMatchWW' in the line <code>$appletName = "derGraphMatchWW";</code>. Enter the height of the applet in the line <code>height => '600',</code> in place of 600 and the width in the line <code>width => '550',</code> in place of 550.
 
</p><br>
 
</p><br>
<p> The lines <code>$applet->configuration(qq{<xml><hintState>$hintState</hintState><qtype>$qtype</qtype><seed>$problemSeed</seed><xlist x1='$x1' x2='$x2' x3='$x3' x4='$x4' /></xml>});</code> and <code>$applet->initialState(qq{<xml><hintState>$hintState</hintState><qtype>$qtype</qtype><seed>$problemSeed</seed><xlist x1='$x1' x2='$x2' x3='$x3' x4='$x4' /></xml>});</code> configure the applet. The configuration of the applet is done in xml. The hintState is set to the variable <code>$hintState</code>, the question type is set to <code>$qtype</code> and the problem seed is the WeBWorK environmental variable <code>$problemSeed</code>. The variables <code>$x1</code>, <code>$x2</code>, <code>$x3</code> and <code>$x4</code> are also passed to the applet.
 
  +
<p> The lines <code>$applet->configuration</code>
</p><br>
 
  +
<code>(qq{<xml><seed>$problemSeed</seed></code>
<p>The code <code>qq{ </code><code>
 
  +
<code><isit2der>$isit2der</isit2der>
getQE("inc").value=getApplet("$appletName").get_interval_info("increasing");</code><code>
 
  +
<showSolution>$showSolution</showSolution></code>
getQE("dec").value=getApplet("$appletName").get_interval_info("decreasing");</code><code>
 
  +
<code><stat success="0"/></xml>});
getQE("constant").value=getApplet("$appletName").get_interval_info("constant");</code><code>
 
  +
</code> and <code>$applet->initialState</code>
}</code>
 
  +
<code>(qq{<xml><seed>$problemSeed</seed></code>
is called when the 'Submit Answers' button in the problem is pressed. There is an external interface function designed inside the applet. The function name is 'get_interval_info'. These lines of code call the function with javascript. <code>get_interval_info</code>, takes one argument: a string value. The string may be any of the following alternatives: "increasing", "decreasing", "constant", "up", "down" or "straight". <code>get_interval_info</code> returns a list of open intervals with the specified characteristic. The line <code>
 
  +
<code><isit2der>$isit2der</isit2der></code>
getQE("inc").value=getApplet("$appletName").get_interval_info("increasing");</code> gets the value of the function <code>get_interval_info</code> and stores this value in the hidden javascript form field named "inc". Note that although we have carriage returns after each of the 'getQE' statements, you should <em>not</em> have these carriage returns in your pg file. They are here so that the text line will allow display of the code next to the explanation. You will get error messages if you have the carriage returns in your pg file.</p>
 
<p>
 
The hidden form fields are created in the code block:
 
 
<code>
 
<code>
BEGIN_TEXT</code><code>
 
  +
<showSolution>$showSolution</showSolution></code>
<input type="hidden" name="inc" id="inc" /></code><code>
 
  +
<code><stat success="0"/></xml>});</code> configure the applet. The configuration of the applet is done in xml. The <code>$showSolution</code> variable is set zero initially and to one after the due date, the problem seed is the WeBWorK environmental variable <code>$problemSeed</code>. Success is set to zero until the student solves the problem. <code>$isit2der</code> records whether the student is to match one or two derivatives. If <code>$isit2der=1</code>, then the student must match the graph of the function with the graphs of its first two derivatives.
<input type="hidden" name="dec" id="dec" /></code><code>
 
<input type="hidden" name="constant" id="constant" /></code><code>
 
END_TEXT
 
</code>
 
</p><br>
 
<p>
 
The applet is configured in the code line:
 
<code>$applet->configuration(qq{<xml><hintState>$hintState</hintState><qtype>limits</qtype>
 
<seed>$problemSeed</seed><xlist x1='$x1' x2='$x2' x3='$x3' x4='$x4' /></xml>});</code> and the similar line below it.
 
The variables $hintState, $problemSeed, and $x1, $x2, $x3, and $x4 are defined within WeBWorK and used by the applet to set the problem up.
 
 
</p><br>
 
</p><br>
  +
<p>The code <code>qq{getQE("answerBox").</code>
  +
<code>value=getApplet("$appletName").getAnswer()}</code>
  +
is called when the 'Submit Answers' button in the problem is pressed. This code queries the applet as to whether the student has succeeded in matching the graphs. A "1" is returned if the graphs are matched. "0" is returned otherwise.</p>
  +
<br>
 
<p>
 
<p>
<code>TEXT( MODES(TeX=>'object code', HTML=>$applet->insertAll(
+
<code>TEXT( MODES(TeX=>'object code',</code>
  +
<code> HTML=>$applet->insertAll(
 
debug=>0,
 
debug=>0,
includeAnswerBox=>0,
+
includeAnswerBox=>0,</code>
  +
<code>
 
reinitialize_button=>$permissionLevel>=10,
 
reinitialize_button=>$permissionLevel>=10,
 
)));</code> actually embeds the applet in the WeBWorK problem.
 
)));</code> actually embeds the applet in the WeBWorK problem.
 
</p><br>
 
</p><br>
<p>When the submit button is pressed, the hidden form fields defined in this block are filled with information from the applet.
+
<p>When the submit button is pressed the work in the applet is checked via the WeBWorK answer checker.
 
</p>
 
</p>
<p>
 
  +
|- style=" background-color:#ccffff;"
The data from the hidden form fields is used in these simple perl subroutines to define the correct answers to the four questions that are part of this WeBWorK problem.</p><br>
 
  +
| <pre>
<p>The WeBWorK variable $answerString1 is the content of the hidden form field "inc". $correctAnswer1 is the solution to the first question. The solutions for the next two questions are defined in a similar way.</p>
 
  +
TEXT(MODES(TeX=>"", HTML=><<'END_TEXT'));
</td>
 
  +
<script>
</tr>
 
  +
if (navigator.appVersion.indexOf("MSIE") > 0) {
<tr valign="top">
 
  +
document.write("<div width='3in'
<td style="background-color:#ffdddd;border:black 1px dashed;">
 
  +
align='center' style='background:yellow'>
<pre>
 
  +
You seem to be using Internet Explorer.
  +
<br/>It is recommended that another
  +
browser be used to view this page.</div>");
  +
}
  +
</script>
  +
END_TEXT
  +
</pre>
  +
| <p>
  +
The text between the <code><script></code> tags detects whether the student is using Internet Explorer. If the student is using this browser, a warning is issued and the student is advised to use another browser. IE mis-sizes the applets. Some will work correctly when displayed at the wrong size, but others will fail. We do not recommend using IE with WeBWorK problems with Flash embedded.</p>
  +
  +
|- style=" background-color:#ffdddd;"
  +
| <pre>
 
BEGIN_TEXT
 
BEGIN_TEXT
   
 
$BR
 
$BR
   
$BR list all intervals for which
 
  +
$BR Put the tiles into place,
$BR
 
  +
then press 'submit answers'.
a)
 
\(f^\prime(x)>0\)
 
\{ans_rule(35) \}
 
$BR
 
b)
 
\(f^\prime(x)<0\)
 
\{ans_rule(35) \}
 
 
$BR
 
c)
 
\(f^\prime(x)=0\)
 
\{ans_rule(35) \}
 
 
$BR
 
   
 
END_TEXT
 
END_TEXT
 
Context()->normalStrings;
 
Context()->normalStrings;
 
</pre>
 
</pre>
<td style="background-color:#ffcccc;padding:7px;">
 
  +
| <p>
<p>
 
 
This is the <strong>text section</strong> of the problem. The <code>TEXT(beginproblem());</code> line displays a header for the problem, and the <code>Context()-&gt;texStrings</code> line sets how formulas are displayed in the text, and we reset this after the text section. Everything between the <code>BEGIN_TEXT</code> and <code>END_TEXT</code> lines (each of which must appear alone on a line) is shown to the student.
 
This is the <strong>text section</strong> of the problem. The <code>TEXT(beginproblem());</code> line displays a header for the problem, and the <code>Context()-&gt;texStrings</code> line sets how formulas are displayed in the text, and we reset this after the text section. Everything between the <code>BEGIN_TEXT</code> and <code>END_TEXT</code> lines (each of which must appear alone on a line) is shown to the student.
 
</p>
 
</p>
 
<p>
 
<p>
Mathematical equations are delimited by <code class="tex2math_ignore">\( \)</code> (for inline equations) or <code class="tex2math_ignore">\[ \]</code> (for displayed equations); in these contexts inserted text is assumed to be TeX code.
 
  +
Since the student answers the question within the applet, no answer blank is provided here.
 
</p>
 
</p>
<p>
 
  +
|- style=" background-color:#eeccff;"
There are a number of variables that set formatting: <code>$PAR</code> is a paragraph break (like <code>\par</code> in TeX).
 
  +
| <pre>
[[FormatVariableList|This page]] gives a list of variables like this. Finally, <code>\{&nbsp;\}</code> sets off <em>code that will be executed in the problem text</em>. Here, <code>ans_rule(35)</code> is a function that inserts an answer blank 35 characters wide.
 
  +
##################################
</p>
 
</td>
 
</tr>
 
<tr valign="top">
 
<td style="background-color:#eeddff;border:black 1px dashed;">
 
<pre>
 
##############################################################
 
 
#
 
#
 
# Answers
 
# Answers
Line 317: Line 244:
 
## answer evaluators
 
## answer evaluators
   
ANS( $correctAnswer1->cmp(strings=>['None']) ); #checks AnSwEr00001
 
  +
NAMED_ANS('answerBox'=>$ans->cmp());
ANS( $correctAnswer2->cmp(strings=>['None']) ); #checks AnSwEr00002
 
ANS( $correctAnswer3->cmp(strings=>['None']) ); #checks AnSwEr00003
 
   
 
  +
ENDDOCUMENT();
ENDDOCUMENT();
 
 
</pre>
 
</pre>
<td style="background-color:#eeccff;padding:7px;">
 
  +
| <p>
<p>
 
  +
This is the <strong>answer</strong> section of the problem. The pg file compares the answer returned from the applet (either a "0" or a "1") to the correct answer (a "1") and grades the question accordingly.
This is the <strong>answer</strong> section of the problem. The problem answer is set by the <code>ANS( $correctAnswer1->cmp(strings=>['None']) );</code>, <code>ANS( $correctAnswer2->cmp(strings=>['None']) );</code>, <code>ANS( $correctAnswer3->cmp(strings=>['None']) );</code> lines. These compare the student's answer with the answers returned from the applet. The answers allow for either a list of intervals answer or the string 'None' for empty lists.
 
 
</p>
 
</p>
 
<p>
 
<p>
Line 334: Line 257:
 
The <code>ENDDOCUMENT();</code> command is the last command in the file.
 
The <code>ENDDOCUMENT();</code> command is the last command in the file.
 
</p>
 
</p>
</td>
 
  +
|}
</tr>
 
  +
</table>
 
  +
== License ==
  +
  +
The Flash applets developed under DUE-0941388 are protected under the following license:
  +
[http://creativecommons.org/licenses/by-nc/3.0/ Creative Commons Attribution-NonCommercial 3.0 Unported License].
   
 
[[Category:Sample Problems]]
 
[[Category:Sample Problems]]
 
[[Category:Applets]]
 
[[Category:Applets]]
  +
[[Category:Flash Applets]]
 
[[Category:Problem_Techniques]]
 
[[Category:Problem_Techniques]]

Latest revision as of 09:29, 31 July 2013

Flash Applets embedded in WeBWorK questions derivative graph matching Example

Sample Problem with derGraphMatchWW.swf embedded

This sample problem shows how to use the derivative graph matching applet.

This applet and WeBWorK problem are based upon work supported by the National Science Foundation under Grant Number DUE-0941388.

Click here to see a problem like this in action: testcourses.webwork.maa.org/webwork2/FlashAppletDemos

DerGraphMatch.jpg
A standard WeBWorK PG file with an embedded applet has six sections:

  1. A tagging and description section, that describes the problem for future users and authors,
  2. An initialization section, that loads required macros for the problem,
  3. A problem set-up section that sets variables specific to the problem,
  4. An Applet link section that inserts the applet and configures it, (this section is not present in WeBWorK problems without an embedded applet)
  5. A text section, that gives the text that is shown to the student, and
  6. An answer and solution section, that specifies how the answer(s) to the problem is(are) marked for correctness, and gives a solution that may be shown to the student after the problem set is complete.

The sample file attached to this page shows this; below the file is shown to the left, with a second column on its right that explains the different parts of the problem that are indicated above. A screenshot of the applet embedded in this WeBWorK problem is shown above.


The student can draw on the graph tiles by pressing 'p'. One of the graph tiles in the screenshot is shown with the critical points marked along the x-axes. Pressing 'p' again turns off drawing and allows dragging of the graph tile. Pressing 'u' erases the drawing on the most recently selected tile. One of the tiles shows six buttons which when pressed will shade the graph marking the regions where the function is positive, negative, increasing, decreasing or concave up or down. Several of the tiles in the screen shot are shaded. Three of the tiles can be seen to be shaded in the same part of the graph. These tiles match, that is, they are the function and its first two derivatives.

Graph tiles are transparent. This can help the student identify which tiles match. Instructions for the applet are provided within the applet. Different instructions appear depending on what is under the mouse.

There are other sample problems using applets:
GraphLimit Flash Applet Sample Problem
GraphLimit Flash Applet Sample Problem 2
trigwidget Applet Sample Problem
uSub Applet Sample Problem


PG problem file Explanation

##DESCRIPTION
##  understanding derivatives graphically
##ENDDESCRIPTION

##KEYWORDS('derivatives', 'graph')

## DBsubject('Calculus')
## DBchapter('Limits and Derivatives')
## DBsection('Derivatives')
## Date('7/25/2011')
## Author('Barbara Margolius')
## Institution('Cleveland State University')
## TitleText1('')
## EditionText1('2011')
## AuthorText1('')
## Section1('')
## Problem1('')

###################################################
# This work is supported in part by the 
# National Science Foundation under the 
# grant DUE-0941388.
###################################################
 

This is the tagging and description section of the problem. Note that any line that begins with a "#" character is a comment for other authors who read the problem, and is not interpreted by WeBWorK.

The description is provided to give a quick summary of the problem so that someone reading it later knows what it does without having to read through all of the problem code.

All of the tagging information exists to allow the problem to be easily indexed. Because this is a sample problem there isn't a textbook per se, and we've used some default tagging values. There is an on-line list of current chapter and section names and a similar list of keywords. The list of keywords should be comma separated and quoted (e.g., KEYWORDS('calculus','derivatives')).

DOCUMENT();       

loadMacros(
"PGanswermacros.pl",
  "PGstandard.pl",
  "AppletObjects.pl",
  "MathObjects.pl",
);

This is the initialization section of the problem. The first executed line of the problem must be the DOCUMENT(); command. Note that every command must end with a semicolon.

The loadMacros command loads information that works behind the scenes. For our purposes we can usually just load the macros shown here and not worry about things further.

# Set up problem
TEXT(beginproblem());
$showPartialCorrectAnswers = 1;
Context("Numeric"); 

$ans =Compute("1");

$showSolution = 0;
if(time>$dueDate){
   $showSolution = 1;
}

#match first and second derivatives
$isit2der = 1; 

This is the problem set-up section of the problem.

The derGraphMatchWW.swf applet requires the student to match three sets of graphs. If $isit2der is set to zero, the student must match three pairs of graphs of functions and their derivatives. If $isit2der is set to one, the student must match three triples of graphs of functions and their first and second derivatives. The screenshot above shows the applet with $isit2der=1. $showSolutions is turned on when the due date is passed. The solutions are shown within the applet. The problem author can add some explanatory text in the pg file. The applet shows the graphs in the correct positions with shading turned on so that the student can see the function is concave up where its derivative is increasing and the second derivative is positive.

###################################
# Create  link to applet 
###################################
$appletName = "derGraphMatchWW";
$applet =  FlashApplet(
   codebase              
     => findAppletCodebase("$appletName.swf"),
   appletName            
     => $appletName,
   appletId        => $appletName,
   setStateAlias   => 'setXML',
   getStateAlias   => 'getXML',
   setConfigAlias  => 'setConfig',
   getConfigAlias  => 'getConfig',
   maxInitializationAttempts => 5,   
   answerBoxAlias  => 'answerBox',
   height          => '600',
   width           => '550',
   bgcolor         => '#ffffff',
   debugMode       =>  0,
   submitActionScript  =>  
  qq{getQE("answerBox").value
     =getApplet("$appletName").getAnswer() },
     );
###################################
# Configure applet
###################################
 
#initialization data - problem setup
#  $problemSeed - random seed 
#      used to setup problem
#  $isit2der - set to 1 if student 
#      must match function 
#      to first and second derivate
#           - set to 0 if student 
#      must match function 
#      to first derivative
#  $showSolution - set to 1 if 
#      $dueDate is passed, 0 otherwise
#  success - 0 if work not complete yet

$applet->configuration(qq{<xml>
<seed>$problemSeed</seed>
<isit2der>$isit2der</isit2der>
<showSolution>$showSolution</showSolution>
<stat success="0"/></xml>});
$applet->initialState(qq{<xml>
<seed>$problemSeed</seed>
<isit2der>$isit2der</isit2der>
<showSolution>$showSolution</showSolution>
<stat success="0"/></xml>});

TEXT( MODES(TeX=>'object code', 
HTML=>$applet->insertAll(
  debug=>0,
  includeAnswerBox=>1,
   )));

This is the Applet link section of the problem.


Those portions of the code that begin the line with # are comments and can be omitted or replaced with comments appropriate to your particular problem.

You must include the section that follows # Create link to applet. If you are embedding a different applet, from the derGraphMatchWW applet, put your applet name in place of 'derGraphMatchWW' in the line $appletName = "derGraphMatchWW";. Enter the height of the applet in the line height => '600', in place of 600 and the width in the line width => '550', in place of 550.


The lines $applet->configuration (qq{<xml><seed>$problemSeed</seed> <isit2der>$isit2der</isit2der> <showSolution>$showSolution</showSolution> <stat success="0"/></xml>}); and $applet->initialState (qq{<xml><seed>$problemSeed</seed> <isit2der>$isit2der</isit2der> <showSolution>$showSolution</showSolution> <stat success="0"/></xml>}); configure the applet. The configuration of the applet is done in xml. The $showSolution variable is set zero initially and to one after the due date, the problem seed is the WeBWorK environmental variable $problemSeed. Success is set to zero until the student solves the problem. $isit2der records whether the student is to match one or two derivatives. If $isit2der=1, then the student must match the graph of the function with the graphs of its first two derivatives.


The code qq{getQE("answerBox"). value=getApplet("$appletName").getAnswer()} is called when the 'Submit Answers' button in the problem is pressed. This code queries the applet as to whether the student has succeeded in matching the graphs. A "1" is returned if the graphs are matched. "0" is returned otherwise.


TEXT( MODES(TeX=>'object code', HTML=>$applet->insertAll( debug=>0, includeAnswerBox=>0, reinitialize_button=>$permissionLevel>=10, ))); actually embeds the applet in the WeBWorK problem.


When the submit button is pressed the work in the applet is checked via the WeBWorK answer checker.

TEXT(MODES(TeX=>"", HTML=><<'END_TEXT'));
<script>
if (navigator.appVersion.indexOf("MSIE") > 0) {
    document.write("<div width='3in' 
    align='center' style='background:yellow'>
    You seem to be using Internet Explorer.
    <br/>It is recommended that another 
    browser be used to view this page.</div>");
}
</script>
END_TEXT

The text between the <script> tags detects whether the student is using Internet Explorer. If the student is using this browser, a warning is issued and the student is advised to use another browser. IE mis-sizes the applets. Some will work correctly when displayed at the wrong size, but others will fail. We do not recommend using IE with WeBWorK problems with Flash embedded.

BEGIN_TEXT

$BR

$BR Put the tiles into place, 
then press 'submit answers'.

END_TEXT
Context()->normalStrings;

This is the text section of the problem. The TEXT(beginproblem()); line displays a header for the problem, and the Context()->texStrings line sets how formulas are displayed in the text, and we reset this after the text section. Everything between the BEGIN_TEXT and END_TEXT lines (each of which must appear alone on a line) is shown to the student.

Since the student answers the question within the applet, no answer blank is provided here.

##################################
#
#  Answers
#
## answer evaluators

NAMED_ANS('answerBox'=>$ans->cmp());

ENDDOCUMENT();     

This is the answer section of the problem. The pg file compares the answer returned from the applet (either a "0" or a "1") to the correct answer (a "1") and grades the question accordingly.

The solution is embedded in the applet and becomes available when the due date has passed.

The ENDDOCUMENT(); command is the last command in the file.

License

The Flash applets developed under DUE-0941388 are protected under the following license: Creative Commons Attribution-NonCommercial 3.0 Unported License.