Skip to main content

Overview

Elo python package to simulate matches between players, and compare their elo ratings after each match, and visualize them. You can use it to simulate rankings of Chess players.

Installation

Install using pip:

$ pip install elo-viz

or with Poetry:

$ poetry add elo-viz

Usage

Create Players

import uuid
from elo_viz import Match, Player

magnus_carlsen = Player(id=uuid.uuid4().hex, name='Magnus Carlsen', rating=2833)
hou_yifan = Player(id=uuid.uuid4().hex, name='Hou Yifan', rating=2633)
gukesh_d = Player(id=uuid.uuid4().hex, name='Gukesh Dommaraju', rating=2777)
divya_d = Player(id=uuid.uuid4().hex, name='Divya Deshmukh', rating=2490)

Setup Matches

m1 = Match(match_id=uuid.uuid4().hex, player1=magnus_carlsen, player2=gukesh_d)
m1.update_result(winner=magnus_carlsen.id)

Check results

print(m1.player1)

Output

Player: Magnus Carlsen Rating: Rating: 2883.0 Win %: 100.0

Requirements

  • Python >= 3.13

The version of the base environment I had installed poetry in.

Will update this so that any Python 3 version will work.

Release files for elo-viz 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for elo-viz 0.0.2
File Size Uploaded
elo_viz-0.0.2.tar.gz 6.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for elo-viz 0.0.2
File Interpreter ABI Platform
elo_viz-0.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 15.0 kB

Release files / elo_viz-0.0.2.tar.gz

Download URL elo_viz-0.0.2.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
935abd8288ffedfa59162ed55fed1e20731a1e6b3b04fc37d100e50d2906ea2d
BLAKE2b-256 checksum
How to use checksums
48ef3c0855783b51ea34e7714d9a473d71fc51733f7bbae49250b43c36ef02fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 6, 2025.

Transparency log

Release files / elo_viz-0.0.2-py3-none-any.whl

Download URL elo_viz-0.0.2-py3-none-any.whl
Size 8.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ee66806422ccab6eb687de98db11f86a6f86d539bb848fc9b5679280d57ceaaf
BLAKE2b-256 checksum
How to use checksums
6953881623de77031f2c74aac36370dd7ea90e271b67384483a7bf343cf0a6ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 6, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page