sanderland/katrain 1.7

v1.7: The big analysis and sgf features update

on GitHub

A little history and a big thank you

This project was started at the end of last year as a small experiment in making a graphical UI for something, and has since grown to one of the most powerful tools for Go AI analysis. This could not have been done without the support and contributions of many. A big thank you to all them, as well as all the people who contacted me on reddit and discord to send me helpful feedback, kind words and go books. Finally, thanks to all my Github sponsors for their support.
To highlight the effect of some of the major contributors, I've prepared a little history highlighting how the program changed since release.

Major New Features

• You are now free to show any two statistics on the 'top moves', including visits, (change in) win rate, (change in) score.
• The analysis menu now includes several new options:
  • Select a region to search, restricting analysis to this part of the board until cancelled.
    • This is particularly useful for tsumego solving or joseki analysis. See the video below for an example.
    • The old 'local moves' has been removed in favour of this option.
  • Insert moves: this mode allows you to insert moves in-between the current and next move, creating a new variation in which the moves are played out as long as they're legal (skipping over any inserted moves).
    • This is helpful for improving analysis when a certain exchange or life & death situation is ignored by both players for a long time.
  • Play out the game to the end.
    • This can be used as a more vivid way to visualize which territories could end up with each player.
    • Note that you can right-click the generated node and 'un-collapse' it (or press c) to see the entire game.
• Analysis can now be cached in the SGF, causing analysis to be instantly available upon loading with no need for calls to KataGo
  • Note that this uses tags unique to KaTrain, and the resulting files can be >1Mb.
  • If you want to do additional analysis after loading, using the same model file is recommended.
• Support for themes, see here for details.
  • If you make any interesting themes, I would be happy to add them to the repository.

Local Joseki Analysis video

Minor New Features and Changes

• You can now edit player names similarly to changing komi and rules.
• Saving a game no longer uses a default filename, but prompts you for one. Subsequent saves use the same file, unless 'save as' is used.
• Generated comments and player names are now filtered out from loaded SGFs
  • Particularly, loading and saving repeatedly no longer causes analysis comments to duplicate.
  • Note that this only applies to files saved with the current version.
• You can now go back to the last branching point with b.
• You can collapse branches up to the last branching point with c. These collapsed states are also saved in SGF files.
• The policy moves view has been revamped to show the numerical value, and coloured by order of magnitude.
• Minimizing the score graph in analysis mode now expands the move tree.
• You can toggle coordinates on/off with k, thanks to @blamarche.
• You can now go to your previous mistake with shift-n or the backward red arrow.
• Some keyboard shortcuts have been added or changed, see the manual for details.
• Spanish has been removed as a language option as it could not be maintained. If you are interested in contributing, please see these instructions.

Bug fixes and performance improvements

• Rendering has been sped up significantly by caching textures. This should make variations smoother in particular.
• Empty komi values in SGFs no longer cause errors.
• The PL[] tag gets correctly picked up on when loading SGFs with problems.

Installation

• Windows users can simply download and run the KaTrain.exe file attached, or download the .zip file and run the .exe in that (which is slightly faster)
• Linux and MacOS users can install using pip install -U katrain or follow instructions here.
  • Note that the gui framework kivy had a major release recently, and installation on MacOS seems better in particular.

Enjoy the update, and a very happy holidays!