tiltontec.cell.evaluate — com.tiltontec/matrix 0.1.4-SNAPSHOT

*custom-propagater* clj/s

<cget clj/s

(<cget c)

c-absorb-value clj/s

c-awaken clj/s multimethod

c-get clj/s

(c-get c)

The API for determing the value associated with a Cell. Ensures value is current, records any dependent, and notices if a standalone cell has never been observed.

c-quiesce clj/s

(c-quiesce c)

c-value-assume clj/s

(c-value-assume c new-value propagation-code)

The Cell assumes a new value at awakening, on c-reset!, or after formula recalculation.

We record the new value, set the Cell state to :awake, make its pulse current, check to see if a formula cell can be optimized away, and then propagate to any dependent formula cells.

c-value-changed? clj/s

(c-value-changed? c new-value old-value)

calculate-and-link clj/s

(calculate-and-link c)

The name is accurate: we do no more than invoke the rule of a formula and return its value*, but along the way the links between dependencies and dependents get determined anew.

• Well, we also look to see if a synaptic cell has attached a propagaion code to a vector used to wrap the raw value, which we then unpack.

calculate-and-set clj/s

(calculate-and-set c dbgid dbgdata)

Calculate, link, record, and propagate.

ensure-value-is-current clj/s

(ensure-value-is-current c debug-id ensurer)

The key to data integrity: recursively check the known dependency graph to decide if we are current, and if not kick off recalculation and propagation.

ephemeral-reset clj/s

(ephemeral-reset rc)

md-cell-flush clj/s

(md-cell-flush c)

md-slot-cell-flushed clj/s

md-slot-value-store clj/s

(md-slot-value-store me slot value)

not-to-be clj/s multimethod

not-to-be-self clj/s

(not-to-be-self me)

optimize-away?! clj/s

(optimize-away?! c prior-value)

Optimizes away cells who turn out not to depend on anyone, saving a lot of work at runtime. A caller/user will not bother establishing a link, and when we get to models cget will find a non-cell in a slot and Just Use It.

propagate clj/s

(propagate c prior-value callers)

A cell:

• notifies its callers of its change;
• calls any observer; and
• if ephemeral, silently reverts to nil.

propagate-to-callers clj/s

(propagate-to-callers c callers)

record-dependency clj/s

(record-dependency used)

unchanged-test clj/s multimethod

Cells does not propagate when nothing changes. By default, the test is =, but cells can inject a different test, and when we get to models it will be possible for a slot to have associated with it a different test.

unlink-from-used clj/s

(unlink-from-used c why)