.. MarkovPy documentation master file, created by
   sphinx-quickstart on Sun Feb  1 17:21:28 2026.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

MarkovPy
======================

A lightweight Python library for working with discrete-time Markov chains,
with a focus on clarity, mathematical correctness, and inspectable algorithms.

The project provides:
- A core ``Chain`` class for representing Markov chains
- Algorithms for simulation, reachability, and state analysis
- A small, well-documented API aimed at learning and experimentation

If you are coming from a mathematical background, the documentation is written
to closely mirror standard notation while remaining idiomatic Python.

.. toctree::
   :maxdepth: 2
   :caption: User Guide

   source/overview
   source/quickstart

.. toctree::
   :maxdepth: 2
   :caption: API Reference

   source/modules