supermemo2 0.0.2

Implements the SuperMemo-2/SM-2 algorithm for spaced repetition learning.

SuperMemo2

A package that implemented the famous spaced repetition algorithm SuperMemo-2/SM-2. A lot of software that does spaced repetition learning based their algorithm on SM-2, and there are a lot of research done around it.

:package: Link to the PyPI page: https://pypi.org/project/supermemo2/

:paperclip: The implementation of the algorithm is followed by https://www.supermemo.com/en/archives1990-2015/english/ol/sm2.

Motivation

The motivation behind making this package was for my API. I'm making a RESTful API for spaced repetition learning called CYA, I was planning on adding the feature of calculating the next review date, then I came across SM-2.

I assumed there would be a package I can import since it's well known and been around for decades. Surprisedly, I didn't find one for Python, so I thought I would make one for other people that might need it.

:books: If you are curious of what spaced repetition is, check this out: https://ncase.me/remember/

Requirements

:one: Python 3.7 :two: pip

Installation

To install the package, you may do...

pip3 install supermemo2

Now you can use the package in Python 3!

:page_facing_up: Make sure you are installing for Python 3, Python 2 is NOT supported.

Feature

:mega: Implements the SM-2 algorithm. :mega: Calculates the next review date for the task you are learning using the algorithm.

SuperMemoTwo(quality, interval=0, repetitions=0, easiness=2.5, first_visit=False, last_review=datetime.date.today())

Input types...

• quality: int
• interval: int
• repetitions: int
• easiness: float
• first_visit: boolean
• last_review: string or datetime.date objects

Default values...

• interval = 0
• repetitions = 0
• easiness = 2.5
• first_visit = False
• last_review = current date/today

NOTE: The default value for interval, repetitions and easiness are the values for the very first attempt.

So if you the task that you learning is completely new, you may create the instance like this...

# To create an instance when the task is completely new
sm_two = SuperMemoTwo(quality=3, first_visit=True)

SuperMemoTwo.json( )

Returns new information in json format.

Information like...

- next_review: the next review date.
- new repetitions: the new repetition value.
- new_easiness: the new easiness value.
- new_interval: the new interval value.

SuperMemoTwo.new_sm_two()

Calculates the new_repetitions, new_easiness and new_interval values.

NOTE: If you make any changes to an existing instance's attributes, you most likely will need to call this method to re-calculate the values.

Example

# Creating a SuperMemoTwo instance
sm_two = SMTwo(quality=3, interval=24, repetitions=3, easiness=1.7)

# Prints 2020-08-15
print(sm_two.next_review)

# Modified an existing instance's attributes
sm_two.interval =  12

# Prints 2020-08-15, not updated yet
print(sm_two.next_review)

# Re-calculates the values
sm_two.new_sm_two()

# Prints 2020-07-25, now you have the updated values
print(sm_two.next_review)

Quick Start

NOTE: The package DOES NOT record the values, you would need to store the values somewhere. For me, I'm using this package for my CYA API, so all the records will be stored on AWS cloud.

For example, let's say you are learning "Hello" in Spanish, which would be "Hola".

You can start off with...

from supermemo2 import SMTwo

# You can leave the other arguments blank, since their default values are setup for new tasks.
# last_review can be left blank if the date is today
# First attempt of recalling the Spanish word of Hello
sm_two = SMTwo(quality=3, first_visited=True, last_review="2020-07-05")

# Prints 2020-07-06
print(sm_two.next_review)

# Second attempt of recalling the Spanish word of Hello
next_sm_two = SMTwo(quality=3, interval=sm_two.new_interval, repetitions=sm_two.new_repetitions, easiness=sm_two.new_easiness, last_review="2020-07-06")

# Prints 2020-07-12, your next attempt date
print(next_sm_two.next_review)

# Third attempt of recalling the Spanish word of Hello
next_next_sm_two = SMTwo(quality=4, interval=next_sm_two.new_interval, repetitions=next_sm_two.new_repetitions, easiness=next_sm_two.new_easiness, last_review="2020-07-12")

# Prints 2020-07-25, your next attempt date
print(next_next_sm_two.next_review)

And so on.

To-do

• More unit and integration testing on the functions
• Check which different Python versions before 3.7 the package can run on.
• Add some basic background introduction on SuperMemo-2 (Like the quality values).
• Look for good practices for designing a package for user experiences.

Change Log

0.0.2 2020-07-05 Refactored feature

• Refactored the supermemo2 algorithm code into a simpler structure, and reduced unnecessary methods in the class.

0.0.1 2020-07-02 Feature release

• Initial Release