Sunmao

A matplotlib layout library inspired by traditional Chinese mortise-tenon (榫卯) joinery. Attach panels in any direction, get a standard ax, use any plotting library.

Install

pip install sunmao

Quick Start

from sunmao import create
import numpy as np

fig, root = create(figsize=(10, 8))

top   = root.tenon('top',   size=2)    # 2-inch tall panel above root
right = root.tenon('right', size=3)    # 3-inch wide panel to the right

x = np.linspace(0, 10, 100)
root.ax.plot(x, np.sin(x))
top.ax.bar(range(8), np.random.rand(8))
right.ax.scatter(np.random.randn(50), np.random.randn(50))

fig.savefig('out.png', bbox_inches='tight')

Three things to know:

1. create(figsize=...) → (fig, root), same pattern as plt.subplots
2. root.tenon(pos, size) → new panel; size is in inches
3. .ax → standard matplotlib.axes.Axes, works with any library

Layout Model

figsize = (10, 8)

┌─────────────────────────────────┐
│           top  (size=2)         │
├──────────────────────┬──────────┤
│                      │  right   │
│       root           │ (size=3) │
│                      │          │
└──────────────────────┴──────────┘

size is always in inches — no percentages, no ratios. If you want a panel that is 25% of figure height: size = figsize[1] * 0.25.

Nesting

Any panel can have its own children:

fig, root = create(figsize=(12, 8))

top       = root.tenon('top',  size=3)
top_left  = top.tenon('left',  size=3)   # child of top
top_right = top.tenon('right', size=3)   # child of top

Third-Party Integration

import seaborn as sns
import scanpy as sc

fig, root = create(figsize=(12, 8))
right = root.tenon('right', size=4)

sc.pl.umap(adata, ax=root.ax, show=False)
sns.violinplot(data=df, ax=right.ax)

fig.savefig('out.png', bbox_inches='tight')

trackc (genome browser)

import trackc.pl as pl
from sunmao import create

fig, scale = create(figsize=(12, 9))
signal = scale.tenon('top', size=1.5, pad=0.05)
genes  = scale.tenon('top', size=1.5, pad=0.05)
hic    = scale.tenon('top', size=3.0, pad=0.05)

region = 'chr18:47950000-48280000'
pl.bw_track(bw='signal.bw', ax=signal.ax, regions=region)
pl.gene_track(ax=genes.ax,  bed12='genes.bed12', regions=region)
pl.mapC(mat=hic_mat,         ax=hic.ax)
pl.scale_track(ax=scale.ax,  region=region)

fig.savefig('genome_browser.png', bbox_inches='tight')

Documentation

• Usage Guide — full API reference and examples
• Gallery — visual examples with code

Gallery Preview

Basic layout	Nested panels

Genome browser	seaborn / scanpy

ComplexHeatmap style	OncoPrint style

Multi-omics integration

License

MIT