Creating presentation quality tables is difficult. It is hard to left-align text and right-align numbers using pandas display or df.to_html. The great_tables package does a really nice job with pandas and polars dataframes but does not support indexes or TeX output.

This package provides consistent HTML and TeX table output with flexible type-based formatting, and table rules. Neither output relies on the pandas to_html or to_latex functions. TeX output uses Tikz tables for very tight control over layout and grid lines. The package is designed for use in Jupyter Lab notebooks Quarto documents.

Usage: the main class GT should be subclassed to set appropriate defaults for your project. sGT provides an example.

The project is currently in beta status. HTML output is better developed than TeX.

The Name

Obviously, the name is a play on the great_tables package. But, I have been maintaining a set of macros called GREATools (generalized, reusable, extensible actuarial tools) in VBA and Python since the late 1990s, and call all my macro packages "GREAT".

Documentation

Available on readthedocs.

Installation

pip install greater-tables

Examples

The following example shows quite a hard table. It is formatted using the sGT class, which is a subclass of GT with a few defaults set.

import pandas as pd
import numpy as np
from greater_tables import sGT
level_1 = ["Group A", "Group A", "Group B", "Group B", 'Group C']
level_2 = ['Sub 1', 'Sub 2', 'Sub 2', 'Sub 3', 'Sub 3']

multi_index = pd.MultiIndex.from_arrays([level_1, level_2])

start = pd.Timestamp.today().normalize()  # Today's date, normalized to midnight
end = pd.Timestamp(f"{start.year}-12-31")  # End of the year

hard = pd.DataFrame(
{'x': np.arange(2020, 2025, dtype=int), 
'a': np.array((100, 105, 2000, 2025, 100000), dtype=int),
'b': 10. ** np.linspace(-9, 9, 5),
'c': np.linspace(601, 4000, 5),
'd': pd.date_range(start=start, end=end, periods=5),
'e': 'once upon a time, risk is hard to define, not in Kansas anymore, neutrinos are hard to detect,  $\\int_\\infty^\\infty e^{-x^2/2}dx$ is a hard integral'.split(',')
}).set_index('x')
hard.columns = multi_index
sGT(hard, 'A hard table.')

$TeX output.$

The output illustrates:

Quarto or Jupyter automatically the class's _repr_html_ method (or _repr_latex_ for pdf/TeX/Beamer output), providing seamless integration across different output formats.
Text is left-aligned, numbers are right-aligned.
The index is displayed, was detected as likely years, and formatted without a comma separator.
The first column of integers does have a comma thousands separator.
The second column of floats spans several orders of magnitude and is formatted using Engineering format, n for nano through G for giga.
The third column of floats is formatted with a comma separator and two decimals, based on the average absolute value.
The fourth column of date times is formatted as ISO standard dates (not date times).
The vertical lines separate the levels of the column multiindex. The subgroups are a little tricky.

More coming soon.

History

3.2.0

Added more tex snippets!
Refactored tikz and column width behavior

3.1.0

adjustments for auto format
rearranged gtcore order of methods

3.0.0

config files / pydantic config input
unified col width and info dataframe
de-texing
cli for config and writeout a csv etc.
testdf suite
Automated TeX to SVG

2.0.0

v2.0.0 solid release old-style, all-argument GT
Better column widths
Custom text output
Rich table output 1.1.1

Added logo, updated docs.

1.1.0

added formatters argument to pass in column specific formatters by name as a number (n converts to {x:.nf}, format string, or function
Added ```tabs`` argument to provide column widths
Added equal argument to provide hint that column widths should all be equal
Added caption_align='center' argument to set the caption alignment
Added large_ok=False argument, if False providing a dataframe with more than 100 rows throws an error. This function is expensive and is designed for small frames.

1.0.0

Allow input via list of lists, or markdown table
Specify overall float format for whole table
Specify column alingment with 'llrc' style string
show_index option
Added more tests
Docs updated
Set tabs for width; use of width in HTML format.

0.6.0

Initial release

Early development

0.1.0 - 0.5.0: Early development
tikz code from great.pres_manager

📁 Project Layout

greater_tables_project/
|   LICENSE
|   pyproject.toml
|   README.md
|   
+---dist
|       
+---docs
|   |   books.bib
|   |   conf.py
|   |   greater_tables.data.rst
|   |   greater_tables.rst
|   |   index.rst
|   |   library.bib
|   |   make.bat
|   |   Makefile
|   |   modules.rst
|   |   start-server.bat
|   |   style.csl
|   |   
+---greater_tables
|   |   __init__.py
|   |   cli.py
|   |   gtconfig.py
|   |   gtcore.py
|   |   gtenums.py
|   |   gtformats.py
|   |   hasher.py
|   |   testdf.py
|   |   tex_svg.py
|   |   
|   +---data
|   |   |   __init__.py
|   |   |   tex_list.csv
|   |   |   tex_list.py
|   |   |   words-12.md
|           
+---greater_tables.egg-info
|       
+---img
|       hard-html.png
|       hard-tex.png

🧠 Design Principles You’re Following

Principle	Your Approach
Immutability	`GT(df, config)` is fixed once created
Separation of concerns	`GTConfigModel` holds defaults/types
Config as code/documentation	`config_template.yaml` generated from model
CLI-first mindset	`click` used to expose functionality
Linear Git workflow	Tags for rollback, no branches

README.md Unescape Escape

greater_tables Project

TODO

Greater Tables