Skip to content
GitHub

Automated Analysis

Automated analysis runs the engine on every position in a game and inserts move classifications — inaccuracy, mistake, blunder — directly into the game’s move tree. The results are cached, so subsequent views of the same game are instant.

  1. Open a game on the Board page.
  2. Click the Analyse button in the board toolbar.
  3. Masterboard runs the engine at depth 18 on every position. Analysis runs in the background — you can continue navigating the game or use the rest of the app while it runs.
  4. When complete, move classifications and accuracy percentages appear automatically.

You can analyse multiple games from the Games page without opening each one:

  1. Select one or more games in the Games list (Shift+click or Ctrl+click for multi-select).
  2. Right-click the selection and choose Analyse N games (where N is the number selected).
  3. Analysis runs in the background for each game in turn.

After analysis, each move is classified based on how much it deviates from the engine’s best move:

SymbolNameMeaning
?!InaccuracySmall mistake; better was available
?MistakeSignificant error that changes the evaluation
??BlunderSevere error — a lost advantage, tactic missed, or losing move

For each classified move, Masterboard inserts the engine’s best move as an alternative variation in the move tree, so you can immediately see what you should have played.

After analysis completes, the Notation panel header shows per-player accuracy percentages using the same formula as Lichess (WDL-based). A score of 100% means every move was the engine’s top choice; lower scores reflect how often and how severely you deviated.

Analysis results are stored in the local database. Reopening an analysed game does not re-run the engine — results are shown instantly from the cache. To re-analyse a game (e.g. with a different engine or higher depth), use the Analyse button again; the old annotations are replaced.

Analysis panel showing the evaluation graph, per-player accuracy and ACPL, and inaccuracy/mistake/blunder counts

The Analysis panel is a dedicated workspace panel on the Board page. Add it via the panel toolbar if it is not already visible. After analysis completes it shows:

  • Eval graph — a line chart of the engine evaluation at each move across the full game. Click any point on the graph to navigate to that position on the board.
  • Accuracy — per-player accuracy percentage using the Lichess WDL formula.
  • ACPL — average centipawn loss per player.
  • Move counts — number of inaccuracies, mistakes, and blunders per player. Click a count to jump to the first move of that classification in the game.

A Re-analyse button at the bottom of the panel lets you rerun the engine on the current game.

Running batch analysis on your games feeds several other features beyond the in-game annotations:

  • Personal Statistics — accuracy trends, blunder heatmap, luck rate, and opportunism rate are only computed from analysed games. See Personal Statistics.
  • Personal Tactics — blunder (??) and mistake (?) positions from analysed games become spaced repetition puzzles in your personal tactics pool. See Personal Tactics.
  • Opponent Preparation Report — blunder patterns and luck/opportunism stats in reports require games to be analysed. See Opponent Preparation.