# yzyray/lizzieyzy architecture

> Architecture diagram of the GitHub repository yzyray/lizzieyzy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yzyray/lizzieyzy
- Repository: https://github.com/yzyray/lizzieyzy
- Video tour (about a minute): https://gitdiagram.com/yzyray/lizzieyzy/video

## Overview

LizzieYzy is a desktop Go GUI for reviewing and playing Go games with GTP engines. The main workflow is to open or play a game, maintain its board and variation history, request engine analysis, and inspect the resulting suggestions and win-rate information in the GUI. README-documented extensions include batch/flash analysis, engine-vs-engine games, territory estimation, tsumego, board synchronization, and visualized KataGo distributed training. Those capability nodes are retained, but unsampled implementation links are dashed or omitted; relationships among sampled components are based on the supplied source index and excerpts.

Main entry points: [`src/main/java/featurecat/lizzie/analysis/Leelaz.java`](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/Leelaz.java) (GTP engines), [`src/main/java/featurecat/lizzie/rules/Board.java`](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/Board.java) (Go board), [`src/main/java/featurecat/lizzie/gui/LizzieFrame.java`](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/LizzieFrame.java) (Main window), [`src/main/java/featurecat/lizzie/analysis/EngineManager.java`](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java) (Engine manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and GUI"]
  node_lizzie["Application startup<br/>[Lizzie.java]"]
  node_config["Configuration<br/>[Config.java]"]
  node_frame["Main window<br/>[LizzieFrame.java]"]
  node_menu["Menus and actions<br/>[Menu.java]"]
  node_engineconfig["Engine setup<br/>[MoreEngines.java]"]
end

subgraph group_game["Game and SGF"]
  node_board["Go board<br/>[Board.java]"]
  node_history["Variation history"]
  node_sgf["SGF import/export<br/>[SGFParser.java]"]
end

subgraph group_engines["Engine analysis"]
  node_manager["Engine manager<br/>[EngineManager.java]"]
  node_gtp["GTP engines<br/>[Leelaz.java]"]
  node_move["Analysis results<br/>[MoveData.java]"]
end

subgraph group_features["Analysis features"]
  node_hawk["Hawk Eye review<br/>[AnalysisFrame.java]"]
  node_flash["Flash analysis"]
  node_batch["Batch analysis"]
  node_estimate["Territory estimate<br/>[KataEstimate.java]"]
  node_enginegame["Engine matches<br/>[EngineManager.java]"]
  node_tsumego["Tsumego analysis"]
  node_sync["Board synchronization<br/>[ReadBoard.java]"]
  node_training["KataGo training viewer"]
end

node_user(("Go player"))
node_engine{{"External GTP engine"}}

node_user -.->|"uses"| node_frame
node_lizzie -->|"loads"| node_config
node_lizzie -->|"starts"| node_frame
node_menu -.->|"configures"| node_frame
node_frame -.->|"displays"| node_board
node_board -.->|"maintains"| node_history
node_sgf -->|"loads moves"| node_board
node_frame -->|"saves game"| node_sgf
node_engineconfig -->|"sets engines"| node_manager
node_manager -->|"manages"| node_gtp
node_gtp -.->|"sends GTP"| node_engine
node_gtp -->|"updates analysis"| node_board
node_manager -->|"runs matches"| node_enginegame
node_manager -->|"uses game records"| node_sgf
node_hawk -.->|"reviews moves"| node_history
node_flash -->|"analyzes games"| node_gtp
node_batch -.->|"supports batch"| node_flash
node_estimate -.->|"requests estimate"| node_gtp
node_tsumego -.->|"captures position"| node_board
node_sync -.->|"synchronizes moves"| node_board
node_training -.->|"visualizes training"| node_engine
node_gtp -.->|"produces suggestions"| node_move

click node_lizzie "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/Lizzie.java"
click node_config "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/Config.java"
click node_frame "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/LizzieFrame.java"
click node_menu "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/Menu.java"
click node_board "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/Board.java"
click node_history "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/BoardHistoryNode.java"
click node_sgf "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/SGFParser.java"
click node_manager "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java"
click node_gtp "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/Leelaz.java"
click node_move "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/MoveData.java"
click node_engineconfig "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/MoreEngines.java"
click node_hawk "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/AnalysisFrame.java"
click node_flash "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/AnalysisEngine.java"
click node_batch "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/BatchShareFrame.java"
click node_estimate "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/KataEstimate.java"
click node_enginegame "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java"
click node_tsumego "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/CaptureTsumeGo.java"
click node_sync "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/ReadBoard.java"
click node_training "https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/ContributeView.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lizzie,node_config,node_frame,node_menu,node_engineconfig toneBlue
class node_board,node_history,node_sgf toneAmber
class node_manager,node_gtp,node_move toneMint
class node_hawk,node_flash,node_batch,node_estimate,node_enginegame,node_tsumego,node_sync,node_training toneRose
class node_user,node_engine toneIndigo
```

## Components

### Application and GUI

- [Application startup](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/Lizzie.java): `src/main/java/featurecat/lizzie/Lizzie.java`
- [Configuration](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/Config.java): `src/main/java/featurecat/lizzie/Config.java`
- [Main window](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/LizzieFrame.java): `src/main/java/featurecat/lizzie/gui/LizzieFrame.java`
- [Menus and actions](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/Menu.java): `src/main/java/featurecat/lizzie/gui/Menu.java`
- [Engine setup](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/MoreEngines.java): `src/main/java/featurecat/lizzie/gui/MoreEngines.java`

### Game and SGF

- [Go board](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/Board.java): `src/main/java/featurecat/lizzie/rules/Board.java`
- [Variation history](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/BoardHistoryNode.java): `src/main/java/featurecat/lizzie/rules/BoardHistoryNode.java`
- [SGF import/export](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/rules/SGFParser.java): `src/main/java/featurecat/lizzie/rules/SGFParser.java`

### Engine analysis

- [Engine manager](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java): `src/main/java/featurecat/lizzie/analysis/EngineManager.java`
- [GTP engines](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/Leelaz.java): `src/main/java/featurecat/lizzie/analysis/Leelaz.java`
- [Analysis results](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/MoveData.java): `src/main/java/featurecat/lizzie/analysis/MoveData.java`

### Analysis features

- [Hawk Eye review](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/AnalysisFrame.java): `src/main/java/featurecat/lizzie/gui/AnalysisFrame.java`
- [Flash analysis](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/AnalysisEngine.java): `src/main/java/featurecat/lizzie/analysis/AnalysisEngine.java`
- [Batch analysis](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/BatchShareFrame.java): `src/main/java/featurecat/lizzie/gui/BatchShareFrame.java`
- [Territory estimate](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/KataEstimate.java): `src/main/java/featurecat/lizzie/analysis/KataEstimate.java`
- [Engine matches](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java): `src/main/java/featurecat/lizzie/analysis/EngineManager.java`
- [Tsumego analysis](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/CaptureTsumeGo.java): `src/main/java/featurecat/lizzie/analysis/CaptureTsumeGo.java`
- [Board synchronization](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/analysis/ReadBoard.java): `src/main/java/featurecat/lizzie/analysis/ReadBoard.java`
- [KataGo training viewer](https://github.com/yzyray/lizzieyzy/blob/main/src/main/java/featurecat/lizzie/gui/ContributeView.java): `src/main/java/featurecat/lizzie/gui/ContributeView.java`

### Other components

- **Go player**
- **External GTP engine**

## Connections

- Go player → Main window: uses
- Application startup → Configuration: loads (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Application startup → Main window: starts (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Menus and actions → Main window: configures (evidence: `src/main/java/featurecat/lizzie/gui/LizzieFrame.java`)
- Main window → Go board: displays (evidence: `src/main/java/featurecat/lizzie/gui/LizzieFrame.java`)
- Go board → Variation history: maintains (evidence: `src/main/java/featurecat/lizzie/rules/Board.java`)
- SGF import/export → Go board: loads moves (evidence: `src/main/java/featurecat/lizzie/rules/SGFParser.java`)
- Main window → SGF import/export: saves game (evidence: `src/main/java/featurecat/lizzie/gui/LizzieFrame.java`)
- Engine setup → Engine manager: sets engines (evidence: `src/main/java/featurecat/lizzie/gui/SetKataEngines.java`)
- Engine manager → GTP engines: manages (evidence: `src/main/java/featurecat/lizzie/analysis/EngineManager.java`)
- GTP engines → External GTP engine: sends GTP
- GTP engines → Go board: updates analysis (evidence: `src/main/java/featurecat/lizzie/analysis/Leelaz.java`)
- Engine manager → Engine matches: runs matches (evidence: `src/main/java/featurecat/lizzie/analysis/EngineManager.java`)
- Engine manager → SGF import/export: uses game records (evidence: `src/main/java/featurecat/lizzie/analysis/EngineManager.java`)
- Hawk Eye review → Variation history: reviews moves
- Flash analysis → GTP engines: analyzes games (evidence: `src/main/java/featurecat/lizzie/analysis/AnalysisEngine.java`)
- Batch analysis → Flash analysis: supports batch
- Territory estimate → GTP engines: requests estimate
- Tsumego analysis → Go board: captures position
- Board synchronization → Go board: synchronizes moves
- KataGo training viewer → External GTP engine: visualizes training
- GTP engines → Analysis results: produces suggestions (evidence: `src/main/java/featurecat/lizzie/analysis/Leelaz.java`)
