# neozhaoliang/pywonderland

A tour in the wonderland of math with python.

Repository: https://github.com/neozhaoliang/pywonderland
Canonical: https://ross.abutalabs.com/products/pywonderland
Language: Python
License: MIT
License Family: permissive
Topics: fractals, penrose-tilings, polytopes, hopf-fibration, reaction-diffusion, coxeter-groups, hopcroft, domino-shuffling-algorithm, coupling-from-the-past, uniform-spanning-tree, todd-coxeter, uniform-tilings, hyperbolic-tilings, hyperbolic-honeycombs, three-body, visual-complex-analysis
Last push: 2026-02-03T01:27:26+00:00

## Health v2 (maintenance only)
Score: 52/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 65, release rhythm 8, longevity 100
- inputs: {"age_days": 3585, "days_push": 212, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4236, forks 349 (observed 2026-08-28T04:08:39.519898+00:00)

## What it is
A collection of Python scripts that render beautiful images, GIFs, and animations illustrating mathematical objects and algorithms such as Coxeter groups, tilings, fractals, and random sampling algorithms. It is an educational showcase of non-trivial math with simple, self-contained code.

## Use cases
- visualize hyperbolic and uniform tilings in python
- generate gif animations of mazes and cellular automata
- render uniform polytopes with the Todd-Coxeter algorithm
- sample random aztec diamond tilings with domino shuffling
- learn coupling from the past for Markov chain sampling
- draw fractals and reaction-diffusion patterns
- explore Mobius transformations of the hyperbolic disk

## When to choose
- you want ready-made, visually appealing Python examples of advanced math topics
- you are teaching or learning group theory, tilings, or stochastic algorithms
- you need simple dependency-free code for generating math animations

## When to avoid
- you need a production library with a stable API for math computation
- you want a general-purpose plotting or visualization framework
- you need guaranteed correctness or support for the algorithms in production

## Facets
- artifact type: learning-resource
- maturity: active
- function: data-visualization, simulation, graphics, math
- domain: mathematics, education, graphics, tutorials
- platform: python, cross-platform
- tags: fractals, tilings, coxeter-groups, cellular-automata, maze-generation, mathematical-visualization, pov-ray, animations, algorithms

## Member repositories
- neozhaoliang/pywonderland (main) score 52

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:39.519898+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:18.393212+00:00, confidence not recorded.
  - readme: https://github.com/neozhaoliang/pywonderland (fetched 2026-08-28T04:08:39.519898+00:00, sha d435f373de35)
- Data as of 2026-08-30T08:39:29.467469+00:00.