Setup and notebooks

Local installation

git clone https://github.com/mbilal-OU/plotly-interactive-omics.git
cd plotly-interactive-omics
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .[dev,notebooks]
jupyter lab

On Windows PowerShell, activate with:

.venv\Scripts\Activate.ps1

Rebuild everything

python scripts/generate_datasets.py
python scripts/build_notebooks.py
python scripts/build_gallery.py --html-only
MPLBACKEND=Agg python scripts/build_previews.py
python -m pytest
python -m mkdocs build --strict

Plotly HTML export does not require a browser. PNG export through Kaleido requires a compatible Chrome or Chromium installation. The repository also includes a deterministic static-preview renderer for restricted CI and teaching environments.

Export choices

Format	Use
HTML	Hover, zoom, selection, animation, and sharing as a self-contained artifact
PNG	README previews, slides, and rapid review
SVG/PDF	Vector editing and print workflows when the figure type supports it
JSON	Auditing or reconstructing the exact Plotly figure specification