___ ____   ____  ____       __  __ ____  _
 |_ _| __ ) / ___|/ ___|     |  \/  |  _ \| |
  | ||  _ \| |    \___ \_____| |\/| | |_) | |
  | || |_) | |___  ___) |____| |  | |  __/| |___
 |___|____/ \____||____/     |_|  |_|_|   |_____|

IBCS-style charting and reporting toolkit built on Matplotlib.

Strict focus:

• semantic notation (scenario, variance, impact)
• composable chart primitives and composites
• extension through registry + plugin system

Setup (uv)

uv sync

Or with Make:

make setup

Run tests/lint:

uv run pytest
uv run ruff check

Make shortcuts:

make check
make typecheck
make docs-images

Run an example:

uv run python examples/ex_01_single_column.py

Documentation

• Extending charts: docs/EXTENDING_CHARTS.md

Example Outputs

Single Column

Relative Variance Pins

Grouped Bar + Waterfall

ROA Tree