Interactive Tables

Pandas DataFrames and Series as interactive datatables!

Install the package with

pip install itables

Activate the interactive mode for all series and dataframes with

from itables import init_notebook_mode

init_notebook_mode(all_interactive=True)

or use itables.show to show just one Series or DataFrame as an interactive table.

Since itables==1.0.0, the jquery and datatables.net libraries and CSS are injected in the notebook when you execute init_notebook_mode with its default argument connected=False. Thanks to this the interactive tables will work even without a connection to the internet.

If you prefer to load the libraries dynamically (and keep the notebook lighter), use connected=True when you execute init_notebook_mode.

Documentation

Read more about itables and advanced use cases in the documentation.

In particular, the show method let you pass custom parameters to datatables.net's DataTable()'s constructor - see the advanced parameters examples.

Supported environments

itables has been tested in the following editors:

Jupyter Notebook
Jupyter Lab
Jupyter nbconvert (i.e. the tables are still interactive in the HTML export of a notebook)
Jupyter Book
Google Colab
VS Code (for both Jupyter Notebooks and Python scripts)
PyCharm (for Jupyter Notebooks)

Try ITables on Binder

You can run our examples notebooks directly on , without having to install anything on your side.

Table not loading?

If the table just says "Loading...", then maybe

You loaded a notebook that is not trusted (run "Trust Notebook" in View / Activate Command Palette)
You forgot to run init_notebook_mode, or you deleted that cell or its output
Or you ran init_notebook_mode(connected=True) but you are not connected to the internet?

Please note that if you change the value of the connected argument in the init_notebook_mode cell, you will need to re-execute all the cells that display interactive tables.

If the above does not help, please check out the ChangeLog and decide whether you should upgrade itables.

Downsampling

When the data in a table is larger than maxBytes, which is equal to 64KB by default, itables will display only a subset of the table - one that fits into maxBytes. If you wish, you can deactivate the limit with maxBytes=0, change the value of maxBytes, or similarly set a limit on the number of rows (maxRows, defaults to 0) or columns (maxColumns, defaults to pd.get_option('display.max_columns')).

Note that datatables support server-side processing. At a later stage we may implement support for larger tables using this feature.

from itables.sample_dfs import get_indicators
import itables.options as opt

opt.lengthMenu = [2, 5, 10, 20, 50, 100, 200, 500]
opt.maxBytes = 10000

df = get_indicators()
df.values.nbytes

df

To show the table in full, we can modify the value of maxBytes either locally:

show(df, maxBytes=0)

or globally:

opt.maxBytes = 2 ** 20
df

Metadata

Release files for itables 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for itables 1.1.1
File	Size	Uploaded
itables-1.1.1.tar.gz	190.1 kB	Jun 23, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for itables 1.1.1
File	Interpreter	ABI	Platform	Reset
itables-1.1.1-py3-none-any.whl 192.7 kB Jun 23, 2022	Python 3	none	any	Details

Total release size: 382.9 kB

Release files / itables-1.1.1.tar.gz

Download URL	itables-1.1.1.tar.gz
Size	190.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`ee33b201d83e136b26d7e9739db91f6ce801d52d1a9846dd6333f21322cd9e97`
BLAKE2b-256 checksum How to use checksums	`c03b437aa31ce9296f14dfe15f5ceec74db9514c153312b03e9a340d1ff13672`
Upload date	Jun 23, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.7.13`

Release files / itables-1.1.1-py3-none-any.whl

Download URL	itables-1.1.1-py3-none-any.whl
Size	192.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4c1c44d1baaa49ab14c07f3ef9ef2654d93717ee528edbfccd91582c5fe7f1e5`
BLAKE2b-256 checksum How to use checksums	`c5017727c381e9af6059454784420f37ce2135cdb0f9063bc1717c7b68537e93`
Upload date	Jun 23, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.7.13`