specifies the names of the HTML elementId's to look for in the HTML document; these elements are where the user interface of the simulation is created.
Add the control to the set of simulation controls.
the control that was passed in
Adds the given Observer to this Subject's list of Observers, so that the Observer
will be notified of changes in this Subject. An Observer may call Subject.addObserver
during its observe method.
the Observer to add
Adds the Parameter to the list of this Subject's available Parameters.
the Parameter to add
if a Parameter with the same name already exists.
Notifies all Observers that this Subject has changed by calling observe on each Observer.
An Observer may call addObserver or removeObserver during its observe
method.
a SubjectEvent with information relating to the change
Notifies all Observers that the Parameter with the given name has changed by calling observe on each Observer.
the language-independent or English name of the Parameter that has changed
if there is no Parameter with the given name
Rebuilds the simulation based on current options selected. Starts with ContactSim.cleanSlate then recreates all the various RigidBody's and Force's etc.
Protected getReturns whether broadcasting is enabled for this Subject. See setBroadcast.
whether broadcasting is enabled for this Subject
Returns the ParameterBoolean with the given name.
the language-independent or English name of the ParameterBoolean
the ParameterBoolean with the given name
if there is no ParameterBoolean with the given name
Returns the ParameterNumber with the given name.
the language-independent or English name of the ParameterNumber
the ParameterNumber with the given name
if there is no ParameterNumber with the given name
Returns the ParameterString with the given name.
the language-independent or English name of the ParameterString
the ParameterString with the given name
if there is no ParameterString with the given name
Optional body: RigidBodythe rigid body to show in graphs
Creates the EasyScriptParser for this app. See explanation of dependent Subjects in EasyScriptParser documentation.
Optional opt_dependent: Subject[]additional dependent Subjects
Removes the Observer from this Subject's list of Observers. An Observer may
call removeObserver during its observe method.
the Observer to detach from list of Observers
Removes the Parameter from the list of this Subject's available Parameters.
the Parameter to remove
Protected setSets whether this Subject will broadcast events, typically used to temporarily disable broadcasting. Intended to be used in situations where a subclass overrides a method that broadcasts an event. This allows the subclass to prevent the superclass broadcasting that event, so that the subclass can broadcast the event when the method is completed.
whether this Subject should broadcast events
the previous value
Returns a minimal string representation of this object, usually giving just identity information like the class name and name of the object.
For an object whose main purpose is to represent another Printable object, it is
recommended to include the result of calling toStringShort on that other object.
For example, calling toStringShort() on a DisplayShape might return something like
this:
DisplayShape{polygon:Polygon{'chain3'}}
a minimal string representation of this object.
Watch a Parameter and when it changes note that there was a discontinuous change in potential and total energy.
the Parameter to watch
Static loadGenerated using TypeDoc
Creates a pile of randomly shaped blocks that fall onto a V shaped wall. The user can add 6 blocks at a time to the pile by clicking a button. This is a stress test to find how many blocks it takes before the simulation engine bogs down and cannot keep up with real time.
Wiggling Blocks
Note that the blocks in the pile will wiggle unrealistically in the end resting state when there is not enough accuracy in the simulation. It is most noticeable when highly zoomed in on the blocks, so that the gaps between them are obvious. The three main factors are: gravity, time step, and diff eq solver. Stronger gravity means that objects move more between time steps and so will wiggle more. Longer time step gives objects more time to wiggle between adjustments from the collision handler. Using the Runge Kutta solver is like halving the time step, compared to using the Modified Euler solver (because RK is average of 4 sub-steps, two of which are mid-step).
Specifically here are some settings and their effects:
Update Nov 2011: The fix to ContactSim.calculate_b_vector which "adjusts acceleration to eliminate velocity at contacts" has eliminated the wiggling in the above cases. One case that is still problematic is when using inverse square gravity: with gravity=10 you need to reduce the timeStep to 0.01 to stop endless collisions.
TO DO remove the 'endless loop' checkbox, and instead just have the 'loop time' numeric control. To make the UI simpler by having one less UI item.
This app has a config() method which looks at a set of options and rebuilds the simulation accordingly. UI controls are created to change the options.