Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Welcome to Bracketology!

Bracketology logo

The goal of bracketology is to speed up the analysis of NCAA march madness data and help develop algorithms for filling out brackets.

Documentation:

https://bracketology.readthedocs.io/en/latest/

GitHub Repo:

https://github.com/stahl085/bracketology

Issue Tracker:

https://github.com/stahl085/bracketology/issues

Backlog:

https://github.com/stahl085/bracketology/projects/1?fullscreen=true

PyPI:

https://pypi.org/project/bracketology/

Before You Start

Here are the main things you need to know:
  • The main parts of this package are the Bracket objects and simulator functions in the simulators module

  • A Bracket is composed of Team and Game objects

  • Game objects have two Team objects as attributes, and the round number

  • Teams have a name, seed, and dictionary for statistics

  • Simulator functions have 1 argument of type Game, and return the winning Team of that Game

Installation

Install from pip

pip install bracketology

Or download directly from PyPi

Getting Started

Import bracketology and create a bracket from last year.

from bracketology import Bracket, Game, Team

# Create a bracket object from 2019
year = 2019
b19 = Bracket(year)

Tutorial

Inspecting the Bracket Object

Here are three different ways you can inspect the Bracket.

  • Inspect teams in each region (dictionary of actual results)

  • Inspect actual results by round (dictionary)

  • Inspect simulated results by round (list of Team attributes)

Get Teams in each Region

Print out all the teams in each region. The regions attribute is a dictionary with the information of all the teams in each region.

>>> print(b19.regions)
{
    'East': [{'Team': 'Duke', 'Seed': 1},
             {'Team': 'Michigan St', 'Seed': 2},
             {'Team': 'LSU', 'Seed': 3},
             ...],
    'West': [{'Team': 'Gonzaga', 'Seed': 1},
             {'Team': 'Michigan', 'Seed': 2},
             {'Team': 'Texas Tech', 'Seed': 3},
             ...],
    'Midwest': [{'Team': 'North Carolina', 'Seed': 1},
                {'Team': 'Kentucky', 'Seed': 2},
                {'Team': 'Houston', 'Seed': 3},
                ...],
    'South': [{'Team': 'Virginia', 'Seed': 1},
              {'Team': 'Tennessee', 'Seed': 2},
              {'Team': 'Purdue', 'Seed': 3},
              ...]
}

Release files for bracketology 0.0.9-beta

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

Source distribution (sdist)

Source distribution for bracketology 0.0.9-beta
File Size Uploaded
bracketology-0.0.9-beta.tar.gz 29.2 kB Details

Release files / bracketology-0.0.9-beta.tar.gz

Download URL bracketology-0.0.9-beta.tar.gz
Size 29.2 kB
Tags Source
SHA-256 checksum
How to use checksums
50a470a456526166790f12a53e3eb79c3a63402f8a30cd292ca483d9ff625abd
BLAKE2b-256 checksum
How to use checksums
7fb9da1672d106fe4358194187fc00f99b5a4dd2c2ae74e82aa8e88a3881ed4d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.2.0.post20200210 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.6
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