ERGminer

ERGminer is a Python package for mining Event Relationship Graphs (ERGs) from event logs using process mining, state variable identification, and statistical analysis.

What is an ERG?

An Event Relationship Graph captures the causal and temporal relationships between events in a queueing system. It includes:

• Nodes — activities/events mapped to queueing event types (Arrive, Start Process, Run, End Process, Rework, Failure)
• Arcs — transitions with probabilities, guard conditions, and delay distributions
• State Variables — Server Busy and Queue Length variables with update equations

Pipeline Overview

Event Log → Process Mining → State Variable ID → Guard Detection → Delay Analysis → ERG
                                                                                     ↓
                                                              Simulation ← Export (ERGML/JSON/DOT)
                                                                  ↓
                                                          Conformance Testing

Quick Install

pip install ERGminer

Minimal Example

import ergminer

log = ergminer.read_csv("data/event_log.csv")
erg = ergminer.discover_erg(log)
erg.print_summary()
ergminer.write_ergml(erg, "output/erg.ergml", sim_time=10000.0)