Table of Contents

add-cell-watcher

Usage: (add-cell-watcher cell key fun)

Adds a watcher to a cell to respond to changes of value.  The is a
function of 4 values: a key, the cell, its old value, its new
value.  This is implemented using Clojure's add-watch to the
underlying ref, and shared its sematics

add-cells

Usage: (add-cells df cells)

Given a collection of cells, add them to the dataflow.

build-dataflow

Usage: (build-dataflow cs)

Given a collection of cells, build and return a dataflow object

build-source-cell

Usage: (build-source-cell name init)

Builds a source cell

build-standard-cell

Usage: (build-standard-cell name deps fun expr)

Builds a standard cell

build-validator-cell

Usage: (build-validator-cell deps fun expr)

Builds a validator cell

cell

Usage: (cell type & data)

Build a standard cell, like this:

 (cell fred
    (* ?mary ?joe))

Which creates a cell named fred that is the product of a cell mary and cell joe

Or:

 (cell joe
   (apply * ?*sally))

Which creates a cell that applies * to the collection of all cells named sally

Or:

 (cell :source fred 0)

Which builds a source cell fred with initial value 0

Or:

  (cell :validator (when (< ?fred ?sally)
                       (throwf "%s must be greater than %s" ?fred ?sally))

Which will perform the validation

display-cell

A 'readable' form of the cell

eval-cell

Evaluate a dataflow cell.  Return [changed, old val]

get-cell

Usage: (get-cell df name)

Get the single cell named by name

get-cells

Usage: (get-cells df name)

Get all the cells named by name

get-old-value

Usage: (get-old-value df env name)

Looks up an old value

get-source-cells

Usage: (get-source-cells df)

Returns a collection of source cells from the dataflow

get-value

Usage: (get-value df name)

Gets a value from the df matching the passed symbol.
Signals an error if the name is not present, or if it not a single
value.

get-value-from-cell

Usage: (get-value-from-cell cell)

Given a cell, get its value

get-values

Usage: (get-values df name)

Gets a collection of values from the df by name

print-dataflow

Usage: (print-dataflow df)

Prints a dataflow, one cell per line

remove-cells

Usage: (remove-cells df cells)

Given a collection of cells, remove them from the dataflow.

source-cell?

Usage: (source-cell? cell)

Is this cell a source cell?

update-values

Usage: (update-values df data)

Given a dataflow, and a map of name-value pairs, update the
dataflow by binding the new values.  Each name must be of a source
cell