spaced-repetition.sm5 — org.clojars.euccastro/spaced-repetition 0.1.3

calculate-new-optimal-factor clj/s

(calculate-new-optimal-factor interval-used quality used-of old-of fraction)

Takes the following arguments:

• interval-used, the last interval used for the item in question

• quality of the repetition response;

• used-of, the optimal factor used in calculation of the last interval used for the item in question;

• old-of, the previous value of the OF entry corresponding to the relevant repetition number and the E-Factor of the item;

• fraction, a number belonging to the range (0,1) determining the rate of modifications (the greater it is the faster the changes of the OF matrix).

Returns the newly calculated value of the considered entry of the OF matrix.

Intermediate values involved:

• mod5, value proposed for the modifier in case of q=5;

• mod2, value proposed for the modifier in case of q=2;

• modifier,number determining how many times the OF value will increase or decrease.

default-ef clj/s

dispersal-m clj/s

(dispersal-m)

ef-bucket clj/s

(ef-bucket ef)

initial-optimal-factor clj/s

(initial-optimal-factor n ef)

inter-repetition-interval clj/s

(inter-repetition-interval n ef ofm last-interval)

interpolate-with-ef clj/s

(interpolate-with-ef ef low high)

learn-fraction clj/s

min-ef clj/s

modify-e-factor clj/s

(modify-e-factor ef quality)

near-optimal-interval clj/s

(near-optimal-interval previously-used-interval optimal-interval)

next-state clj/s

(next-state quality)

(next-state quality of-matrix)

(next-state quality of-matrix [last-n last-ef last-interval used-of])

Calculate the next time an item should be reviewed by a user.

quality [user-state [item-state]] -> {:days-to-next ... :new-user-state ... :new-item-state ...}

[XXX: find link explaining quality of recall.]

Users and items (questions to learn) are represented by opaque data structures. You pass these structures to this function and get new versions of them returned in a mapping. The first time a given item is reviewed by a given user you can omit the item-state', and the first time a given user reviews any item at all you can omit theuser state'.

In addition to rescheduling the question for the new-interval, any questions in this session with quality lower than 3 should be reviewed cyclically until quality becomes 4 or 5. You should do those repetitions on your own without calling this function.

ofm-ref clj/s

(ofm-ref ofm n ef)

ofm-set clj/s

(ofm-set ofm n ef of)

propagate clj/s

(propagate {[src-ef src-of] :last-set} dest-n dest-ef)