How promworkbench/poemsconformancecheckingforbpmn works
Project type and purpose
• This is a Java-based ProM plugin library (“POEMSConformanceCheckingForBPMN”) that implements the first stochastic conformance checking method for BPMN (SBPMN) using the POEMS (Partially Ordered Earth Movers’ Stochastic) approach.
• It provides:
– A ProM plugin (with dialogs, help pages, plugin entry classes)
– A set of console-mode runners (CLI)
– A clean separation into layers: input adapters, algorithm engine, data models, utilities, and integration layers (UI and CLI).
File structure
Top-level build & config
• build.xml, ivy.xml, ivysettings.xml → Ant build and Ivy dependency management
• .github/workflows/ant.yml → CI build
• latestrelease/… → packaged JARs/ZIPs and Ivy descriptors
Core source (src/org/processmining/poemsconformancecheckingforbpmn)
• algorithms/
– conformance_checking/… → core conformance interfaces and POEMS implementations
– inputs/… → converters for BPMN execution, reachability graphs, stochastic languages, event logs
– utils/… → generic utilities (cartesian product, directed graphs, stochastic sampling strategies)
• models/… → domain models for BPMN, traces, stochastic languages, transition systems, conformance results
• plugins/… → ProM plugin entry points (annotations, plugin classes)
• console/… → CLI runners for experiments and visualization
• dialogs/ and help/ → ProM UI dialogs and help integration
• parameters/… → sampling and algorithm parameter definitions and providers
• connections/YourConnection.java → plugin-framework glue code
• utils/log/… → XLog (XES) reader implementations
Resources
• log4j2.xml, .dot/.gv sample visualizations, images for README
Tests
• tests/… → JUnit tests covering converters, utils, core logic
Additional README insights
• Inputs: stochastic BPMN model and XES event log
• Usage: ProM plugin UI or direct Java API calls (BpmnPoemsConformanceChecking.poems().calculateConformance(...))
• Under the hood: sampling from the stochastic BPMN, building partial-order traces, computing earth-movers distance → conformance value [0,1]