Editing USub Applet Sample Problem

== Flash Applets embedded in WeBWorK questions u-subsitution Example ==

<h2>Sample Problem with uSub.swf embedded</h2>
<p style="background-color:#eeeeee;border:black solid 1px;padding:3px;">
<em>This sample problem shows how to use the u-substitution applet.</em>
</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>
[[File:USub.jpg]]
<br>
A standard WeBWorK PG file with an embedded applet has six sections:
</p>
<ol>
<li> A <em>tagging and description section</em>, that describes the problem for future users and authors,</li>
<li> An <em>initialization section</em>, that loads required macros for the problem,</li>
<li> A <em>problem set-up section</em> that sets variables specific to the problem,</li>
<li> An <em>Applet link section</em> that inserts the applet and configures it, (this section is not present in WeBWorK problems without an embedded applet)</li>
<li> A <em>text section</em>, that gives the text that is shown to the student, and</li>
<li> An <em>answer and solution section</em>, 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. </li>
</ol>
<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 above.<br>

Other applet sample problems: <br>
[[GraphLimit Flash Applet Sample Problem]]<br>[[GraphLimit Flash Applet Sample Problem 2]]<br>[[Derivative Graph Matching Flash Applet Sample Problem]]<br>
[[Hint Applet (Trigonometric Substitution) Sample Problem]] 
</p>

{| style=" background-color:#ffffff;" cellpadding="5" cellspacing="0" border="1"
! scope="col"  width="50%"| PG problem file
! scope="col"  width="50%"| Explanation
|- style=" background-color:#ddddff;"
| <pre>
##DESCRIPTION
##  Integration with substitution 
##ENDDESCRIPTION

##KEYWORDS('integral', 'substitution')

## DBsubject('Calculus')
## DBchapter('Integration')
## DBsection('Integration with substitution')
## Date('6/9/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.
########################################
</pre>
| <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.  
</p>
<p>
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.
</p>
<p>
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
[http://hobbes.la.asu.edu/Holt/chaps-and-secs.html list of current chapter and section names] and a similar 
[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>
|- style="background-color:#ddffdd;"
| <pre>
DOCUMENT();        

loadMacros(
  "PGbasicmacros.pl",
  "extraAnswerEvaluators.pl",
  "AppletObjects.pl",
);
</pre>
| <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>.
</p>
<p>
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>
|- style="background-color:#ffffdd;"
| <pre>
# Set up problem
TEXT(beginproblem());
$showPartialCorrectAnswers = 1;
Context("Numeric"); 
Context()->variables->add(u=>"Real");

$b = random(1,2,1);
$ubig = Compute("$b+$b^2")+random(1,2,1);
$vbig = Compute("2+2*($b+$b^2)");
$vsmall = -$vbig;

$anslist = List(
  Compute("cos(u)"),
  Compute("0"),
  Compute("$b+$b^2"),
  Compute("sin($b+$b^2)"));

</pre>
| <p>
This is the <strong>problem set-up section</strong> of the problem.   
</p>
<p>
The uSub.swf applet has the student enter a four part solution:  the integrand after the u-substitution, the lower limit of integration in terms of u, the upper limit of integration in terms of u, and the value of the integral.  The correct answer must be entered in list format in the pg file.  That is what the code <code>$anslist = List(Compute("cos(u)"),</code> <code>Compute("0"),</code><code>Compute("$b+$b^2"),</code> <code>Compute("sin($b+$b^2)"));</code> does.  The line <code>Context()->variables->add(u=>"Real");</code> adds the variable u to the context.  <code>$vbig</code> and <code>$vsmall</code> are the vertical axes graph window settings.  These can be different for the two graphs, but this is generally not a good idea as the purpose of the applet is to show the student that after a u-substitution, the are of the integrand will be the same even though the shape of the graph may change.  Functions must be carefully chosen to convey this message and so that the two graph windows can be the same size.  <code>$ubig</code> is the maximum value of the horizontal graph window for both graphs.  The minimum value for this problem is coded in the pg file to '-3'.  This is not necessary, it can be set to any value smaller than the maximum horizontal window value.
</p>
|- style="background-color:#ccffff;"
| <pre>
###################################
# Create  link to applet 
###################################
$appletName = "uSub";
$applet =  FlashApplet(
   codebase              
    => findAppletCodebase("$appletName.swf"),
   appletName        => $appletName,
   appletId          => $appletName,
   setStateAlias     => 'setXML',
   getStateAlias     => 'getXML',
   setConfigAlias    => 'setConfig',
   maxInitializationAttempts => 5,  
   answerBoxAlias    => 'answerBox',
   height            => '550',
   width             => '700',
   bgcolor           => '#e8e8e8',
   debugMode         =>  0,
   submitActionScript  =>  
  qq{getQE("answerBox").value
    =getApplet("$appletName").getAnswer() },
     );
###################################
# Configure applet
###################################
 
#initially the answers will be blank
$applet->configuration(qq{<xml>
   <plot func='(1+2*x)*cos(x+x^2)' 
     lower='0' upper='$b'/>
   <grids xgrid='1' ygrid='$b'/>
   <win xmin='-3' xmax='$ubig' 
     ymin='$vsmall' ymax='$vbig' 	
     umin='-3' umax='$ubig' 
     vmin='$vsmall' vmax='$vbig' />
   <ans func='' lower='' upper ='' 
     theValue='' />
   <usub ufunc='x+x^2'/></xml>});
#initially the answers will be blank
$applet->initialState(qq{<xml>
   <plot func='(1+2*x)*cos(x+x^2)' 
     lower='0' upper='$b'/>
   <grids xgrid='1' ygrid='$b'/>
   <win xmin='-3' xmax='$ubig' 
     ymin='$vsmall' ymax='$vbig' 	
     umin='-3' umax='$ubig' 
     vmin='$vsmall' vmax='$vbig' />
   <ans func='' lower='' upper ='' 
     theValue='' />
   <usub ufunc='x+x^2'/></xml>});

TEXT( MODES(TeX=>'object code', 
  HTML=>$applet->insertAll(
  debug=>0,
  includeAnswerBox=>1,
   )));
</pre>
| <p>
This is the <strong>Applet link section</strong> of the problem.   
</p><br>
<p>
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>You must include the section that follows <code># Create  link to applet</code>.  If you are embedding a different applet, from the uSub applet, put your applet name in place of 'uSub' in the line <code>$appletName = "uSub";</code>.  Enter the height of the applet in the line <code>height => '550',</code> in place of 550 and the width in the line  <code>width => '700',</code> in place of 700.
</p><br>
<p>  The lines <code>$applet-></code> <code>configuration(qq{<xml><plot func='(1+2*x)*cos(x+x^2)' </code> <code>lower='0' upper='$b'/></code> <code><br>
        <grids xgrid='1' ygrid='$b'/></code> <code><br>
	<win xmin='-3' xmax='$ubig' ymin='$vsmall' ymax='$vbig' 	
	umin='-3' umax='$ubig' vmin='$vsmall' vmax='$vbig' /></code> <code><br>
        <ans func='' lower='' upper ='' theValue='' /></code> <code><br>
	<usub ufunc='x+x^2'/></xml>});</code> 
<br>
and 
<br>
<code>$applet-></code> <code>initialState(qq{<xml><plot func='(1+2*x)*cos(x+x^2)' </code> <code>lower='0' upper='$b'/></code> <code><br>
        <grids xgrid='1' ygrid='$b'/></code> <code><br>
	<win xmin='-3' xmax='$ubig' ymin='$vsmall' ymax='$vbig' 	
	umin='-3' umax='$ubig' vmin='$vsmall' vmax='$vbig' /></code> <code><br>
        <ans func='' lower='' upper ='' theValue='' /></code> <code><br>
	<usub ufunc='x+x^2'/></xml>});</code>
<br> configure the applet.  The configuration of the applet is done in xml.  The applet expects to be told the integrand of the original integral (func='(1+2*x)*cos(x+x^2)'), the lower limit of integration (lower='0'), the upper limit (upper='$b'), the horizontal and vertical grid spacing (xgrid='1' ygrid='$b'), the dimensions of the two graph windows (,code><win xmin='-3' xmax='$ubig' ymin='$vsmall' ymax='$vbig' 	
	umin='-3' umax='$ubig' vmin='$vsmall' vmax='$vbig' /></code>) and the u-substitution the student is to use (<code><usub ufunc='x+x^2'/></code>).
</p><br>
<p>The code <code>qq{getQE("answerBox").value=getApplet("$appletName").getAnswer() }</code>
is called when the 'Submit Answers' button in the problem is pressed.  This will call the getAnswer function which will return the contents of the four answer blanks in the applet.</p>
<br>
<p>
<code>TEXT( MODES(TeX=>'object code', HTML=>$applet->insertAll(
  debug=>0,
  includeAnswerBox=>0,
 reinitialize_button=>$permissionLevel>=10,
   )));</code> actually embeds the applet in the WeBWorK problem.
</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>
|- style=" background-color:#ccffff;"
| <pre>
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
</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

$BR
$BR Complete the indicated blanks 
in the applet.  When done click 
'submit answers'.  

$PAR If you click 'submit answers' 
before you are done, WeBWorK will 
save your work for when you log back on. 

END_TEXT
Context()->normalStrings;
</pre>
| <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.
</p>
<p>
Answers are submitted within the applet, so no answer blanks are provided here.  The parser in the applet is not as sophisticated as the WeBWorK parser so '*' must explicitly be entered for times in order for the function to graph within the applet.  The answers are graded by WeBWorK so a correctly formulated WeBWorK answer will be marked as correct, but may not be graphable.
</p>
|- style="background-color:#eeddff;"
| <pre>
###################################
#
#  Answers
#
## answer evaluators

NAMED_ANS( 'answerBox'=>$anslist->
   cmp(ordered=>1) );

ENDDOCUMENT(); 
</pre>
| <p>
This is the <strong>answer</strong> section of the problem.  The problem answer is recorded in the applet.  The code <code>NAMED_ANS( 'answerBox'=>$anslist->cmp(ordered=>1) );</code> compares the answer entered into the applet (the contents of 'answerBox') with the WeBWorK variable <code>$anslist</code>.  The answer is graded as an ordered list.
</p>
<p>
The <code>ENDDOCUMENT();</code> command is the last command in the file.
</p>
|}

== 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:Applets]]
[[Category:Flash Applets]]
[[Category:Problem_Techniques]]