FAQ

Do I need CoolBox?

No. PlotNado is independent.

Can I use DataFrames instead of files?

Yes. Signal and interval-style tracks support in-memory tabular inputs where applicable. The docs examples use DataFrames so Quarto renders them without external files.

How do I discover all options for a track?

from plotnado import GenomicFigure

GenomicFigure.track_options("bigwig")
GenomicFigure.track_options_markdown("bigwig")

There is no plotnado track-options CLI command.

How should I scale overlays?

Treat the overlay as the unit of scaling:

• Use autoscale_group on the overlay track when it should match neighboring signal panels.
• Use overlay min_value / max_value only when you want to pin that edge deliberately.
• Use separate panels when the signals need independent ranges.

What is the recommended workflow?

Use uv:

uv sync --extra dev --extra docs
uv run pytest tests/
uv run python examples/run_examples.py
uv run plotnado --help

How do I share figure definitions?

Use YAML templates for CLI workflows and TOML when you want to save a Python-built figure.

fig.to_toml("plot.toml")
loaded = GenomicFigure.from_toml("plot.toml")

uv run plotnado init *.bw --auto --output template.yaml
uv run plotnado validate template.yaml