Skip to content
Glutanimate edited this page Aug 13, 2017 · 1 revision

Features

  • Adds a heatmap graph to Anki's main window, deck overview, and stats screen (each individually toggleable)
  • Color-coded summary of review activity: Hues of green for past reviews, shades of grey for pending reviews
  • Additional stats on review streaks, daily averages, and days learned
  • Tooltips provide extra information on each specific day
  • A number of easy-to-use controls allow you to navigate between different years
  • Clicking on a day will draw up the cards seen on that day in the browser. In case of a future date all cards that are due on that day will be shown instead
  • Going to the overview page of a specific deck will show deck-specific information
  • 5 different color schemes, 2 different calendar modes - all easily configured via an options menu
  • The heatmap is updated in real-time as you review more cards

Configuration

The add-on can be customized through its options menu which can be found under ToolsReview Heatmap Options....

Options

  • Color scheme: Controls the general color scheme of the add-on. Offers 5 different options. Lime is the default.
  • Calendar mode: Governs how the calendar will be displayed. In the default year mode you will be presented with a continuous view of all 365 days in a year. The months mode breaks this up into the months of the year.
  • History limit: Days to look back in the main and deck screen heatmaps. Limited to 365 by default. Setting this to '0' will lift the limit.
  • Forecast limit: Days to look ahead in the main and deck screen heatmaps. Limited to 90 by default. Setting this to '0' will lift the limit.
  • Heatmap display settings: Controls where the heatmap should appear. All three screens are active by default.
  • Show streak stats even if heatmap disabled: Whether or not to show the review streak even if the heatmap display has been disabled for a screen. Active by default as the streak stat calculation and display isn't too process-intensive.

Performance Considerations

Calculating and generating the heatmap is expensive from a performance standpoint. The limits on card history and forecasts should strike a good balance between speed and informativity, but depending on your machine you might still experience a small slowdown when switching betweeen screens. If that's the case, you could try experimenting with limiting these values further, or disabling the heatmap display for the main and deck screens entirely.

For a full overview of your entire review history and pending reviews you can always refer to the stats window heatmap which is controlled by the settings at the bottom of the stats window rather than the add-on limits.

Technical Notes

Interpretation of the graph

What is actually mapped on the heatmap is the number of card repetitions on that particular day, spanning all types of card activity (cards in learning, review cards and even cards that you crammed). The entries in the review log also contain cards that you might have deleted in the meantime. Both of these factors combined explain the disparity you might notice when comparing the noted review count to the listed cards when clicking on a day.

Color legend

The add-on uses a palette of 10 colours to visualize your card review activity. The different shades and hues are arranged around the review average of your entire collection, meaning that they will always scale relative to your review activity. This has the advantage of preventing a monotonous heatmap display for people that have a very high or very low daily average. Even if you were to reach several thousand reviews a day the heatmap should still remain informational as it would scale with your activity.

The exact legend scale looks as follows:

[0.125avg, 0.25avg, 0.5avg, 0.75avg, avg, 1.25avg, 1.5avg, 2avg, 4avg]

where avg is your daily average on learning days across your entire card collection. For consistency's sake, deck-specific heatmaps will also use this scale, rather than one adjusted to the daily average of the deck.

The stats listed below the heatmap use the following legend scales:

  • streaks: 0, 14, 30, 90, 180, 365, >365 days
  • days learned: 0, 25, 50, 60, 70, 80, 85, 90, 95, 99, 100%
  • daily average: follows the heatmap legend

Streaks

Streaks are defined as a continuous pattern of review activity spanning several days. Neither the type of activity nor the intensity are factored in. As long as you review some cards on a day, that day will be counted towards your streak.

Hidden Features

In order to show the cards reviewed on a specific day the add-on adds a new search filter to Anki. This filter can also be used outside of the add-on, e.g. in regular browser searches, and is called in the following way: "seen:days_ago" (e.g. "seen:365").