Update README.md
Browse files
README.md
CHANGED
|
@@ -103,105 +103,3 @@ This model is licensed under **CC BY-NC 4.0** (Attribution-NonCommercial 4.0 Int
|
|
| 103 |
<div align="center">
|
| 104 |
<p>Created by <a href="https://github.com/Rafsan1711">Rafsan1711</a></p>
|
| 105 |
</div>
|
| 106 |
-
```
|
| 107 |
-
|
| 108 |
-
---
|
| 109 |
-
|
| 110 |
-
### 2. Dataset Repository (`chessmate-opening-stats`) - README
|
| 111 |
-
|
| 112 |
-
এটি কপি করে আপনার **Dataset Repository**-র `README.md` ফাইলে পেস্ট করুন।
|
| 113 |
-
|
| 114 |
-
```markdown
|
| 115 |
-
---
|
| 116 |
-
license: cc-by-nc-4.0
|
| 117 |
-
task_categories:
|
| 118 |
-
- reinforcement-learning
|
| 119 |
-
- tabular-classification
|
| 120 |
-
language:
|
| 121 |
-
- en
|
| 122 |
-
tags:
|
| 123 |
-
- chess
|
| 124 |
-
- opening
|
| 125 |
-
- statistics
|
| 126 |
-
- game-ai
|
| 127 |
-
size_categories:
|
| 128 |
-
- 1M<n<10M
|
| 129 |
-
pretty_name: ChessMate Opening Statistics
|
| 130 |
-
---
|
| 131 |
-
|
| 132 |
-
# ♟️ ChessMate AI - Opening Statistics Database
|
| 133 |
-
|
| 134 |
-
<div align="center">
|
| 135 |
-
|
| 136 |
-

|
| 137 |
-
|
| 138 |
-
[](https://creativecommons.org/licenses/by-nc/4.0/)
|
| 139 |
-

|
| 140 |
-

|
| 141 |
-
|
| 142 |
-
[**Live Explorer**](https://chessmate-engine.onrender.com) • [**GitHub Repository**](https://github.com/Rafsan1711/Chessmate-Engine)
|
| 143 |
-
|
| 144 |
-
</div>
|
| 145 |
-
|
| 146 |
-
## 📖 Dataset Description
|
| 147 |
-
|
| 148 |
-
This dataset contains aggregated opening statistics derived from over **100,000 high-rated Lichess games** (ELO 2000+). It maps chess board positions (FEN) to their historical outcomes (White Win, Draw, Black Win).
|
| 149 |
-
|
| 150 |
-
It is designed to power the **ChessMate AI Opening Explorer** and serve as an opening book for the engine.
|
| 151 |
-
|
| 152 |
-
- **Source:** Lichess Standard Rated Games (Feb 2016).
|
| 153 |
-
- **Format:** SQLite Database (`.db`).
|
| 154 |
-
- **Optimization:** Indexed by FEN for O(1) lookup speed.
|
| 155 |
-
|
| 156 |
-
## 📂 File Structure
|
| 157 |
-
|
| 158 |
-
The main file is `chess_stats.db`, which contains a single table:
|
| 159 |
-
|
| 160 |
-
### Table: `positions`
|
| 161 |
-
|
| 162 |
-
| Column | Type | Description |
|
| 163 |
-
|--------|------|-------------|
|
| 164 |
-
| `fen` | TEXT (PK) | The board position in Forsyth–Edwards Notation (Primary Key). |
|
| 165 |
-
| `stats` | TEXT | JSON string containing move counts and win rates. |
|
| 166 |
-
|
| 167 |
-
**Example JSON in `stats` column:**
|
| 168 |
-
```json
|
| 169 |
-
{
|
| 170 |
-
"total": 520,
|
| 171 |
-
"moves": {
|
| 172 |
-
"e4": { "white": 200, "black": 150, "draw": 170 },
|
| 173 |
-
"d4": { "white": 100, "black": 80, "draw": 20 }
|
| 174 |
-
}
|
| 175 |
-
}
|
| 176 |
-
```
|
| 177 |
-
|
| 178 |
-
## 🛠️ Usage (Node.js / Better-SQLite3)
|
| 179 |
-
|
| 180 |
-
This database is designed to be streamed or downloaded by a backend service.
|
| 181 |
-
|
| 182 |
-
```javascript
|
| 183 |
-
const Database = require('better-sqlite3');
|
| 184 |
-
const db = new Database('chess_stats.db', { readonly: true });
|
| 185 |
-
|
| 186 |
-
const fen = "rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR";
|
| 187 |
-
const row = db.prepare('SELECT stats FROM positions WHERE fen = ?').get(fen);
|
| 188 |
-
|
| 189 |
-
if (row) {
|
| 190 |
-
console.log(JSON.parse(row.stats));
|
| 191 |
-
}
|
| 192 |
-
```
|
| 193 |
-
|
| 194 |
-
## ⚠️ License
|
| 195 |
-
|
| 196 |
-
This dataset is licensed under **CC BY-NC 4.0** (Attribution-NonCommercial 4.0 International).
|
| 197 |
-
|
| 198 |
-
**You are free to:**
|
| 199 |
-
- Use this data for research, education, and personal projects.
|
| 200 |
-
|
| 201 |
-
**You may NOT:**
|
| 202 |
-
- Sell this data or use it in a commercial product without permission.
|
| 203 |
-
|
| 204 |
-
---
|
| 205 |
-
<div align="center">
|
| 206 |
-
<p>Created by <a href="https://github.com/Rafsan1711">Rafsan1711</a></p>
|
| 207 |
-
</div>
|
|
|
|
| 103 |
<div align="center">
|
| 104 |
<p>Created by <a href="https://github.com/Rafsan1711">Rafsan1711</a></p>
|
| 105 |
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|