Welcome to plottable’s documentation!

Beautiful Tables in Matplotlib

plottable is a Python library for plotting beautiful, presentation ready tables in Matplotlib.

Quick start

Installation

pip install plottable

A Basic Example

import matplotlib.pyplot as plt
import numpy as np
import pandas as pd

from plottable import Table

d = pd.DataFrame(np.random.random((10, 5)), columns=["A", "B", "C", "D", "E"]).round(2)
fig, ax = plt.subplots(figsize=(5, 8))
tab = Table(d)

plt.show()

Women’s World Cup Example

You can access the WWC Example Notebook here

Customizing a Table

1. By supplying keywords to the Table

2. Providing a ColumnDefinition for each column you want to style

3. Accessing a tables rows or columns

Contributing

Contributors are very welcome to this project.

Please take a look at the Contributor Guide

Credits

plottable is built for the lack of good table packages in the python ecosystem. It draws inspiration from R packages gt and reactable, from blog posts about creating tables in matplotlib Tim Bayer: How to create custom tables and Son of a corner: Beautiful Tables in Matplotlib, a Tutorial and from matplotlibs own table module.

Documentation:

• Styling a Table
  • Column Definitions
  • Textprops
  • Cell Keywords
  • Row Divider Lines
  • Column Border Keywords
  • Row Colors
• Using ColumnDefinition
  • Setting Column Titles
  • Setting Column Widths
  • Setting Column Textprops
  • Providing a Text Formatter
  • Providing a cmap function
  • Providing a text_cmap function
  • Providing a group argument
  • Providing a plot function
  • Providing a border argument
• Plotting onto Column Cells
  • Creating Custom Plot Functions
  • Available Plots
  • percentile_bars
  • image
  • circled_image
  • circled_image with border
  • bar
  • bar with value annotation and linecolor
  • percentile_stars
  • progress_donut
• Using ColorMaps
• Using Text Formatters
  • Creating your own formatters
  • Builtin String Formatters
• Using Font ColorMaps
  • Auto-Coloring of text
• Accessing Rows and Columns

Example Notebooks:

• Basic Example
  • Alternating Row Colors
• Women’s World Cup Example
• Bohndesliga Table Style
  • Imports
  • Getting the data
  • Data Processing
  • Building the Bohndesliga Table
• Plots Example
  • Table Example with plots
• Heatmap Example

Development:

• Contributor Guide
  • Code Formatting
• Changelog
• 0.1.5
• 0.1.4
• 0.1.3
• 0.1.2
  • Fixed
  • Documentation

Contents:

• plottable
  • plottable package
    • Submodules
    • plottable.cell module
    • plottable.cmap module
    • plottable.column_def module
    • plottable.font module
    • plottable.formatters module
    • plottable.helpers module
    • plottable.plots module
    • plottable.table module
    • Module contents

Indices and tables

• Index

• Module Index

• Search Page