Development of a Software Tool for Interactive Visualization of Poker Range Dynamics

Bakalářská práce se zabývá vývojem softwarového nástroje pro interaktivní vizualizaci dynamiky pokerových rangů ve hře Texas Hold'em. Práce reaguje na mezeru v existujících řešeních: trackerové nástroje se zaměřují na číselné statistiky, ale rangy vizualizují jen okrajově, zatímco solverové platformy pracují s rangy precizně, ale především v teoretickém kontextu. Cílem navrhovaného nástroje je propojit oba přístupy a ukázat, jak se rangy hráčů zužují v průběhu konkrétní odehrané ruky. Aplikace je postavena na třívrstvé architektuře. Parser napsaný v jazyce Python převádí textové soubory hand history ze systému PokerStars do strukturované podoby a ukládá je do relační databáze PostgreSQL. Výpočetní logika nad uloženými daty počítá rangy všech hráčů v jednotlivých okamžicích ruky pomocí rozšířeného line-consistency modelu, který zachycuje čtyři mechanismy zužování rangu: foldování, card removal, frequency-based narrowing při 3bet a 4bet akcích a showdown reveals. Webové rozhraní postavené na frameworku Dash prezentuje výsledky přes 13×13 heatmapu rangu vybraného hráče, křivkový graf zužování rangů všech hráčů u stolu, vizualizaci pokerového stolu a textový log akcí. Při vybraném hrdinovi heatmapa zobrazuje jeho poziční range a zároveň zlatým rámečkem zvýrazňuje buňku reálně držené kombinace, což umožňuje na jediný pohled porovnat reálně odehranou ruku s teoreticky doporučeným rangem pro danou pozici. Funkčnost byla ověřena přes třicet dva testovacích skriptů a čtyři manuální scénáře. Parser dosáhl stoprocentní úspěšnosti na datasetu 565 reálných ruk. Z jedenácti definovaných funkčních a nefunkčních požadavků byly všechny splněny.

This bachelor's thesis focuses on the development of a software tool for the interactive visualization of poker hand rankings in Texas Hold'em. The thesis addresses a gap in existing solutions: tracker tools focus on numerical statistics but visualize ranges only marginally, while solver platforms handle ranges precisely but primarily in a theoretical context. The goal of the proposed tool is to bridge both approaches and show how players’ ranges narrow over the course of a specific hand. The application is built on a three-tier architecture. A parser written in Python converts hand history text files from the PokerStars system into a structured format and stores them in a PostgreSQL relational database. The computational logic applied to the stored data calculates the ranges of all players at specific moments during the hand using an extended line-consistency model, which captures four range-narrowing mechanisms: folding, card removal, frequency-based narrowing during 3-bet and 4-bet actions, and showdown reveals. The web interface, built on the Dash framework, presents the results via a 13×13 heatmap of the selected player’s range, a line graph showing the narrowing of all players’ ranges at the table, a visualization of the poker table, and a text log of actions. For the selected hero, the heatmap displays their positional range and highlights the cell containing the actual hand held with a gold frame, allowing you to compare the actual hand played with the theoretically recommended range for that position at a glance. Functionality was verified using thirty-two test scripts and four manual scenarios. The parser achieved a 100% success rate on a dataset of 565 real hands. All eleven defined functional and non-functional requirements were met.