PubliPlots Documentation

PubliPlots is a Python library for creating publication-ready plots with a clean, modular API. It provides a seaborn-like interface with sensible defaults and extensive customization options.

Python Version License

Features

  • Publication-ready plots: Beautiful, journal-quality visualizations out of the box

  • Seaborn-like API: Familiar, intuitive interface for matplotlib users

  • Extensive customization: Fine-grained control over all visual elements

  • Advanced plot types: Venn diagrams (2-5 way), UpSet plots, bubble plots, and more

  • Flexible styling: Built-in themes for notebook and publication formats

  • Type hints: Full type annotation support for better IDE integration

Quick Start

Installation

Tip

For faster installation, we recommend using uv:

uv pip install publiplots

Or using pip:

pip install publiplots

Basic Usage

import publiplots as pp
import pandas as pd
import numpy as np

# Set notebook style for interactive work
pp.set_notebook_style()

# Create sample data
data = pd.DataFrame({
    'category': ['A', 'B', 'C', 'D'],
    'value': [23, 45, 38, 52]
})

# Create a simple bar plot
fig, ax = pp.barplot(
    data=data,
    x='category',
    y='value',
    title='Simple Bar Plot',
    xlabel='Category',
    ylabel='Value'
)

# Save the figure
pp.savefig(fig, 'output.png')

Table of Contents

Getting Started

Examples Gallery

API Reference

Additional Information

Indices and tables