Skip to content
TOTeM Tool

Temporal Object Type Model

TOTeM Tool

See what Object-Centric Process Mining can do.

GitHub
$pip install totem-tool

Free & open source · Windows & macOS

About the tool

Research you can install.

Most processes are not about a single case. An order has items, items are packed into containers, containers ride on trucks. Every event touches several of these objects at once. Object-centric process mining analyses event data the way it really happened, without flattening it to one case notion first.

The TOTeM Tool was developed by Lukas Liss and his team as part of a Software Campus project. It brings methods from recent research into one desktop app: import an OCEL 2.0 log and start exploring.

It is free and open source under the MIT license, and its analysis core is available as a Python package, totem-tool (source in totem_lib).

Lukas Liss

Researcher at the Process and Data Science group (PADS), RWTH Aachen University

Questions, ideas, a log that breaks something, or a process you would like to look at together? I am always happy to hear from you.

The research behind it (a selection)

01Process Areas

Big logs, split into parts you can actually read.

Real object-centric event logs hold many object types and many intertwined processes. Drawn as one model, you may get overwhelmed. Process area discovery groups the object types into areas and stacks them on levels, so you see the big picture first and then drill down into details.

try:

The same log as 6 process areas on 4 levels — resources on top.

  • Levels show who serves whom

    Resources such as trucks and forklifts sit above the containers and handling units they move. Object types that belong together share a process area.

  • Open one area at a time

    Expand an area to see the directly-follows graph of just its activities — the rest of the log stays out of the way.

  • Narrow every analysis to it

    One click turns an area into the global filter, so discovery, variants and dashboards all focus on that part of the process.

container_logistics.json — Analysis › Process AreaInteractive
Loading process areas…

Container Logistics example log · 35,413 events · 13,910 objects · 7 object types · 14 activities

02Process Discovery

One log, four ways to look at it.

Every model answers a different question. The TOTeM Tool discovers all of them from the same OCEL 2.0 log — no flattening to a single case notion, no copying data between tools.

TOTeM

Temporal Object Type Model

How do the object types relate — in time and in numbers?

TOTeM looks at object types instead of activities. It discovers which types live at the same time, which one has to exist before the other, and how many of one go with the other — one container carries 1..* handling units, a transport document lists up to many containers.

try it

Move the τ slider to see which relations hold only for most objects.

Good for
Understanding a log you have never seen
Data models and object lifecycles
Paper: Liss et al., BPM 2024
container_logistics.json — Analysis › TOTeM MinerInteractive
Loading discovery…

03Dashboards

Your analysis, arranged the way you think.

Put the numbers, charts and models that matter next to each other and keep them. Build a dashboard for the weekly review, one for the bottleneck you are chasing, one for the people who just want the overview.

  • 18 widgets — from KPIs and charts to process models and organizational mining
  • Charts and KPIs are plain SQL on your OCEL, with a library of example queries
  • Drag, resize and arrange freely; every dashboard is saved with its project
  • Global and per-widget filters keep every view on the slice you care about
container_logistics.json — Dashboards › Weekly reviewInteractive
Loading the dashboard…

Editing dashboards needs a bigger screen — open this page on a laptop to build your own.

And there is more

Everything in one place, from import to insight.

FAQ

Frequently asked questions.

Answers to technical, operational, and architectural questions about the TOTeM Tool.

Ready to look at your own log?

Download the TOTeM Tool for Windows or macOS — free, open source, and everything runs on your machine.

Build from source

Prefer Python? The analysis core is on PyPI:

$pip install totem-tool

View totem-tool on PyPI →