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.5.tar.gz (11.4 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.5-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for chess-analytica-1.1.5.tar.gz
Algorithm Hash digest
SHA256 54d6b99343eeeb26b3f0bf2a2048382d0debab6d19bbfc7c1c5192e33b8fdc3c
MD5 ac4012ea2dfe9d45388628de2cbf3e05
BLAKE2b-256 b7b24b33905733f49442c65f65613bacf59526b320b93754e6f43fe23ac4e7ed

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for chess_analytica-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 bc9db876f0e2510ef2d3cbe7f1dd3717b8bbcd0c21e758aeb170fd099b4c5f13
MD5 1414be967cc4e63af2a2dfd1f5868b00
BLAKE2b-256 f572fceb4690dc9cf1e6e3212fce1ef8b2842de2549c50bdd7f2261a7798f238

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