https://github.com/matejdluhos/dluhoschessengine

A specialized chess engine focusing on determining the attractiveness of mate-in-3 chess positions.
https://github.com/matejdluhos/dluhoschessengine

aesthetic-evaluation algorithms chess-engine csharp data-structures uci-protocol

Last synced: 10 months ago
JSON representation

A specialized chess engine focusing on determining the attractiveness of mate-in-3 chess positions.

• Host: GitHub
• URL: https://github.com/matejdluhos/dluhoschessengine
• Owner: MatejDluhos
• Created: 2025-01-25T15:05:43.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-25T15:18:03.000Z (about 1 year ago)
• Last Synced: 2025-03-23T11:45:35.255Z (about 1 year ago)
• Topics: aesthetic-evaluation, algorithms, chess-engine, csharp, data-structures, uci-protocol
• Language: C#
• Homepage:
• Size: 33.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# EN

## Installation Guide

1. Install the Arena GUI from [playwitharena.de](https://playwitharena.de).

2. Build the program:

   - Open the terminal and navigate to the `engine` folder.

   - Run the command: `dotnet publish`.

3. Install the engine in the GUI:

   - Navigate to `Engine -> Install new engine`.

   - Select the `.exe` file of the engine. The executable can be found in `engine/bin/Debug/net7.0` and is named `Thesis`.

4. The engine should load automatically. If not:

   - Navigate to `Engines -> Load engine` and select `Thesis`.

---

## User Guide

1. **Load a Position**:

   - Navigate to `Position -> Set-up a position -> Load`.

   - Input a FEN string. For convenience, a file with FEN strings is included to test the engine's functionality.

2. **Start Computing**:

   - The engine begins computing after the first move.

   - A message will appear in the lower panel with either:

     - A series of possible paths leading to a mate-in-3, or

     - A notification indicating no paths were found.

   - If the first move was incorrect, the engine will notify you.

3. **Explore the Position**:

   - Play the position with or without using the hint in the lower panel.

   - If a wrong move is made, or you want to explore another path, use the navigation arrows to go back and select another move.

   - When changing moves, it is recommended to select the overwrite option.

4. **Evaluation Output**:

   - After completing the mate-in-3 sequence, you can find the aesthetics evaluation in the `eval.txt` file, located in the same folder as the executable.

5. **Evaluation Details**:

   - If only one path exists, the evaluation includes:

     - A summary table of interesting themes in the sequence.

     - A detailed analysis of each move in the sequence.

   - If multiple paths exist, the evaluation starts with:

     - A table of average aesthetic scores across all paths.

     - A detailed analysis of the main path chosen by the engine.

---

# CZ

## Návod k instalaci

1. Nainstalujte Arena GUI ze stránky [playwitharena.de](https://playwitharena.de).

2. Zkompilujte program:

   - Otevřete terminál a přesuňte se do složky `engine`.

   - Zadejte příkaz: `dotnet publish`.

3. Nainstalujte engine v GUI:

   - Navigujte do `Engine -> Install new engine`.

   - Vyberte `.exe` soubor enginu. Soubor se nachází v `engine/bin/Debug/net7.0` a jmenuje se `Thesis`.

4. Engine by se měl načíst automaticky. Pokud ne:

   - Navigujte do `Engines -> Load engine` a vyberte engine.

---

## Uživatelská příručka

1. **Načtení pozice**:

   - Navigujte do `Position -> Set-up a position -> Load`.

   - Vložte FEN string. Pro pohodlí je přiložen soubor s FEN stringy k testování funkcionality enginu.

2. **Spuštění výpočtu**:

   - Engine začne počítat po provedení prvního tahu.

   - Ve spodním panelu se objeví zpráva obsahující:

     - Všechny možné cesty vedoucí k matu ve třech tazích, nebo

     - Oznámení, že žádná cesta nebyla nalezena.

   - Pokud byl první tah nesprávný, zobrazí se upozornění.

3. **Prozkoumání pozice**:

   - Hrajte pozici s pomocí nebo bez nápovědy ve spodním panelu.

   - Pokud uděláte chybný tah nebo chcete zkusit jinou cestu, použijte navigační šipky k návratu a zvolení jiného tahu.

   - Při změně tahu doporučujeme vybrat možnost přepsání (`overwrite`).

4. **Výstup hodnocení**:

   - Po dokončení sekvence mate-in-3 najdete hodnocení v souboru `eval.txt`, který je generován ve stejné složce jako spustitelný soubor.

5. **Podrobnosti hodnocení**:

   - Pokud existuje pouze jedna cesta, hodnocení obsahuje:

     - Tabulku zajímavých témat v sekvenci.

     - Detailní analýzu jednotlivých tahů sekvence.

   - Pokud existuje více cest, hodnocení obsahuje:

     - Tabulku průměrných estetických skóre pro všechny cesty.

     - Analýzu hlavní cesty zvolené enginem.

---