temporal-mapper 1.1.0

No project description provided

Temporal Mapper

V.1.1.0 - February 02 2026

---

This is a library for using the Mapper for temporal topic modelling. Though things broadly work now, the edge cases have not been throughly tested.

Direct questions to Kaleb D. Ruscitti: kaleb.ruscitti at uwaterloo.ca .

Complete documentation is under construction on Read The Docs.

Example:

arXiv Papers

From the arXiv API, we can retrieve ~500,000 article titles and abstracts, use SBERT to embed them, and then UMAP to reduce to 2D.

Using DataMapPlot and TopicNaming we can produce a static plot of this data:

Now, using this repository we can additionally analyse the temporal information. Using the Mapper algorithm with time as our lens function, we create a temporal graph of the topics (clusters) through time. The code includes two types of plots to visualize this graph:

Centroid Plot	Temporal-Semantic Plot

Installation

Install from PyPI: pip install temporal-mapper

Or, clone the repo and install:

git clone https://github.com/TutteInstitute/temporal-mapper.git

cd temporal-mapper && pip install .

Development Instructions

Getting set up

(Mostly for my future self...)

Clone the repo: git clone https://github.com/TutteInstitute/temporal-mapper.git

Then make a virtual environment and install the package and pytest.

cd temporal-mapper && python -m venv .venv

source .venv/bin/activate

pip install -r requirements.txt && pip install -e .

Before making any changes, check that the tests run successfully:

cd tests && python -m pytest mapper.py