Skip to content

Packages

Open-source tools for processing, comparing and publishing archaeological pottery data. The pipeline papers are listed under publications.

PyPottery suite

Every manual step of the classical documentation workflow has a counterpart: capture drawings, refine them, publish plates. Use the whole chain or only the step you need. Everything runs on your own computer, so unpublished finds stay private.

PyPottery

Launcher and documentation

The entry point to the suite. A launcher installs and updates every tool, with no Python installation required, and the documentation has one guide per tool. Runs locally on Windows, macOS and Linux.

Documentation Download launcher GitHub

PyPotteryLens

Capture

Pulls vessel drawings out of monograph PDFs, so legacy publications become structured data.

Guide GitHub Paper

PyPotteryScan under review

Capture

Digitises scanned plates and reads their labels, including handwritten field cards.

PyPotteryInk

Refine

Turns pencil sketches into publication-ready ink with a one-step diffusion model.

Guide GitHub Paper

PyPotteryTrace under review

Refine

Vectorises profiles into editable SVG, with segmentation by SAM 2.

PyPotteryLayout

Publish

Composes plates and artefact tables with consistent scale and captions.

Other software

Ceramatic 2.0

Computer vision pipeline

A computer vision pipeline for archaeological drawings, evaluated against manual and laser-aided documentation.

GitHub Evaluation paper

Ceraloop

Web framework, with Julian Bogdani

A web-based framework for analysing perception and comparison in archaeological pottery.

CQArchaeo

Python package

Calculates and plots Kendall's cosine quantogram analysis (1974) results, with Monte Carlo simulations.