emmy.mathbox.physics — org.mentat/emmy-viewers 0.2.0

Server-side rendering functions for the components declared in the emmy.mathbox.components.physics namespace.

comet clj/s

(comet {:keys [initial-state] :as opts})

Returns a fragment that renders a point that trails its historical positions out behind it in a glowing tail.

Required arguments:

• :atom: atom holding a JS array representing some state. :state->xyz will transform this into xyz coordinates to draw.

Optional arguments:

• :state->xyz: function from the contents of :atom to [x y z] coordinates.

• :initial-state: structure in the shape of the state required by :state->xyz', used if :state->xyz' is a function that needs to be compiled (ie not a quoted literal function).

• :length: the length of the comet tail. Defaults to 16.

• :size: size of the comet. Defaults to 10.

• :opacity: opacity of the leading point of the comet. Defaults to 1.0.

• :color: color of each curve. This can be a three.js Color object or any valid input to its constructor.

• :z-order: z-order of the comet.

• :z-index: zIndex of the comet. Defaults to 0.

• :z-bias: zBias of the comet. Defaults to 0.

ode-curve clj/s

(ode-curve {:keys [initial-state] :as opts})

Returns a fragment that plots a curve by integrating a system of ordinary differential equations represented by f' forward from the initial input state initial-state for steps steps of dt each.

Required arguments:

• :f': function of the form (fn [[y0 y1 ...]] [<y0'> <y1'> ...]) that returns a vector of the derivatives of each input variable.

• :initial-state: the initial input vector to :f'.

Optional arguments:

• :state->xyz: function of the form (fn [[y0 y1 ...]] [<x> <y> <z>]), responsible for transforming each integrated state into a 3D point. Defaults to identity.

• :steps: the number of :dt-spaced steps for the integrator to take. Defaults to 1000.

• :dt: the distance of each evenly spaced step taken by the integrator. Defaults to 3e-2.

• :epsilon: error tolerance passed along to odex-js. Defaults to 1e-5.

• :width: width of the curve. Defaults to 4.

• :start? if true, renders an arrow at the start of the curve. Defaults to false.

• :end? if true, renders an arrow at the end of the curve. Defaults to false.

• :arrow-size: size of the arrows toggled by :start? and :end?. Defaults to 6.

• :opacity: opacity of the curve. Defaults to 1.0.

• :color: color of the curve. This can be a three.js Color object or any valid input to its constructor.

• :z-order: z-order of the curve.

• :z-index: zIndex of the curve. Defaults to 0.

• :z-bias: zBias of the curve. Defaults to 0.