mapdag.runtime.jvm-eval — vvvvalvalval/mapdag 0.2.2

AOT-compilation of graphs on the JVM, improving performance by leveraging JVM-specific code generation (via clojure.core/eval) and primitive values.

Compared to the reference mapdag interpreter, addresses the following sources of execution overhead:

1. Dynamic argument passing to the :mapdag.step/compute-fn (via clojure.core/apply). This implementation generates arity-aware code.
2. Map-based navigation. This implementation generates code that navigates the graph through primitive array lookups.
3. Megamorphic JVM call sites (when calling the :mapdag.step/compute-fn), impeding JIT optimization. This function eschews this by generating code which defines one function per step, and does static dispatch on the keys (using clojure.core/case).

case-able-key? clj

(case-able-key? k)

compile-default clj

(compile-default graph)

compile-graph clj

(compile-graph {:as _opts
                output-keys :mapdag.run/output-keys
                input-keys :mapdag.run/input-keys
                :or {input-keys false output-keys false}}
               graph)

Performs Ahead-Of-Time compilation of the supplied mapdag graph. Uses clojure.core/eval.

When known in advance, the available input keys and requested output keys may be supplied, allowing for an even more optimized computation.

Returns a function which accepts an inputs-map and (when not supplied AOT) output-keys, and returns a map.

compile-with-known-input-and-outputs clj

(compile-with-known-input-and-outputs graph input-keys output-keys)

compile-with-known-outputs clj

(compile-with-known-outputs graph output-keys)

compute-fn-threw-ex clj

(compute-fn-threw-ex graph step-name deps-values causing-err)

dep-cycle-ex clj

(dep-cycle-ex step-name)

explained-code clj macro

(explained-code expl-vec)

(explained-code expl-vec expr)

A noop macro for emitting self-commenting code.

The first expl-vec argument (typically a vector) can be used for commenting, and won't be emitted in expansion. The unchanged second argument (or nil if not supplied) will be the result of macro-expansion.

missing-step-or-input-ex clj

(missing-step-or-input-ex step-name)

static-steps-plan clj

(static-steps-plan graph input-keys output-keys)