<?xml-stylesheet href="document.xsl"?>
<!DOCTYPE document SYSTEM "document.dtd">
<document title="Potential Energy at the VLab">
<version value="1.0"/>
<body>

<section title="Abstract">
This page contains instructions for and an example of the 
Potential Energy applet.  The Potential Energy applet
demonstrates the relationship between potential and kinetic energy.
<STRONG>The Potential Energy applet requires a Java
1.1 virtual machine.</STRONG>  As of 18 Sep 97, Netscape and Internet
Explorer will only run Java 1.0 applets.  
<A HREF="http://www.javasoft.com/products/hotjava/">Sun's HotJava 1.0</A>
will run Java 1.1 applets.
</section>

<section title="Status">
The current status is complete and functional.
<P/>
<list title="To do">
<LI>Inputting non-integers for the values of EAS will break the applet</LI>
<LI>Sort the checkboxes</LI>
<LI>Pressing "Reset" before the animation finishes breaks the applet</LI>
<LI>Resizing the applet breaks the applet.  I am looking into this.  </LI>
<LI>Negative values for Mass causes strange behavior</LI>
<LI>Disable all buttons while anim is running</LI>
</list>
</section>

<section title="Instructions">
The applet takes the following parameters:
<parameters>
<par name="step">
  <value type="number">A floating point number</value>
  <default type="number">0.01</default>
  <description>Modifies the granularity of the applet.  The smaller
this number, the more accurate the applet will be.  This also will
slow the applet down.  For computational purposes, this value is
<keyword>delta-t</keyword></description>
</par>
<par name="audio">
  <value>true</value>
  <value>false</value>
  <default>false</default>
  <description>True if audio is desired</description>
</par>
<par name="energy">
  <value type="text">A comma separated list of real numbers</value>
  <default><strong>No default</strong></default>
  <description>These represent the energy level options</description>
</par>
<par name="masses">
  <value type="text">A comma separated list of real numbers</value>
  <default><strong>No default</strong></default>
  <description>These represent the mass options</description>
</par>
<par name="EASes">
  <value type="text">A comma separated list of integers</value>
  <default><strong>No default</strong></default>
  <description>The energy absorbtion settings; this is how much energy
the ground absorbs on each bounce.</description>
</par>
<par name="gravity">
  <value type="number">A real number</value>
  <default type="number">9.81</default>
  <description>The value for the gravity setting in
meters/second*second</description>
</par>
<par name="Show height">
  <value>true</value>
  <value>false</value>
  <default>true</default>
  <description>If this is false, the height meter will be
hidden</description>
</par>
<par name="Show energy">
  <value>true</value>
  <value>false</value>
  <default>true</default>
  <description>If this is false, the energy values will be
hidden</description>
</par>
<par name="Show Mass">
  <value>true</value>
  <value>false</value>
  <default>true</default>
  <description>If this is false, the mass values will be
hidden</description>
</par>
<par name="Show EAS">
  <value>true</value>
  <value>false</value>
  <default>true</default>
  <description>If this is false, the EAS values will be
hidden</description>
</par>
<par name="Show gravity">
  <value>true</value>
  <value>false</value>
  <default>true</default>
  <description>If this is false, the gravity setting will be
hidden</description>
</par>
</parameters>
</section>

<section title="Units">
<units>
<unit name="Energy" unit="Joules"/>
<unit name="Mass" unit="Kilograms"/>
<unit name="EAS" unit="Percentage"/>
<unit name="Height" unit="Meters"/>
<unit name="Gravity" unit="m/s*s"/>
</units>
</section>

<section title="Example">
<pre>&lt;applet code="PotentialEnergy.class" codebase="classes" 
	width="600" height="400"&gt;
&lt;param name="audio" value="false"/&gt;
&lt;param name="gravity" value="4.5"/&gt;
&lt;param name="show gravity" value="false"/&gt;
&lt;param name="show masses" value="false"/&gt;
&lt;param name="energy stations" value="1,2,3,4"/&gt;
&lt;param name="masses" value="2, 4, 5"/&gt;
&lt;param name="EASes" value="25, 50, 75, 100"/&gt;
&lt;/applet&gt;</pre>
</section>

<section title="Notes">
<list>
<li>The animation stops when the delta-y values become so small that no
noticable movement is observable in the applet, or when the object
moves out of sight.
</li>
<li>If values for a given variable are hidden, the buttons representing
the values are shown without units.  This is to avoid confusion.
</li>
<li>As many values for mass, energy, and EAS may be given in the comma
delimited list of values as desired.  The only real limit is how many
buttons can be fit on the screen at once.
</li>
<li>While the animation is in progress, all buttons
<strong>except</strong> "Reset" are disabled.
</li>
<li>Negative numbers may be used for EAS values.  This has the effect you would
expect it to.
</li>
<li>Negative values for other parameters (EG, mass) can cause
undetermined behavior</li>
<li>For very small delta-t, odd behavior may be observed near the end
of the animation.  This is being looked into.</li>
</list>
</section>
</body>
</document>

