Skip to main content

Tichu is a 4-player trick-taking game where you play with a partner and wager on whether or not you will go out first. It is not an exceptionally complicated game, but it does present a number of interesting strategic decisions for players to make.

In an effort to better understand and inform some of these decisions, tich_me downloads game data from thousands of games played on BrettSpielWelt and provides tools to analyze this data. This allows your decision-making to be guided by quantitative information, rather than by intuition.

https://img.shields.io/pypi/v/tich_me.svg https://img.shields.io/pypi/pyversions/tich_me.svg https://img.shields.io/travis/kalekundert/tich_me.svg https://img.shields.io/coveralls/kalekundert/tich_me.svg

Installation

Install using pip:

pip install tich_me

You can confirm that the installation succeeded by running this command:

tich_me -h

Usage

The first step is to download Tichu game logs from BrettSpielWelt and to extract the relevant information into a local database:

tich_me download

Note that game logs are downloaded by month. The default month is the most recent one for which no games have been downloaded yet, but it is also possible to specify a particular month.

Once this is done, the analysis scripts can be run. The only analysis currently available looks at the probability of being passed particular cards, conditional on calling Grand Tichu:

tich_me analyze passing

This produces the following results:

https://github.com/kalekundert/tich_me/raw/master/analysis/passing_probs.svg?sanitize=true

The probability of being passed each rank of card in any given round. The blue bars are if you did not call Tichu or Grand Tichu before the pass, and the orange plus-marks are if you called Grand Tichu.

https://github.com/kalekundert/tich_me/raw/master/analysis/passing_probs_by_giver.svg?sanitize=true

As above, but separated by who is passing the card to you: your left opponent, your partner, or your right opponent. Note that the convention of passing odds to the left and evens to the right can clearly be seen.

A broad rule of thumb is that your probability of being passed a 2 is about ½, a 3 is about ⅓, a 4 is about ¼, and so on all the way up to 10. If you call Grand Tichu, you are very likely to receive an Ace from your partner and the dog from your opponent. But your are no more likely than usual to receive 2’s or 3’s from your opponents, which surprised me a bit.

Contributing

If you are interested in studying a particular aspect of Tichu strategy, consider using tich_me to do your analysis. The hard work of downloading, parsing, and organizing game data is already done, so you can start doing your analysis right away. And if you do implement a new analysis, please consider making a pull request! Bug reports are also very welcome.

Metadata

Release files for tich-me 0.1.3

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

Source distribution (sdist)

Source distribution for tich-me 0.1.3
File Size Uploaded
tich_me-0.1.3.tar.gz 129.9 kB Details

Release files / tich_me-0.1.3.tar.gz

Download URL tich_me-0.1.3.tar.gz
Size 129.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3b3ca6fa9234044c98cbf6fc7f89eed71a15f8dd5ebae87b051bd285a794e703
BLAKE2b-256 checksum
How to use checksums
e9693a9398f92700dde4eaf46264e6ed2646872e651ab95509181b3bf62734ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release history Release notifications | RSS feed

This release

0.1.3 This release

1 release file

0.1.2

1 release file

0.0.0

1 release file

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