Skip to main content

Making chess analytics easy.

Project description

Chess-Analytica: chess analytics made easy

Introduction

Chess-Analytica is a chess library that allows for the simple scraping of data using the chess.com API, and subsequent analysis of that data. Built on top of the python-chess library, Chess-Analytica allows for you to easily scrape all of a given player's past (or current) games, filter the games down, and then analyze them.

.. code:: python

from chess_analytica import Board, ChessDotCom

profile = ChessDotCom.Profile("aronfrish", False)

profile.filterGameType("rapid")

print(len(profile.games)) #720

n = 0
for game in profile.games : #Note: this is still filtered to rapid
if ("resignation" in game.termination) :
    n += 1
print(n) #Note: this will print the number of the player's rapid games that ended in resignation
#334

italian_games = profile.find_games_with_FEN_and_Color("r1bqkbnr/pppp1ppp/2n5/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R", True) #Note: this FEN is the italian game and the target player color is white (because is_white is set to True)
print(len(italian_games)/len(profile.white_games)) #Note: this will print the percentage of rapid games (where the player is white) that the player has played the italian game
#0.013888888888888888

Installing

Download and install the latest release:

::

pip install chess-analytica

Documentation <https://chess-analytica.readthedocs.io/en/latest/>__

  • Examples <https://chess-analytica.readthedocs.io/en/latest/usage.html>_
  • ChessDotCom Class <https://chess-analytica.readthedocs.io/en/latest/chessdotcom.html>_
  • Board Class <https://chess-analytica.readthedocs.io/en/latest/board.html>_

Features

  • Scrape all game info from a given player's profile

  • Simulate games and analyze them

  • Filter games by time control

License

Chess-Analytica is licensed under the MIT License. Check out LICENSE.txt for the full text.

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

chess-analytica-1.1.6.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chess_analytica-1.1.6-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

Details for the file chess-analytica-1.1.6.tar.gz.

File metadata

  • Download URL: chess-analytica-1.1.6.tar.gz
  • Upload date:
  • Size: 11.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.0

File hashes

Hashes for chess-analytica-1.1.6.tar.gz
Algorithm Hash digest
SHA256 4ca28d95de355ba57c8091459184f123218ee27ac2f379e52c89073e2129aa5e
MD5 b7d94d96cd63bb917bff3eaa0dbcf875
BLAKE2b-256 736854bf1e67be834413d82d900fc8ba87c874f41b299523ffa7ef2c194b1ac7

See more details on using hashes here.

File details

Details for the file chess_analytica-1.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for chess_analytica-1.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 83ee7d2aa6f59e829b517804accf23f35cb681f4eda3f7dde82126e05945c069
MD5 049f7806be2ec94e98d276e9c549b3bd
BLAKE2b-256 d0a783a0077da85a66fe2c478bca00785156e26a5242778f5c1ea7556df79a56

See more details on using hashes here.

Supported by

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