Skip to main content

Database for chess games.

Project description

Description

This package provides a database for chess games.

When playing through a game a list of all games containing the current position is displayed.

Repertoire games can be defined. When playing through a repertoire game a list of all games containing the current position is displayed. Repertoire games are not included in this list.

Chess engines can be used to analyse positions while playing through games or repertoire games. The analysis can be played through like the game score. The analysis can be saved on the database for later reference.

Partial positions can be defined and a list of all games containing a position matching the partial position is displayed.

Games can be typed, or imported from files, in PGN Import Format.

Games are indexed by the seven standard tags defined by the PGN standard.

Games can be edited or deleted.

Games can be output to PGN files in Export Format, Reduced Export Format, or an import format excluding comments and glyphs.

Installation Instructions

This package is available on PyPI so can be installed by typing

python -m pip install –user chesstab

at the command prompt.

See Python and pip documentation for alternatives and platform-specific points.

If this installation replaces ChessTab-4.1.1 or earlier you should run:

python -m chesstab.tools.chesstab-4-1-1_castling-option-correction

to fix the incorrect position and analysis index keys generated for moves Rxa8, Rxh8, Rxa1, and Rxh1, where the captured piece is a rook and neither rook involved in the move, nor either king, has moved previously.

For the 233,765 games in twic920g.zip through twic999g.zip downloaded from https://theweekinchess.com the run takes about two hours.

Chess Engines

Chess engines which support the Universal Chess Interface (UCI) can be used to analyse positions. Wikipedia UCI entry links to the specification too.

Database Interfaces

The default database interface is the sqlite3 module distributed with Python.

The apsw interface, if installed, to Sqlite 3 is used instead of the sqlite3 interface.

New databases are accessed using these alternative interfaces if installed.

Chesstab will use dptdb if installed.

berkeleydb is available for Python 3.6 and later. It is used instead of bsddb3 if both are installed and a version of Berkeley DB supported by berkeleydb is installed.

If bsddb3 is used, a version of Berkeley DB supported by bsddb3 must be installed.

Fonts

The unicode chess pieces are used by default.

The chesstab package incudes the Chess Merida, Chess Cases, Chess Motif, and Chess Lucena fonts by Armando H Marroquin.

These are available from www.enpassant.dk/chess/fonteng.htm and the relevant files have been included in this package for convenience.

Install if you prefer them to the unicode chess pieces.

Run

The command to run this package is:

python -m chesstab.chessgames

You may need to give the path and version of Python depending on your system’s configuration:

<path to python>/python<version> -m chesstab.chessgames

For example

C:\Python36\python -m chesstab.chessgames

on Microsoft Windows or

python3.6 -m chesstab.chessgames

on Unix-like systems.

Or use the facilities of your desktop (Microsoft Windows, GNOME, KDE, …) to set up a convenient way of starting chessgames.

At least one database engine supported by the solentware-base package must be installed.

Notes

A database of about 1.5 million games will occupy between 10 and 15 Gbytes.

Importing 1.5 million games will take at least a few hours. For example about 12 hours on a 1.8GHz CPU with 2Gb 667MHz DDR2 SDRAM, and about 30 hours on a 1.7GHz CPU with 1Gb DDR266 RAM.

These figures were obtained using the Enormous database from:

ftp://ftp.cis.uab.edu/pub/hyatt/pgn.

Partial position searches are always much quicker using the dptdb database interface.

When using the sqlite3, apsw, berkeleydb, bsddb3, or lmdb, database interfaces, you may notice better response times on partial position searches if the bitarray module is installed.

The sqlite3 and apsw database interfaces are equivalent, but all other pairings are incompatible.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chesstab-8.0.2.tar.gz (543.2 kB view details)

Uploaded Source

Built Distribution

chesstab-8.0.2-py3-none-any.whl (639.6 kB view details)

Uploaded Python 3

File details

Details for the file chesstab-8.0.2.tar.gz.

File metadata

  • Download URL: chesstab-8.0.2.tar.gz
  • Upload date:
  • Size: 543.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for chesstab-8.0.2.tar.gz
Algorithm Hash digest
SHA256 8634b6e344e6f308982adc025079b1dd4a838b05ef8482c4d7c68a66a528116b
MD5 7f328fad0dac1ce6ef7d33694862f6ef
BLAKE2b-256 548924cdd58e07da04aee71727eaba20ecfae7e7f091d22bdd8911a8cf9bf31a

See more details on using hashes here.

File details

Details for the file chesstab-8.0.2-py3-none-any.whl.

File metadata

  • Download URL: chesstab-8.0.2-py3-none-any.whl
  • Upload date:
  • Size: 639.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for chesstab-8.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7174bf60ea86c65c30388182d8dc982e4d4b4bbf4abf81ab929f61a6fc7ad48e
MD5 a6bd16af47aa1e7f56d70e1fb56a18e0
BLAKE2b-256 de99d9db77551ed0e1b7042392998a7fd6bdcea2e953483960a4ce5fd75142ff

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page