petercorke
petercorke
ansitable
Python

Quick, easy and pretty display of tabular data or matrices, with optional ANSI color and borders

Last updated Apr 13, 2026
20
Stars
3
Forks
3
Issues
0
Stars/day
Attention Score
47
View on GitHub โ†— Open in github.dev
Topics
#ansi-art#ansi-colors#array#borders#columnar#csv#formatting#html#latex#markdown#matrix#pandas#restructured-text#table#tabular-data#tabular-data-formatter
Language breakdown
Python 99.2%
Makefile 0.8%
โ–ธ Files click to expand
README

PyPI version fury.io Anaconda version pyversions Build Status Maintenance GitHub license PyPI - Downloads Codacy Badge

Pretty tables and matrices for Python

Synopsis

A package for quick and simple creation of nicely formatted tables or matrices.

Create a table:

  • programatically from Python, or
  • from a Pandas dataframe which is also an easy way to read an Excel or CSV file.
then display it:
  • on the console using Unicode box drawing characters (U+2500 to U+257F) and ANSI color codes
  • in a markup language: HTML, Markdown, reStructured text, LaTeX or wikitable.

Tables

Painless creation of nice-looking tables of data for Python.

colored table

Starting simple

1 | from ansitable import ANSITable
 2 |
 3 | table = ANSITable("col1", "column 2 has a big header", "column 3")
 4 | table.row("aaaaaaaaa", 2.2, 3)
 5 | table.row("bbbbbbbbbbbbb", 5.5, 6)
 6 | table.row("ccccccc", 8.8, 9)
 7 | table.print()
Line 3 constructs an ANSITable object and the arguments are a sequence of column names followed by ANSITable keyword arguments - there are none in this first example. Since there are three column names this this will be a 3-column table. Lines 4-6 add rows, 3 data values for each row.

Line 7 prints the table and yields a tabular display with column widths automatically chosen, and headings and column data all right-justified (default)

col1  column 2 has a big header  column 3  
    aaaaaaaaa                        2.2         3  
bbbbbbbbbbbbb                        5.5         6  
      ccccccc                        8.8         9

By default output is printed to the console (stdout) but we can also:

  • provide a file option to .print() to allow writing to a specified output stream, the
default is stdout.
  • obtain a multi-line string version of the entire table as str(table).
The more general solution is to provide a sequence of Column objects which allows many column specific options to be given, as we shall see later. For now though, we could rewrite the example above as: 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1"),
        Column("column 2 has a big header"),
        Column("column 3")
    )

or as

from ansitable import ANSITable
table = ANSITable()
table.addcolumn("col1")
table.addcolumn("column 2 has a big header")
table.addcolumn("column 3")
where the keyword arguments to .addcolumn() are the same as those for Column and are given below.
We can specify a Python format() style format string for any column - by default it is the general formatting option "{}". You may choose to left or right justify values via the format string, ansitable provides control over how those resulting strings are justified within the column. 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1"),
        Column("column 2 has a big header", "{:.3g}"),  # CHANGE
        Column("column 3", "{:-10.4f}")
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", 5.5, 6)
table.row("ccccccc", 8.8, 9)
table.print()
which yields 
col1  column 2 has a big header    column 3  
    aaaaaaaaa                        2.2      3.0000  
bbbbbbbbbbbbb                        5.5      6.0000  
      ccccccc                        8.8      9.0000
Alternatively we can specify the format argument as a function that converts the value to a string.
The data in column 1 is quite long, we might wish to set a maximum column width which we can do using the width argument 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1", width=10),                      # CHANGE
        Column("column 2 has a big header", "{:.3g}"),
        Column("column 3", "{:-10.4f}")
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", 5.5, 6)
table.row("ccccccc", 8.8, 9)
table.print()
which yields 
col1  column 2 has a big header    column 3  
 aaaaaaaaa                        2.2      3.0000  
bbbbbbbbbโ€ฆ                        5.5      6.0000  
   ccccccc                        8.8      9.0000
where we see that the data in column 1 has been truncated.

If you don't like the ellipsis you can turn it off, and get to see one more character, with the ANSITable option ellipsis=False. The Unicode ellipsis character u+2026 is used.

Borders

We can add a table border made up of regular ASCII characters 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1"),
        Column("column 2 has a big header"),
        Column("column 3"),
        border="ascii"                          # CHANGE
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", 5.5, 6)
table.row("ccccccc", 8.8, 9)
table.print()
which yields 
+--------------+---------------------------+----------+
|         col1 | column 2 has a big header | column 3 |
+--------------+---------------------------+----------+
|    aaaaaaaaa |                       2.2 |        3 |
|bbbbbbbbbbbbb |                       5.5 |        6 |
|      ccccccc |                       8.8 |        9 |
+--------------+---------------------------+----------+
Or we can construct a border using the ANSI box-drawing characters which are supported by most terminal emulators 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1"),
        Column("column 2 has a big header"),
        Column("column 3"),
        border="thick"                           # CHANGE
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", 5.5, 6)
table.row("ccccccc", 8.8, 9)
table.print()
which yields 
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ         col1 โ”ƒ column 2 has a big header โ”ƒ column 3 โ”ƒ
โ”ฃโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ซ
โ”ƒ    aaaaaaaaa โ”ƒ                       2.2 โ”ƒ        3 โ”ƒ
โ”ƒbbbbbbbbbbbbb โ”ƒ                       5.5 โ”ƒ        6 โ”ƒ
โ”ƒ      ccccccc โ”ƒ                       8.8 โ”ƒ        9 โ”ƒ
โ”—โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”›
Note: this actually looks better on the console than it does in GitHub markdown.

Other border options include "thin", "rounded" (thin with round corners) and "double".

Header and column alignment

We can change the alignment of data and heading for any column with the alignment flags "<" (left), ">" (right) and "^" (centered). 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1"),
        Column("column 2 has a big header", colalign="^"),  # CHANGE
        Column("column 3"),
        border="thick"
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", 5.5, 6)
table.row("ccccccc", 8.8, 9)
table.print()
which yields 
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ         col1 โ”ƒ column 2 has a big header โ”ƒ column 3 โ”ƒ
โ”ฃโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ซ
โ”ƒ    aaaaaaaaa โ”ƒ            2.2            โ”ƒ        3 โ”ƒ
โ”ƒbbbbbbbbbbbbb โ”ƒ            5.5            โ”ƒ        6 โ”ƒ
โ”ƒ      ccccccc โ”ƒ            8.8            โ”ƒ        9 โ”ƒ
โ”—โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”›
where the data for column 2 has been centered.
Heading and data alignment for any column can be set independently 
from ansitable import ANSITable, Column
table = ANSITable(
        Column("col1", headalign="<"),                      # CHANGE
        Column("column 2 has a big header", colalign="^"),
        Column("column 3", colalign="<"),                   # CHANGE
        border="thick"
    )
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", -5.5, 6)
table.row("ccccccc", 8.8, -9)
table.print()
yields 
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ          col1 โ”ƒ column 2 has a big header โ”ƒ column 3 โ”ƒ
โ”ฃโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ซ
โ”ƒ     aaaaaaaaa โ”ƒ                       2.2 โ”ƒ        3 โ”ƒ
โ”ƒ bbbbbbbbbbbbb โ”ƒ                      -5.5 โ”ƒ        6 โ”ƒ
โ”ƒ       ccccccc โ”ƒ                       8.8 โ”ƒ       -9 โ”ƒ
โ”—โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”›
where we have left-justified the heading for column 1 and the data for column 3.

We can easily add a dividing line 

from ansitable import ANSITable, Column table = ANSITable(         Column("col1", headalign="<"),         Column("column 2 has a big header", colalign="^"),         Column("column 3", colalign="<"),         border="thick"     ) table.row("aaaaaaaaa", 2.2, 3) table.row("bbbbbbbbbbbbb", -5.5, 6) table.rule()                                                # CHANGE table.row("ccccccc", 8.8, -9) table.print()
yields

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ          col1 โ”ƒ column 2 has a big header โ”ƒ column 3 โ”ƒ
โ”ฃโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ซ
โ”ƒ     aaaaaaaaa โ”ƒ                       2.2 โ”ƒ        3 โ”ƒ
โ”ƒ bbbbbbbbbbbbb โ”ƒ                      -5.5 โ”ƒ        6 โ”ƒ
โ”ฃโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‹โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ซ
โ”ƒ       ccccccc โ”ƒ                       8.8 โ”ƒ       -9 โ”ƒ
โ”—โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ปโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”›

Color

If you have the colored package installed then you can set the foreground and background color and style (bold, reverse, underlined, dim) of the header and column data, as well as the border color. 
from ansitable import ANSITable, Column
table = ANSITable(
    Column("col1", headalign="<", colcolor="red", headstyle="underlined"),      # CHANGE
    Column("column 2 has a big header", colalign="^", colstyle="bold"),         # CHANGE
    Column("column 3", colalign="<", colbgcolor="green"),                       # CHANGE
    border="thick", bordercolor="blue"                                          # CHANGE
)

table.row("aaaaaaaaa", 2.2, 3) table.row("bbbbbbbbbbbbb", -5.5, 6)                        # CHANGE table.row("ccccccc", 8.8, -9) table.print()

which yields

colored table

It is possible to the change the color of a single row of the table, overriding the column defaults, by

table.row("aaaaaaaaa", 2.2, 3)
    table.row("bbbbbbbbbbbbb", 5.5, 6)
    table.row("ccccccc", 8.8, -9)

which yields

colored table

It is also possible to the change the color of a single cell of the table, overriding the column and row defaults, by passing a Cell instance

from ansitable import ANSITable, Column, Cell
table = ANSITable("col1", "column 2 has a big header", "column 3")
    table.row("aaaaaaaaa", 2.2, 3)
    table.row("bbbbbbbbbbbbb", Cell(-5.5, bgcolor="blue"), 6, bgcolor="yellow")  # CHANGE
    table.row("ccccccc", 8.8, 9)
    table.print()
which yields

colored table

The older method (deprecated) of doing this is by prefixing the value with a color enclosed in double angle brackets, for example <<red>>. This does not allow changing the background color or style of the cell.

from ansitable import ANSITable
table = ANSITable("col1", "column 2 has a big header", "column 3")
    table.row("aaaaaaaaa", 2.2, 3)
    table.row("<<red>>bbbbbbbbbbbbb", 5.5, 6)
    table.row("<<blue>>ccccccc", 8.8, 9)
    table.print()

All options

ANSITable

These keyword arguments control the styling of the entire table.

| Keyword | Default | Purpose | |---- |---- |---- | colsep | 2 | Gap between columns (in spaces) offset | 0 | Gap at start of each row, shifts the table to the left border | no border | Border style: 'ascii', 'thin', 'thick', 'double' bordercolor | |Border color, see possible values ellipsis | True | Add an ellipsis if a wide column is truncated header | True | Include the column header row columns | | Specify the number of columns if header=False and no header name or Column arguments are given color | True | Enable color

  • Color is only possible if the colored package is installed
  • If color is False then no color escape sequences will be emitted, useful
override for tables included in Sphinx documentation.

Column

These keyword arguments control the styling of a single column.

| Keyword | Default | Purpose | |---- |---- |---- | fmt | "{}" | format string for the column value, or a callable that maps the column value to a string width || maximum column width, excess will be truncated colcolor || Text color, see possible values colbgcolor || Text background color, see possible values colstyle || Text style: "bold", "underlined", "reverse", "dim", "blink" colalign | ">" | Text alignment: ">" (left), "<" (right), "^" (centered) headcolor || Heading text color, see possible values headbgcolor || Heading text background color, see possible values headstyle || Heading text style: "bold", "underlined", "reverse", "dim", "blink" headalign | ">" | Heading text alignment: ">" (left), "<" (right), "^" (centered)

Note that many terminal emulators do not support the "blink" style.

Row

These keyword arguments control the styling of a single row.

| Keyword | Default | Purpose | |---- |---- |---- | fgcolor || Text color, see possible values bgcolor || Text background color, see possible values style || Text style: "bold", "underlined", "reverse", "dim", "blink"

Row styling overrides column styling.

Cell

These keyword arguments control the styling of a single cell.

| Keyword | Default | Purpose | |---- |---- |---- | fgcolor || Text color, see possible values bgcolor || Text background color, see possible values style || Text style: "bold", "underlined", "reverse", "dim", "blink"

Cell styling overrides row and column styling.

Render to markup language

Now that you can visualize your data as a beautiful table on the console, you might want the table in a different format to include in a document or website. ANSItable supports rendering a table into one of a number of common markup languages.

We start by creating a simple table

table = ANSITable("col1", "column 2 has a big header", "column 3")
table.row("aaaaaaaaa", 2.2, 3)
table.row("bbbbbbbbbbbbb", -5.5, 6)
table.row("ccccccc", 8.8, -9)
table.print()

Support for alignment and color options depends on the capability of the markup language that is being exported to.

Markdown

The table can be rendered into Markdown format by

table.markdown()
which generates 
|          col1 | column 2 has a big header | column 3 |
| ------------: | ------------------------: | -------: |
|     aaaaaaaaa |                       2.2 |        3 |
| bbbbbbbbbbbbb |                      -5.5 |        6 |
|       ccccccc |                       8.8 |       -9 |

Column alignment is supported, but MarkDown doesn't allow the header to have different alignment to the data.

HTML

The table can be rendered into HTML format by

table.html()
which generates 
<table style=''>
  <tr style=''>
    <th style='text-align:right;'>col1</th>
    <th style='text-align:right;'>column 2 has a big header</th>
    <th style='text-align:right;'>column 3</th>
  </tr>
  <tr style=''>
    <td style='text-align:right;'>aaaaaaaaa</td>
    <td style='text-align:right;'>2.2</td>
    <td style='text-align:right;'>3</td>
  </tr>
  <tr style=''>
    <td style='text-align:right;'>bbbbbbbbbbbbb</td>
    <td style='text-align:right;'>-5.5</td>
    <td style='text-align:right;'>6</td>
  </tr>
  <tr style=''>
    <td style='text-align:right;'>ccccccc</td>
    <td style='text-align:right;'>8.8</td>
    <td style='text-align:right;'>-9</td>
  </tr>
</table>
which renders as
col1 column 2 has a big header column 3
aaaaaaaaa 2.2 3
bbbbbbbbbbbbb -5.5 6
ccccccc 8.8 -9

CSS styling options can be applied to the table, rows and cells. This format supports ANSItable header and column foreground and background color options.

ReStructedText

The table can be rendered into reStructedText (ReST) "simple table" format by

table.rest()
which generates 
=============  =========================  ========
         col1  column 2 has a big header  column 3
=============  =========================  ========
    aaaaaaaaa                        2.2         3
bbbbbbbbbbbbb                       -5.5         6
      ccccccc                        8.8        -9
=============  =========================  ========

Header and column alignment options are not supported in the ReST simple table format.

LaTex

The table can be rendered into LaTeX format by

table.latex()
which generates 
\begin{tabular}{ |r|r|r| }\hline
\multicolumn{1}{|r|}{col1} & \multicolumn{1}{|r|}{column 2 has a big header} & \multicolumn{1}{|r|}{column 3}\\\hline\hline
aaaaaaaaa & 2.2 & 3 \\
bbbbbbbbbbbbb & -5.5 & 6 \\
ccccccc & 8.8 & -9 \\
\hline
\end{tabular}

Header and column alignment options are supported.

Wikitable

The table can be rendered into wikitable markup format, as used for tables in Wikipedia, by

table.wikitable()
which generates 
{| class="wikitable" col1right col2right col3right
|-
!           col1  !!  column 2 has a big header  !!  column 3  
|-
|      aaaaaaaaa  ||                        2.2  ||         3  
|-
|  bbbbbbbbbbbbb  ||                       -5.5  ||         6  
|-
|        ccccccc  ||                        8.8  ||        -9  
|}

Column alignment is supported, but wikitable headers are always centred.

CSV

The table can be rendered into CSV format by

table.csv()
which generates 
col1,column 2 has a big header,column 3
aaaaaaaaa,2.2,3
bbbbbbbbbbbbb,-5.5,6
ccccccc,8.8,-9
The delimiter character defaults to comma, but can be set.

CSV format data can be quickly visualized on the desktop using any spreadsheet program, or included in ReST documentation using the csv-table directive.

Pandas integration

Pandas is THE tool to use for tabular data so we support conversions in both directions.

To convert a Pandas DataFrame to an ANSItable is just

import pandas as pd

df = pd.DataFrame({"calories": [420, 380, 390], "duration": [50, 40, 45]}) table = ANSITable.Pandas(df, border="thin") table.print()


โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ calories โ”‚ duration โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚      420 โ”‚       50 โ”‚ โ”‚      380 โ”‚       40 โ”‚ โ”‚      390 โ”‚       45 โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
`Pandas() is a static method that acts like a constructor. This is the simplest way to display CSV format data in an ANSItable by using Pandas read_csv() to load the data into a DataFrame.

To export an ANSItable as a Pandas DataFrame is simply

<pre><code class="lang-">table = ANSITable(&quot;col1&quot;, &quot;column 2 has a big header&quot;, &quot;column 3&quot;) table.row(&quot;aaaaaaaaa&quot;, 2.2, 3) table.row(&quot;bbbbbbbbbbbbb&quot;, -5.5, 6) table.row(&quot;ccccccc&quot;, 8.8, -9)

df = table.pandas() print(df)

col1 column2hasabigheader column3 0 aaaaaaaaa 2.2 3 1 bbbbbbbbbbbbb -5.5 6 2 ccccccc 8.8 -9</code></pre> Note that the column names have been modified, spaces changed to underscores, which allows the columns to be accessed as attributes:

<pre><code class="lang-">print(df.column2hasabigheader.tostring())

0 2.2 1 -5.5 2 8.8</code></pre> which shows the column as a Pandas Series object. This column name-changing behaviour can be disabled by passing underscores=False.

Matrices

Painless creation of nice-looking matrices for Python.

We can create a formatter for NumPy arrays (1D or 2D)

<pre><code class="lang-python">from ansitable import ANSIMatrix formatter = ANSIMatrix(style=&#39;thick&#39;)</code></pre>

and then use it to format a NumPy array

<pre><code class="lang-python">m = np.random.rand(4,4) - 0.5 m[0,0] = 1.23456e-14 formatter.print(m)</code></pre>

yields

<pre><code class="lang-">โ” โ”“ โ”ƒ 0 -0.385 -0.106 0.296 โ”ƒ โ”ƒ 0.0432 0.339 0.119 -0.468 โ”ƒ โ”ƒ 0.405 -0.306 0.0165 -0.439 โ”ƒ โ”ƒ 0.203 0.4 -0.499 -0.487 โ”ƒ โ”— โ”›</code></pre>

we can also add suffixes

<pre><code class="lang-python">formatter.print(m, suffixsuper=&#39;T&#39;, suffixsub=&#39;3&#39;)</code></pre>

yields

<pre><code class="lang-">โ” โ”“T โ”ƒ 0 -0.239 0.186 -0.414 โ”ƒ โ”ƒ 0.49 0.215 -0.0148 0.0529 โ”ƒ โ”ƒ 0.0473 0.0311 0.45 0.394 โ”ƒ โ”ƒ-0.192 0.193 -0.455 0.0302 โ”ƒ โ”— โ”›3</code></pre>

By default output is printed to the console (stdout) but we can also:

  • provide a file option to .print() to allow writing to a specified output stream, the default is stdout.
  • obtain a multi-line string version of the entire table using the .str() method
instead of .print().

The formatter takes additional arguments to control the numeric format and to control the suppression of very small values.

ANSIMatrix

These keyword arguments control the overall styling and operation of the formatter.

| Keyword | Default | Purpose | |---- |---- |---- | style | "thin" | "thin", "round", "thick", "double" fmt | "{:< 10.3g}" | format for each element squish | True | set small elements to zero squishtol | 100 | elements less than squishtol * eps are set to zero

Formatter

A formatter takes additional arguments to the styling for a particular call.

| Keyword | Default | Purpose | |---- |---- |---- | suffix_super | "" | superscript suffix text suffix_sub | ""` | subscript suffix text

๐Ÿ”— More in this category
d3
d3/d3
Bring data to life with SVG, Canvas and HTML. :bar_chart::chart_with_upwards_trend::tada:
โ˜… 113.2k
 apache
apache/echarts
Apache ECharts is a powerful, interactive charting and data visualization library for browser
โ˜… 66.8k
 metabase
metabase/metabase
The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
โ˜… 48.1k
 DataTalksClub
DataTalksClub/data-engineering-zoomcamp
Data Engineering Zoomcamp is a free 9-week course on building production-ready data pipelines. The next cohort starts in January 2026. Join the course here ๐Ÿ‘‡๐Ÿผ
โ˜… 43.3k
 NaiboWang
NaiboWang/EasySpider
A visual no-code/code-free web crawler/spiderๆ˜“้‡‡้›†๏ผšไธ€ไธชๅฏ่ง†ๅŒ–ๆต่งˆๅ™จ่‡ชๅŠจๅŒ–ๆต‹่ฏ•/ๆ•ฐๆฎ้‡‡้›†/็ฝ‘้กต็ˆฌ่™ซ่ฝฏไปถ๏ผŒๅฏไปฅๆ— ไปฃ็ ๅ›พๅฝขๅŒ–็š„่ฎพ่ฎกๅ’Œๆ‰ง่กŒ็ˆฌ่™ซไปปๅŠกใ€‚ๅˆซๅ๏ผšServiceWrapper้ขๅ‘Webๅบ”็”จ็š„ๆ™บ่ƒฝๅŒ–ๆœๅŠกๅฐ่ฃ…็ณป็ปŸใ€‚
โ˜… 44.2k
 AykutSarac
AykutSarac/jsoncrack.com
โœจ Innovative and open-source visualization application that transforms various data formats, such as JSON, YAML, XML and CSV into interactive graphs.
โ˜… 44.2k
 gchq
gchq/CyberChef
The Cyber Swiss Army Knife - a web app for encryption, encoding, compression and data analysis
โ˜… 35.3k
 academic
academic/awesome-datascience
:memo: An awesome Data Science repository to learn and apply for real world problems.
โ˜… 29.6k
 thingsboard
thingsboard/thingsboard
Open-source IoT Platform - Device management, data collection, processing and visualization.
โ˜… 22.0k
 kestra-io
kestra-io/kestra
Event Driven Orchestration & Scheduling Platform for Mission Critical Applications
โ˜… 27.3k
 dataease
dataease/dataease
๐Ÿ”ฅ ไบบไบบๅฏ็”จ็š„ๅผ€ๆบ BI ๅทฅๅ…ท๏ผŒๆ•ฐๆฎๅฏ่ง†ๅŒ–็ฅžๅ™จใ€‚An open-source BI tool alternative to Tableau.
โ˜… 24.2k
 stefan-jansen
stefan-jansen/machine-learning-for-trading
Code for Machine Learning for Trading, 3rd edition โ€” from data sourcing to live execution.
โ˜… 19.7k

ยฉ 2026 GitRepoTrend ยท petercorke/ansitable ยท Updated daily from GitHub