Periodisk

Periodisk is an open-source Python package for generating accessible, source-traceable periodic tables for chemistry teaching. It produces SVG and PDF files using an offline dataset of all 118 elements.

Installation

Periodisk requires Python 3.13 or newer.

python -m pip install periodisk

Usage

Command line

The periodisk render command writes a periodic table to an SVG or PDF file. The output format is inferred from the filename extension. For example, render the default English table on an A3 page with:

periodisk render periodic-table.pdf --language en_GB --page-size A3

Run periodisk render --help for every option and its description.

Python API

The same table can be generated through the Python API:

from periodisk import render_table

render_table(
    "periodic-table.pdf",
    language="en_GB",
    page_size="A3",
)

Periodisk supports:

• British English and Norwegian Bokmål (nb_NO)
• Detailed and simplified table content
• Detailed and broad element classifications
• Multiple accessible, print-oriented colour schemes
• Configurable cell styles and rounded corners
• Pauling, Allred-Rochow, and Allen electronegativity scales
• SVG and PDF output

Documentation

The GitHub repository contains the full documentation and rendered examples:

• Examples
• Scientific data sources and methods
• Design and colour schemes
• Localisation

Licence

The Python source code is available under the MIT License. Original documentation and rendered periodic tables are available under CC BY 4.0. Scientific provenance and third-party notices are documented in the repository.