Skip to main content

Framework-agnostic plotting utilities for biological and clinical data visualization

Project description

bioviz-kit

Framework-agnostic visualization library for publication-ready clinical and biological data plots.

License: MIT Python 3.11+

Features

  • Publication-ready styling – Clean, professional visualizations out of the box
  • Framework-agnostic – Works with any data pipeline or analysis framework
  • Customizable configurations – Extensive theming and layout options
  • Clinical & bioinformatics focused – Specialized plot types for common analyses

Installation

bioviz-kit

Framework-agnostic visualization library for publication-ready clinical and biological data plots.

License: MIT Python 3.11+

Features

  • Publication-ready styling – Clean, professional visualizations out of the box
  • Framework-agnostic – Works with any data pipeline or analysis framework
  • Customizable configurations – Extensive theming and layout options
  • Clinical & bioinformatics focused – Specialized plot types for common analyses

Installation

Install from PyPI:

pip install bioviz-kit

Or install in development mode:

pip install -e .

Requirements

  • Python 3.11+
  • pandas
  • matplotlib
  • seaborn
  • adjustText

Usage

from bioviz import lineplot, oncoplot

# Generate styled plots with minimal configuration
fig = lineplot.generate_styled_lineplot(df, config)
fig = oncoplot.generate_styled_oncoplot(df, config)

See examples/ for complete usage examples.

Examples

  • Example files live in the examples/ directory. Recommended practices:
    • Keep runnable .py scripts for quick CLI usage and reproducible examples.
    • Provide companion .ipynb notebooks for narrative tutorials and figures. Convert with jupytext or nbconvert if needed:
pip install jupytext
jupytext --to notebook examples/my_example.py -o examples/my_example.ipynb
- Name files with short, descriptive snake_case (optionally numeric prefixes for ordered tutorials, e.g. `01_quickstart.ipynb`).
- Add a short header comment or top-level README in `examples/` describing each example's purpose and required inputs.

Documentation and ReadTheDocs

TBD

Design Philosophy

  • Lightweight DefaultStyle provided; easily extended with custom themes

Licensing

  • bioviz-kit is released under the MIT License © 2025 Victoria Cheung.

Thanks

This package was spun out of internal tooling I wrote at Revolution Medicines. Many thanks to the team there for allowing the code to be open sourced.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bioviz_kit-0.3.0.tar.gz (81.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bioviz_kit-0.3.0-py3-none-any.whl (87.7 kB view details)

Uploaded Python 3

File details

Details for the file bioviz_kit-0.3.0.tar.gz.

File metadata

  • Download URL: bioviz_kit-0.3.0.tar.gz
  • Upload date:
  • Size: 81.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.11

File hashes

Hashes for bioviz_kit-0.3.0.tar.gz
Algorithm Hash digest
SHA256 14a438f7e2d3f7bab448f66fad29ac8ab519b169eafb914d880b029cc020de6d
MD5 37b81267473293418b662aec56854b80
BLAKE2b-256 6abe8479ee3cb87bb96a6ae00d6aab5bdd68fe054a773e6810fbf5b368c34229

See more details on using hashes here.

File details

Details for the file bioviz_kit-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: bioviz_kit-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 87.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.11

File hashes

Hashes for bioviz_kit-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 288cee1a911c3af249efc83e889df8d22e2b5f8fc6b6e344e37bea42875591ec
MD5 8b12e0039e1fa1baf90ba34195416193
BLAKE2b-256 3c5b5beaaff8e9927abd29999899ba7dbb0cea664cfb810de3ab83f872df013c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page