|
|
|
// Copyright 2008 the V8 project authors. All rights reserved.
|
|
|
|
// Copyright 1996 John Maloney and Mario Wolczko.
|
|
|
|
|
|
|
|
// This program is free software; you can redistribute it and/or modify
|
|
|
|
// it under the terms of the GNU General Public License as published by
|
|
|
|
// the Free Software Foundation; either version 2 of the License, or
|
|
|
|
// (at your option) any later version.
|
|
|
|
//
|
|
|
|
// This program is distributed in the hope that it will be useful,
|
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
// GNU General Public License for more details.
|
|
|
|
//
|
|
|
|
// You should have received a copy of the GNU General Public License
|
|
|
|
// along with this program; if not, write to the Free Software
|
|
|
|
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
|
|
|
|
|
|
|
// This implementation of the DeltaBlue benchmark is derived
|
|
|
|
// from the Smalltalk implementation by John Maloney and Mario
|
|
|
|
// Wolczko. Some parts have been translated directly, whereas
|
|
|
|
// others have been modified more aggresively to make it feel
|
|
|
|
// more like a JavaScript program.
|
|
|
|
|
|
|
|
|
|
|
|
var DeltaBlue = new BenchmarkSuite('DeltaBlue', 66118, [
|
|
|
|
new Benchmark('DeltaBlue', deltaBlue)
|
|
|
|
]);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A JavaScript implementation of the DeltaBlue constraint-solving
|
|
|
|
* algorithm, as described in:
|
|
|
|
*
|
|
|
|
* "The DeltaBlue Algorithm: An Incremental Constraint Hierarchy Solver"
|
|
|
|
* Bjorn N. Freeman-Benson and John Maloney
|
|
|
|
* January 1990 Communications of the ACM,
|
|
|
|
* also available as University of Washington TR 89-08-06.
|
|
|
|
*
|
|
|
|
* Beware: this benchmark is written in a grotesque style where
|
|
|
|
* the constraint model is built by side-effects from constructors.
|
|
|
|
* I've kept it this way to avoid deviating too much from the original
|
|
|
|
* implementation.
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
/* --- O b j e c t M o d e l --- */
|
|
|
|
|
|
|
|
Object.prototype.inheritsFrom = function (shuper) {
|
|
|
|
function Inheriter() { }
|
|
|
|
Inheriter.prototype = shuper.prototype;
|
|
|
|
this.prototype = new Inheriter();
|
|
|
|
this.superConstructor = shuper;
|
|
|
|
}
|
|
|
|
|
|
|
|
function OrderedCollection() {
|
|
|
|
this.elms = new Array();
|
|
|
|
}
|
|
|
|
|
|
|
|
OrderedCollection.prototype.add = function (elm) {
|
|
|
|
this.elms.push(elm);
|
|
|
|
}
|
|
|
|
|
|
|
|
OrderedCollection.prototype.at = function (index) {
|
|
|
|
return this.elms[index];
|
|
|
|
}
|
|
|
|
|
|
|
|
OrderedCollection.prototype.size = function () {
|
|
|
|
return this.elms.length;
|
|
|
|
}
|
|
|
|
|
|
|
|
OrderedCollection.prototype.removeFirst = function () {
|
|
|
|
return this.elms.pop();
|
|
|
|
}
|
|
|
|
|
|
|
|
OrderedCollection.prototype.remove = function (elm) {
|
|
|
|
var index = 0, skipped = 0;
|
|
|
|
for (var i = 0; i < this.elms.length; i++) {
|
|
|
|
var value = this.elms[i];
|
|
|
|
if (value != elm) {
|
|
|
|
this.elms[index] = value;
|
|
|
|
index++;
|
|
|
|
} else {
|
|
|
|
skipped++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
for (var i = 0; i < skipped; i++)
|
|
|
|
this.elms.pop();
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* S t r e n g t h
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Strengths are used to measure the relative importance of constraints.
|
|
|
|
* New strengths may be inserted in the strength hierarchy without
|
|
|
|
* disrupting current constraints. Strengths cannot be created outside
|
|
|
|
* this class, so pointer comparison can be used for value comparison.
|
|
|
|
*/
|
|
|
|
function Strength(strengthValue, name) {
|
|
|
|
this.strengthValue = strengthValue;
|
|
|
|
this.name = name;
|
|
|
|
}
|
|
|
|
|
|
|
|
Strength.stronger = function (s1, s2) {
|
|
|
|
return s1.strengthValue < s2.strengthValue;
|
|
|
|
}
|
|
|
|
|
|
|
|
Strength.weaker = function (s1, s2) {
|
|
|
|
return s1.strengthValue > s2.strengthValue;
|
|
|
|
}
|
|
|
|
|
|
|
|
Strength.weakestOf = function (s1, s2) {
|
|
|
|
return this.weaker(s1, s2) ? s1 : s2;
|
|
|
|
}
|
|
|
|
|
|
|
|
Strength.strongest = function (s1, s2) {
|
|
|
|
return this.stronger(s1, s2) ? s1 : s2;
|
|
|
|
}
|
|
|
|
|
|
|
|
Strength.prototype.nextWeaker = function () {
|
|
|
|
switch (this.strengthValue) {
|
|
|
|
case 0: return Strength.STRONG_PREFERRED;
|
|
|
|
case 1: return Strength.PREFERRED;
|
|
|
|
case 2: return Strength.STRONG_DEFAULT;
|
|
|
|
case 3: return Strength.NORMAL;
|
|
|
|
case 4: return Strength.WEAK_DEFAULT;
|
|
|
|
case 5: return Strength.WEAKEST;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Strength constants.
|
|
|
|
Strength.REQUIRED = new Strength(0, "required");
|
|
|
|
Strength.STRONG_PREFERRED = new Strength(1, "strongPreferred");
|
|
|
|
Strength.PREFERRED = new Strength(2, "preferred");
|
|
|
|
Strength.STRONG_DEFAULT = new Strength(3, "strongDefault");
|
|
|
|
Strength.NORMAL = new Strength(4, "normal");
|
|
|
|
Strength.WEAK_DEFAULT = new Strength(5, "weakDefault");
|
|
|
|
Strength.WEAKEST = new Strength(6, "weakest");
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* An abstract class representing a system-maintainable relationship
|
|
|
|
* (or "constraint") between a set of variables. A constraint supplies
|
|
|
|
* a strength instance variable; concrete subclasses provide a means
|
|
|
|
* of storing the constrained variables and other information required
|
|
|
|
* to represent a constraint.
|
|
|
|
*/
|
|
|
|
function Constraint(strength) {
|
|
|
|
this.strength = strength;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Activate this constraint and attempt to satisfy it.
|
|
|
|
*/
|
|
|
|
Constraint.prototype.addConstraint = function () {
|
|
|
|
this.addToGraph();
|
|
|
|
planner.incrementalAdd(this);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Attempt to find a way to enforce this constraint. If successful,
|
|
|
|
* record the solution, perhaps modifying the current dataflow
|
|
|
|
* graph. Answer the constraint that this constraint overrides, if
|
|
|
|
* there is one, or nil, if there isn't.
|
|
|
|
* Assume: I am not already satisfied.
|
|
|
|
*/
|
|
|
|
Constraint.prototype.satisfy = function (mark) {
|
|
|
|
this.chooseMethod(mark);
|
|
|
|
if (!this.isSatisfied()) {
|
|
|
|
if (this.strength == Strength.REQUIRED)
|
|
|
|
alert("Could not satisfy a required constraint!");
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
this.markInputs(mark);
|
|
|
|
var out = this.output();
|
|
|
|
var overridden = out.determinedBy;
|
|
|
|
if (overridden != null) overridden.markUnsatisfied();
|
|
|
|
out.determinedBy = this;
|
|
|
|
if (!planner.addPropagate(this, mark))
|
|
|
|
alert("Cycle encountered");
|
|
|
|
out.mark = mark;
|
|
|
|
return overridden;
|
|
|
|
}
|
|
|
|
|
|
|
|
Constraint.prototype.destroyConstraint = function () {
|
|
|
|
if (this.isSatisfied()) planner.incrementalRemove(this);
|
|
|
|
else this.removeFromGraph();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Normal constraints are not input constraints. An input constraint
|
|
|
|
* is one that depends on external state, such as the mouse, the
|
|
|
|
* keybord, a clock, or some arbitraty piece of imperative code.
|
|
|
|
*/
|
|
|
|
Constraint.prototype.isInput = function () {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* U n a r y C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Abstract superclass for constraints having a single possible output
|
|
|
|
* variable.
|
|
|
|
*/
|
|
|
|
function UnaryConstraint(v, strength) {
|
|
|
|
UnaryConstraint.superConstructor.call(this, strength);
|
|
|
|
this.myOutput = v;
|
|
|
|
this.satisfied = false;
|
|
|
|
this.addConstraint();
|
|
|
|
}
|
|
|
|
|
|
|
|
UnaryConstraint.inheritsFrom(Constraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds this constraint to the constraint graph
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.addToGraph = function () {
|
|
|
|
this.myOutput.addConstraint(this);
|
|
|
|
this.satisfied = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Decides if this constraint can be satisfied and records that
|
|
|
|
* decision.
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.chooseMethod = function (mark) {
|
|
|
|
this.satisfied = (this.myOutput.mark != mark)
|
|
|
|
&& Strength.stronger(this.strength, this.myOutput.walkStrength);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns true if this constraint is satisfied in the current solution.
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.isSatisfied = function () {
|
|
|
|
return this.satisfied;
|
|
|
|
}
|
|
|
|
|
|
|
|
UnaryConstraint.prototype.markInputs = function (mark) {
|
|
|
|
// has no inputs
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the current output variable.
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.output = function () {
|
|
|
|
return this.myOutput;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Calculate the walkabout strength, the stay flag, and, if it is
|
|
|
|
* 'stay', the value for the current output of this constraint. Assume
|
|
|
|
* this constraint is satisfied.
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.recalculate = function () {
|
|
|
|
this.myOutput.walkStrength = this.strength;
|
|
|
|
this.myOutput.stay = !this.isInput();
|
|
|
|
if (this.myOutput.stay) this.execute(); // Stay optimization
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Records that this constraint is unsatisfied
|
|
|
|
*/
|
|
|
|
UnaryConstraint.prototype.markUnsatisfied = function () {
|
|
|
|
this.satisfied = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
UnaryConstraint.prototype.inputsKnown = function () {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
UnaryConstraint.prototype.removeFromGraph = function () {
|
|
|
|
if (this.myOutput != null) this.myOutput.removeConstraint(this);
|
|
|
|
this.satisfied = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* S t a y C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Variables that should, with some level of preference, stay the same.
|
|
|
|
* Planners may exploit the fact that instances, if satisfied, will not
|
|
|
|
* change their output during plan execution. This is called "stay
|
|
|
|
* optimization".
|
|
|
|
*/
|
|
|
|
function StayConstraint(v, str) {
|
|
|
|
StayConstraint.superConstructor.call(this, v, str);
|
|
|
|
}
|
|
|
|
|
|
|
|
StayConstraint.inheritsFrom(UnaryConstraint);
|
|
|
|
|
|
|
|
StayConstraint.prototype.execute = function () {
|
|
|
|
// Stay constraints do nothing
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* E d i t C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A unary input constraint used to mark a variable that the client
|
|
|
|
* wishes to change.
|
|
|
|
*/
|
|
|
|
function EditConstraint(v, str) {
|
|
|
|
EditConstraint.superConstructor.call(this, v, str);
|
|
|
|
}
|
|
|
|
|
|
|
|
EditConstraint.inheritsFrom(UnaryConstraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Edits indicate that a variable is to be changed by imperative code.
|
|
|
|
*/
|
|
|
|
EditConstraint.prototype.isInput = function () {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
EditConstraint.prototype.execute = function () {
|
|
|
|
// Edit constraints do nothing
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* B i n a r y C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
var Direction = new Object();
|
|
|
|
Direction.NONE = 0;
|
|
|
|
Direction.FORWARD = 1;
|
|
|
|
Direction.BACKWARD = -1;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Abstract superclass for constraints having two possible output
|
|
|
|
* variables.
|
|
|
|
*/
|
|
|
|
function BinaryConstraint(var1, var2, strength) {
|
|
|
|
BinaryConstraint.superConstructor.call(this, strength);
|
|
|
|
this.v1 = var1;
|
|
|
|
this.v2 = var2;
|
|
|
|
this.direction = Direction.NONE;
|
|
|
|
this.addConstraint();
|
|
|
|
}
|
|
|
|
|
|
|
|
BinaryConstraint.inheritsFrom(Constraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Decides if this constraint can be satisfied and which way it
|
|
|
|
* should flow based on the relative strength of the variables related,
|
|
|
|
* and record that decision.
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.chooseMethod = function (mark) {
|
|
|
|
if (this.v1.mark == mark) {
|
|
|
|
this.direction = (this.v2.mark != mark && Strength.stronger(this.strength, this.v2.walkStrength))
|
|
|
|
? Direction.FORWARD
|
|
|
|
: Direction.NONE;
|
|
|
|
}
|
|
|
|
if (this.v2.mark == mark) {
|
|
|
|
this.direction = (this.v1.mark != mark && Strength.stronger(this.strength, this.v1.walkStrength))
|
|
|
|
? Direction.BACKWARD
|
|
|
|
: Direction.NONE;
|
|
|
|
}
|
|
|
|
if (Strength.weaker(this.v1.walkStrength, this.v2.walkStrength)) {
|
|
|
|
this.direction = Strength.stronger(this.strength, this.v1.walkStrength)
|
|
|
|
? Direction.BACKWARD
|
|
|
|
: Direction.NONE;
|
|
|
|
} else {
|
|
|
|
this.direction = Strength.stronger(this.strength, this.v2.walkStrength)
|
|
|
|
? Direction.FORWARD
|
|
|
|
: Direction.BACKWARD
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add this constraint to the constraint graph
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.addToGraph = function () {
|
|
|
|
this.v1.addConstraint(this);
|
|
|
|
this.v2.addConstraint(this);
|
|
|
|
this.direction = Direction.NONE;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Answer true if this constraint is satisfied in the current solution.
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.isSatisfied = function () {
|
|
|
|
return this.direction != Direction.NONE;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Mark the input variable with the given mark.
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.markInputs = function (mark) {
|
|
|
|
this.input().mark = mark;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the current input variable
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.input = function () {
|
|
|
|
return (this.direction == Direction.FORWARD) ? this.v1 : this.v2;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the current output variable
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.output = function () {
|
|
|
|
return (this.direction == Direction.FORWARD) ? this.v2 : this.v1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Calculate the walkabout strength, the stay flag, and, if it is
|
|
|
|
* 'stay', the value for the current output of this
|
|
|
|
* constraint. Assume this constraint is satisfied.
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.recalculate = function () {
|
|
|
|
var ihn = this.input(), out = this.output();
|
|
|
|
out.walkStrength = Strength.weakestOf(this.strength, ihn.walkStrength);
|
|
|
|
out.stay = ihn.stay;
|
|
|
|
if (out.stay) this.execute();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Record the fact that this constraint is unsatisfied.
|
|
|
|
*/
|
|
|
|
BinaryConstraint.prototype.markUnsatisfied = function () {
|
|
|
|
this.direction = Direction.NONE;
|
|
|
|
}
|
|
|
|
|
|
|
|
BinaryConstraint.prototype.inputsKnown = function (mark) {
|
|
|
|
var i = this.input();
|
|
|
|
return i.mark == mark || i.stay || i.determinedBy == null;
|
|
|
|
}
|
|
|
|
|
|
|
|
BinaryConstraint.prototype.removeFromGraph = function () {
|
|
|
|
if (this.v1 != null) this.v1.removeConstraint(this);
|
|
|
|
if (this.v2 != null) this.v2.removeConstraint(this);
|
|
|
|
this.direction = Direction.NONE;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* S c a l e C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Relates two variables by the linear scaling relationship: "v2 =
|
|
|
|
* (v1 * scale) + offset". Either v1 or v2 may be changed to maintain
|
|
|
|
* this relationship but the scale factor and offset are considered
|
|
|
|
* read-only.
|
|
|
|
*/
|
|
|
|
function ScaleConstraint(src, scale, offset, dest, strength) {
|
|
|
|
this.direction = Direction.NONE;
|
|
|
|
this.scale = scale;
|
|
|
|
this.offset = offset;
|
|
|
|
ScaleConstraint.superConstructor.call(this, src, dest, strength);
|
|
|
|
}
|
|
|
|
|
|
|
|
ScaleConstraint.inheritsFrom(BinaryConstraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds this constraint to the constraint graph.
|
|
|
|
*/
|
|
|
|
ScaleConstraint.prototype.addToGraph = function () {
|
|
|
|
ScaleConstraint.superConstructor.prototype.addToGraph.call(this);
|
|
|
|
this.scale.addConstraint(this);
|
|
|
|
this.offset.addConstraint(this);
|
|
|
|
}
|
|
|
|
|
|
|
|
ScaleConstraint.prototype.removeFromGraph = function () {
|
|
|
|
ScaleConstraint.superConstructor.prototype.removeFromGraph.call(this);
|
|
|
|
if (this.scale != null) this.scale.removeConstraint(this);
|
|
|
|
if (this.offset != null) this.offset.removeConstraint(this);
|
|
|
|
}
|
|
|
|
|
|
|
|
ScaleConstraint.prototype.markInputs = function (mark) {
|
|
|
|
ScaleConstraint.superConstructor.prototype.markInputs.call(this, mark);
|
|
|
|
this.scale.mark = this.offset.mark = mark;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enforce this constraint. Assume that it is satisfied.
|
|
|
|
*/
|
|
|
|
ScaleConstraint.prototype.execute = function () {
|
|
|
|
if (this.direction == Direction.FORWARD) {
|
|
|
|
this.v2.value = this.v1.value * this.scale.value + this.offset.value;
|
|
|
|
} else {
|
|
|
|
this.v1.value = (this.v2.value - this.offset.value) / this.scale.value;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Calculate the walkabout strength, the stay flag, and, if it is
|
|
|
|
* 'stay', the value for the current output of this constraint. Assume
|
|
|
|
* this constraint is satisfied.
|
|
|
|
*/
|
|
|
|
ScaleConstraint.prototype.recalculate = function () {
|
|
|
|
var ihn = this.input(), out = this.output();
|
|
|
|
out.walkStrength = Strength.weakestOf(this.strength, ihn.walkStrength);
|
|
|
|
out.stay = ihn.stay && this.scale.stay && this.offset.stay;
|
|
|
|
if (out.stay) this.execute();
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* E q u a l i t y C o n s t r a i n t
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constrains two variables to have the same value.
|
|
|
|
*/
|
|
|
|
function EqualityConstraint(var1, var2, strength) {
|
|
|
|
EqualityConstraint.superConstructor.call(this, var1, var2, strength);
|
|
|
|
}
|
|
|
|
|
|
|
|
EqualityConstraint.inheritsFrom(BinaryConstraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enforce this constraint. Assume that it is satisfied.
|
|
|
|
*/
|
|
|
|
EqualityConstraint.prototype.execute = function () {
|
|
|
|
this.output().value = this.input().value;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* V a r i a b l e
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A constrained variable. In addition to its value, it maintain the
|
|
|
|
* structure of the constraint graph, the current dataflow graph, and
|
|
|
|
* various parameters of interest to the DeltaBlue incremental
|
|
|
|
* constraint solver.
|
|
|
|
**/
|
|
|
|
function Variable(name, initialValue) {
|
|
|
|
this.value = initialValue || 0;
|
|
|
|
this.constraints = new OrderedCollection();
|
|
|
|
this.determinedBy = null;
|
|
|
|
this.mark = 0;
|
|
|
|
this.walkStrength = Strength.WEAKEST;
|
|
|
|
this.stay = true;
|
|
|
|
this.name = name;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add the given constraint to the set of all constraints that refer
|
|
|
|
* this variable.
|
|
|
|
*/
|
|
|
|
Variable.prototype.addConstraint = function (c) {
|
|
|
|
this.constraints.add(c);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Removes all traces of c from this variable.
|
|
|
|
*/
|
|
|
|
Variable.prototype.removeConstraint = function (c) {
|
|
|
|
this.constraints.remove(c);
|
|
|
|
if (this.determinedBy == c) this.determinedBy = null;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* P l a n n e r
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The DeltaBlue planner
|
|
|
|
*/
|
|
|
|
function Planner() {
|
|
|
|
this.currentMark = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Attempt to satisfy the given constraint and, if successful,
|
|
|
|
* incrementally update the dataflow graph. Details: If satifying
|
|
|
|
* the constraint is successful, it may override a weaker constraint
|
|
|
|
* on its output. The algorithm attempts to resatisfy that
|
|
|
|
* constraint using some other method. This process is repeated
|
|
|
|
* until either a) it reaches a variable that was not previously
|
|
|
|
* determined by any constraint or b) it reaches a constraint that
|
|
|
|
* is too weak to be satisfied using any of its methods. The
|
|
|
|
* variables of constraints that have been processed are marked with
|
|
|
|
* a unique mark value so that we know where we've been. This allows
|
|
|
|
* the algorithm to avoid getting into an infinite loop even if the
|
|
|
|
* constraint graph has an inadvertent cycle.
|
|
|
|
*/
|
|
|
|
Planner.prototype.incrementalAdd = function (c) {
|
|
|
|
var mark = this.newMark();
|
|
|
|
var overridden = c.satisfy(mark);
|
|
|
|
while (overridden != null)
|
|
|
|
overridden = overridden.satisfy(mark);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Entry point for retracting a constraint. Remove the given
|
|
|
|
* constraint and incrementally update the dataflow graph.
|
|
|
|
* Details: Retracting the given constraint may allow some currently
|
|
|
|
* unsatisfiable downstream constraint to be satisfied. We therefore collect
|
|
|
|
* a list of unsatisfied downstream constraints and attempt to
|
|
|
|
* satisfy each one in turn. This list is traversed by constraint
|
|
|
|
* strength, strongest first, as a heuristic for avoiding
|
|
|
|
* unnecessarily adding and then overriding weak constraints.
|
|
|
|
* Assume: c is satisfied.
|
|
|
|
*/
|
|
|
|
Planner.prototype.incrementalRemove = function (c) {
|
|
|
|
var out = c.output();
|
|
|
|
c.markUnsatisfied();
|
|
|
|
c.removeFromGraph();
|
|
|
|
var unsatisfied = this.removePropagateFrom(out);
|
|
|
|
var strength = Strength.REQUIRED;
|
|
|
|
do {
|
|
|
|
for (var i = 0; i < unsatisfied.size(); i++) {
|
|
|
|
var u = unsatisfied.at(i);
|
|
|
|
if (u.strength == strength)
|
|
|
|
this.incrementalAdd(u);
|
|
|
|
}
|
|
|
|
strength = strength.nextWeaker();
|
|
|
|
} while (strength != Strength.WEAKEST);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Select a previously unused mark value.
|
|
|
|
*/
|
|
|
|
Planner.prototype.newMark = function () {
|
|
|
|
return ++this.currentMark;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Extract a plan for resatisfaction starting from the given source
|
|
|
|
* constraints, usually a set of input constraints. This method
|
|
|
|
* assumes that stay optimization is desired; the plan will contain
|
|
|
|
* only constraints whose output variables are not stay. Constraints
|
|
|
|
* that do no computation, such as stay and edit constraints, are
|
|
|
|
* not included in the plan.
|
|
|
|
* Details: The outputs of a constraint are marked when it is added
|
|
|
|
* to the plan under construction. A constraint may be appended to
|
|
|
|
* the plan when all its input variables are known. A variable is
|
|
|
|
* known if either a) the variable is marked (indicating that has
|
|
|
|
* been computed by a constraint appearing earlier in the plan), b)
|
|
|
|
* the variable is 'stay' (i.e. it is a constant at plan execution
|
|
|
|
* time), or c) the variable is not determined by any
|
|
|
|
* constraint. The last provision is for past states of history
|
|
|
|
* variables, which are not stay but which are also not computed by
|
|
|
|
* any constraint.
|
|
|
|
* Assume: sources are all satisfied.
|
|
|
|
*/
|
|
|
|
Planner.prototype.makePlan = function (sources) {
|
|
|
|
var mark = this.newMark();
|
|
|
|
var plan = new Plan();
|
|
|
|
var todo = sources;
|
|
|
|
while (todo.size() > 0) {
|
|
|
|
var c = todo.removeFirst();
|
|
|
|
if (c.output().mark != mark && c.inputsKnown(mark)) {
|
|
|
|
plan.addConstraint(c);
|
|
|
|
c.output().mark = mark;
|
|
|
|
this.addConstraintsConsumingTo(c.output(), todo);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return plan;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Extract a plan for resatisfying starting from the output of the
|
|
|
|
* given constraints, usually a set of input constraints.
|
|
|
|
*/
|
|
|
|
Planner.prototype.extractPlanFromConstraints = function (constraints) {
|
|
|
|
var sources = new OrderedCollection();
|
|
|
|
for (var i = 0; i < constraints.size(); i++) {
|
|
|
|
var c = constraints.at(i);
|
|
|
|
if (c.isInput() && c.isSatisfied())
|
|
|
|
// not in plan already and eligible for inclusion
|
|
|
|
sources.add(c);
|
|
|
|
}
|
|
|
|
return this.makePlan(sources);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Recompute the walkabout strengths and stay flags of all variables
|
|
|
|
* downstream of the given constraint and recompute the actual
|
|
|
|
* values of all variables whose stay flag is true. If a cycle is
|
|
|
|
* detected, remove the given constraint and answer
|
|
|
|
* false. Otherwise, answer true.
|
|
|
|
* Details: Cycles are detected when a marked variable is
|
|
|
|
* encountered downstream of the given constraint. The sender is
|
|
|
|
* assumed to have marked the inputs of the given constraint with
|
|
|
|
* the given mark. Thus, encountering a marked node downstream of
|
|
|
|
* the output constraint means that there is a path from the
|
|
|
|
* constraint's output to one of its inputs.
|
|
|
|
*/
|
|
|
|
Planner.prototype.addPropagate = function (c, mark) {
|
|
|
|
var todo = new OrderedCollection();
|
|
|
|
todo.add(c);
|
|
|
|
while (todo.size() > 0) {
|
|
|
|
var d = todo.removeFirst();
|
|
|
|
if (d.output().mark == mark) {
|
|
|
|
this.incrementalRemove(c);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
d.recalculate();
|
|
|
|
this.addConstraintsConsumingTo(d.output(), todo);
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update the walkabout strengths and stay flags of all variables
|
|
|
|
* downstream of the given constraint. Answer a collection of
|
|
|
|
* unsatisfied constraints sorted in order of decreasing strength.
|
|
|
|
*/
|
|
|
|
Planner.prototype.removePropagateFrom = function (out) {
|
|
|
|
out.determinedBy = null;
|
|
|
|
out.walkStrength = Strength.WEAKEST;
|
|
|
|
out.stay = true;
|
|
|
|
var unsatisfied = new OrderedCollection();
|
|
|
|
var todo = new OrderedCollection();
|
|
|
|
todo.add(out);
|
|
|
|
while (todo.size() > 0) {
|
|
|
|
var v = todo.removeFirst();
|
|
|
|
for (var i = 0; i < v.constraints.size(); i++) {
|
|
|
|
var c = v.constraints.at(i);
|
|
|
|
if (!c.isSatisfied())
|
|
|
|
unsatisfied.add(c);
|
|
|
|
}
|
|
|
|
var determining = v.determinedBy;
|
|
|
|
for (var i = 0; i < v.constraints.size(); i++) {
|
|
|
|
var next = v.constraints.at(i);
|
|
|
|
if (next != determining && next.isSatisfied()) {
|
|
|
|
next.recalculate();
|
|
|
|
todo.add(next.output());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return unsatisfied;
|
|
|
|
}
|
|
|
|
|
|
|
|
Planner.prototype.addConstraintsConsumingTo = function (v, coll) {
|
|
|
|
var determining = v.determinedBy;
|
|
|
|
var cc = v.constraints;
|
|
|
|
for (var i = 0; i < cc.size(); i++) {
|
|
|
|
var c = cc.at(i);
|
|
|
|
if (c != determining && c.isSatisfied())
|
|
|
|
coll.add(c);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* P l a n
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A Plan is an ordered list of constraints to be executed in sequence
|
|
|
|
* to resatisfy all currently satisfiable constraints in the face of
|
|
|
|
* one or more changing inputs.
|
|
|
|
*/
|
|
|
|
function Plan() {
|
|
|
|
this.v = new OrderedCollection();
|
|
|
|
}
|
|
|
|
|
|
|
|
Plan.prototype.addConstraint = function (c) {
|
|
|
|
this.v.add(c);
|
|
|
|
}
|
|
|
|
|
|
|
|
Plan.prototype.size = function () {
|
|
|
|
return this.v.size();
|
|
|
|
}
|
|
|
|
|
|
|
|
Plan.prototype.constraintAt = function (index) {
|
|
|
|
return this.v.at(index);
|
|
|
|
}
|
|
|
|
|
|
|
|
Plan.prototype.execute = function () {
|
|
|
|
for (var i = 0; i < this.size(); i++) {
|
|
|
|
var c = this.constraintAt(i);
|
|
|
|
c.execute();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* --- *
|
|
|
|
* M a i n
|
|
|
|
* --- */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This is the standard DeltaBlue benchmark. A long chain of equality
|
|
|
|
* constraints is constructed with a stay constraint on one end. An
|
|
|
|
* edit constraint is then added to the opposite end and the time is
|
|
|
|
* measured for adding and removing this constraint, and extracting
|
|
|
|
* and executing a constraint satisfaction plan. There are two cases.
|
|
|
|
* In case 1, the added constraint is stronger than the stay
|
|
|
|
* constraint and values must propagate down the entire length of the
|
|
|
|
* chain. In case 2, the added constraint is weaker than the stay
|
|
|
|
* constraint so it cannot be accomodated. The cost in this case is,
|
|
|
|
* of course, very low. Typical situations lie somewhere between these
|
|
|
|
* two extremes.
|
|
|
|
*/
|
|
|
|
function chainTest(n) {
|
|
|
|
planner = new Planner();
|
|
|
|
var prev = null, first = null, last = null;
|
|
|
|
|
|
|
|
// Build chain of n equality constraints
|
|
|
|
for (var i = 0; i <= n; i++) {
|
|
|
|
var name = "v" + i;
|
|
|
|
var v = new Variable(name);
|
|
|
|
if (prev != null)
|
|
|
|
new EqualityConstraint(prev, v, Strength.REQUIRED);
|
|
|
|
if (i == 0) first = v;
|
|
|
|
if (i == n) last = v;
|
|
|
|
prev = v;
|
|
|
|
}
|
|
|
|
|
|
|
|
new StayConstraint(last, Strength.STRONG_DEFAULT);
|
|
|
|
var edit = new EditConstraint(first, Strength.PREFERRED);
|
|
|
|
var edits = new OrderedCollection();
|
|
|
|
edits.add(edit);
|
|
|
|
var plan = planner.extractPlanFromConstraints(edits);
|
|
|
|
for (var i = 0; i < 100; i++) {
|
|
|
|
first.value = i;
|
|
|
|
plan.execute();
|
|
|
|
if (last.value != i)
|
|
|
|
alert("Chain test failed.");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This test constructs a two sets of variables related to each
|
|
|
|
* other by a simple linear transformation (scale and offset). The
|
|
|
|
* time is measured to change a variable on either side of the
|
|
|
|
* mapping and to change the scale and offset factors.
|
|
|
|
*/
|
|
|
|
function projectionTest(n) {
|
|
|
|
planner = new Planner();
|
|
|
|
var scale = new Variable("scale", 10);
|
|
|
|
var offset = new Variable("offset", 1000);
|
|
|
|
var src = null, dst = null;
|
|
|
|
|
|
|
|
var dests = new OrderedCollection();
|
|
|
|
for (var i = 0; i < n; i++) {
|
|
|
|
src = new Variable("src" + i, i);
|
|
|
|
dst = new Variable("dst" + i, i);
|
|
|
|
dests.add(dst);
|
|
|
|
new StayConstraint(src, Strength.NORMAL);
|
|
|
|
new ScaleConstraint(src, scale, offset, dst, Strength.REQUIRED);
|
|
|
|
}
|
|
|
|
|
|
|
|
change(src, 17);
|
|
|
|
if (dst.value != 1170) alert("Projection 1 failed");
|
|
|
|
change(dst, 1050);
|
|
|
|
if (src.value != 5) alert("Projection 2 failed");
|
|
|
|
change(scale, 5);
|
|
|
|
for (var i = 0; i < n - 1; i++) {
|
|
|
|
if (dests.at(i).value != i * 5 + 1000)
|
|
|
|
alert("Projection 3 failed");
|
|
|
|
}
|
|
|
|
change(offset, 2000);
|
|
|
|
for (var i = 0; i < n - 1; i++) {
|
|
|
|
if (dests.at(i).value != i * 5 + 2000)
|
|
|
|
alert("Projection 4 failed");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function change(v, newValue) {
|
|
|
|
var edit = new EditConstraint(v, Strength.PREFERRED);
|
|
|
|
var edits = new OrderedCollection();
|
|
|
|
edits.add(edit);
|
|
|
|
var plan = planner.extractPlanFromConstraints(edits);
|
|
|
|
for (var i = 0; i < 10; i++) {
|
|
|
|
v.value = newValue;
|
|
|
|
plan.execute();
|
|
|
|
}
|
|
|
|
edit.destroyConstraint();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Global variable holding the current planner.
|
|
|
|
var planner = null;
|
|
|
|
|
|
|
|
function deltaBlue() {
|
|
|
|
chainTest(100);
|
|
|
|
projectionTest(100);
|
|
|
|
}
|