Introduction

OCPQ is a tool for querying and analyzing object-centric event data. Get started by exploring selected example queries, or by reading through one of our guides.

Examples

For more background information, see our paper OCPQ: Object-Centric Process Querying and Constraints published at RCIS 2025 (preprint). The OCPQ tool received the Best Demos & Resources Award at BPM 2025 (demo paper). All papers on OCPQ and the techniques implemented in it are listed on the About page.

Guides

Get started using one of our introduction guides:

Situation Tables Guide

Inspector Guide

OC-DECLARE Guide

Path Schema Guide

Data Extraction Guide

FAQ

Below, we include answers to some common questions. If you have a question that isn’t answered here, please open a discussion.

How can I use OCPQ?

To run OCPQ you can either use the provided pre-compiled installer available from here or build it yourself using Docker (see here).

What input data does OCPQ support?

OCPQ supports all file formats of OCEL 2.0 (XML, JSON, and SQLite), CSV and ZIP bundles, as well as XES event logs. Additionally, data from databases or from CSV, Excel, and Parquet files can be converted to an OCEL using a data extraction blueprint.

You can find some example datasets here. For instance, with this link, you can download the Order Management example XML OCEL 2.0 log.