All registered ini/umwelt/rule types.

Returns a cell value given a rule-spec (via make-rule), an umwelt (via observe-umwelt) and the current cell (a vector of the shape [[x ?y] value]).

Returns a lazy seq that iteratively computes the next generation for the given a ca-spec (cellular automaton specification, via specify-ca, etc.) and a resolution vector.

May take an additional argument as an options map with keys:

• :seed → an integer number to provide a seed for reproducable randomness (in case of randomness in the ini spec)

May take as the final argument (after the options map) a number to just get the first n steps in its evolution.

Map of common specimen to specify cellular automata. Contains all the SelFis introduced by Ralf Peyn in ‘uFORM iFORM’.

Returns a stateful CellularAutomaton object for the given ca-spec (cellular automaton specification, via specify-ca, etc.) and a resolution vector.

Callable methods are step, restart, get-resolution, get-current-generation, get-cached-history, get-system-time and get-history-cache-limit (see docs for further explanation).

The last argument can be an options map with keys:

• history-cache-limit → manually set the limit for how many generations will be cached (otherwise an heuristic algorithm is used)
• :seed → an integer number to provide a seed for reproducable randomness (in case of randomness in the ini spec)

Defines a new type of ini pattern, to be specified with make-ini. Takes a keyword identifier (type-k), fields for data the user needs to provide, an optional doc-string? (to describe the fields and the pattern) and one or more implementations of:

• (make-gen [this opts w] …) for a 1D pattern
• (make-gen [this opts w h] …) for a 2D pattern
• opts is an options map that can have keys such as :seed.

Defines a new type of rule pattern, to be specified with make-rule. Takes a keyword identifier (type-k), fields for data the user needs to provide, an optional doc-string? (to describe the fields and the pattern) and one or more implementations of:

• (apply-rule [this umwelt self-v] …)
• umwelt is an ‘umwelt’ as provided by observe-umwelt
• self-v is the value of the currently selected cell

Defines a new type of umwelt pattern, to be specified with make-umwelt. Takes a keyword identifier (type-k), fields for data the user needs to provide, an optional doc-string? (to describe the fields and the pattern) and one or more implementations of:

• (observe-umwelt [this gen1d cell w] …) for a 1D pattern
• (observe-umwelt [this gen2d cell w h] …) for a 2D pattern
• gen1d/gen2d is a vector of the current generation (flat in 1D, nested in 2D)
• cell is a vector [[x …] v] of the current cell coordinates and value

Given a stateful ca-object (of type CellularAutomaton), returns its cached history/evolution, where all generations are either vectors or native arrays (if optimized? is true).

Given a stateful ca-object (of type CellularAutomaton), returns its current generation either as a vector or a native array (if optimized? is true).

Given a stateful ca-object (of type CellularAutomaton), returns the max. number of generations it caches (stored in its history).

Given a stateful ca-object (of type CellularAutomaton), returns its resolution.

Given a stateful ca-object (of type CellularAutomaton), returns its generation index (aka “system-time”).

A collection of predefined patterns for use with :figure inis.

Returns a 2D cellular automaton known as a “decisionFORM” given a dna for its rule function and an initial-size for its ini (type :rand-figure).

The last argument can be an options map with keys:

• :overwrites → a map to overwrite any part of the returned CA spec

Creates an instance of a CA ini (initial conditions) specification of a given type (as a keyword) and with given parameters as required by the type.

• (make-ini :help) prints a list of all ini types and their parameters
• (make-ini :t :help) prints the parameters and docs for given type :t

Returns a 2D cellular automaton known as a “lifeFORM” given a dna for its rule function.

The last argument can be an options map with keys:

• :overwrites → a map to overwrite any part of the returned CA spec

Returns a 2D cellular automaton known as a “mindFORM” given a dna for its rule function and an ini-spec (via make-ini).

The last argument can be an options map with keys:

• :overwrites → a map to overwrite any part of the returned CA spec

Creates an instance of a CA rule specification of a given type (as a keyword) and with given parameters as required by the type.

• (make-rule :help) prints a list of all rule types and their parameters
• (make-rule :t :help) prints the parameters and docs for given type :t

Returns a 1D cellular automaton known as a “SelFi” given a dna for its rule function and an ini-spec (via make-ini). Its ‘umwelt’ is of type :select-ltr.

The last argument can be an options map with keys:

• :overwrites → a map to overwrite any part of the returned CA spec

Creates an instance of a CA umwelt (neighborhood) specification of a given type (as a keyword) and with given parameters as required by the type.

• (make-umwelt :help) prints a list of all umwelt types and their parameters
• (make-umwelt :t :help) prints the parameters and docs for given type :t

Returns an ‘umwelt’ given a umwelt-spec (via make-umwelt), a generation and the current cell (a vector of the shape [[x ?y] value]).

Given a stateful ca-object (of type CellularAutomaton), resets its evolution to the initial generation.

Returns a CASpec record, given a specs-map (which is a map of specifications for a custom cellular automaton) and an optional label. The CASpec can be used with ca-iterator or create-ca. The input map needs to have all of the following entries:

• :rule-spec: a rule specification as per make-rule
• :umwelt-spec: an umwelt specification as per make-umwelt
• :ini-spec: an ini specification as per make-ini

Note that formform.emul has constructors for common ca specs via make-selfi, make-mindform, make-lifeform and make-decisionform. Furthermore, there are predefined ca specs in common-specimen.

Given a stateful ca-object (of type CellularAutomaton), computes its next generation and appends it to its evolution state.

Returns an (initial) generation given an ini-spec (via make-ini) and a resolution. resolution must be a vector [width] (1D) or [width height] (2D).

The last argument can be an options map with keys:

• :seed → an integer number to provide a seed for reproducable randomness

Computes and returns the next generation given a rule-spec (via make-rule), an umwelt-spec (via make-umwelt) and a generation.