statanim 0.1.9

Why statanim?

Manim is extraordinary at animating mathematics — but when it comes to statistics, you're on your own. Want to show a normal distribution shading its tails as sigma changes? A probability tree that builds itself node by node? A deck of cards dealing out to demonstrate hypergeometric sampling? With vanilla Manim, each of these requires hundreds of lines of low-level geometry code before you even start on the actual statistics.

statanim closes that gap. It gives statistics the same treatment Manim gives mathematics: objects that understand what they represent, animations that carry statistical meaning, and a workflow that stays out of your way so you can focus on the idea you're trying to communicate.

Whether you're building lecture slides, making YouTube explainers, or just trying to build intuition for a concept — statanim lets you go from idea to animation in minutes, not days.

Demo

Sample Space

Classical Probability

Conditional Probability

Hypergeometric Distribution

Birthday Paradox

Installation

Prerequisites

pip install manim

LaTeX is required for formula rendering:

# macOS
brew install mactex-no-gui

# Ubuntu / Debian
sudo apt-get install texlive-full

# Windows: install MiKTeX from https://miktex.org/

Install statanim

pip install statanim

Install from source

git clone https://github.com/rishabhbhartiya/statanim.git
cd statanim
pip install -e .

Verify

from manim import *
from statanim.props.card import Card3D
from statanim.distributions.normal3d import NormalCurve3D
from statanim.core.colors import DARK_THEME

Quick Start

Normal distribution with shaded region

from manim import *
from statanim.distributions.normal3d import NormalCurve3D

class NormalDemo(Scene):
    def construct(self):
        curve = NormalCurve3D(mu=0, sigma=1)

        self.play(Create(curve))
        self.play(FadeIn(curve.shade_region(x_lo=-1, x_hi=1)))
        self.wait(2)

Probability with playing cards

from manim import *
from statanim.props.card import Deck3D, CardFacing, standard_deck

class CardDraw(Scene):
    def construct(self):
        deck = Deck3D(cards=standard_deck(shuffle=True, seed=0),
                      initial_facing=CardFacing.FACE_DOWN)
        deck.move_to(LEFT * 3)
        self.play(FadeIn(deck))
        self.play(deck.deal_one(target=RIGHT * 2, flip=True))
        self.wait(2)

What's Inside

Full class and parameter documentation: API_REFERENCE.md

Camera Orientation Reference

All ThreeDScene subclasses need an explicit camera orientation at the top of construct().

def construct(self):
    self.set_camera_orientation(phi=70*DEGREES, theta=-45*DEGREES)

Use Scene (not ThreeDScene) for 2D content: PDF curves, PMF bars, Venn diagrams, histograms, box plots, probability trees, and hypothesis test plots.

Development Setup

git clone https://github.com/rishabhbhartiya/statanim.git
cd statanim
python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Contributing

Issues and pull requests are welcome at github.com/rishabhbhartiya/statanim.

When adding a new distribution, inherit from BaseDistribution3D, implement pdf/pmf, cdf, mean, variance, and add a scene in scenes/demo_distributions.py.

Acknowledgements

Built on Manim Community. Statistical algorithms from SciPy and NumPy. Inspired by the mathematical animation work of 3Blue1Brown.

License

MIT License. See LICENSE for details.

Author: Rishabh Bhartiya — rishabh.bhartiya.in@gmail.com