# promworkbench/poemsconformancecheckingforbpmn architecture

> Architecture diagram of the GitHub repository promworkbench/poemsconformancecheckingforbpmn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/promworkbench/poemsconformancecheckingforbpmn
- Repository: https://github.com/promworkbench/poemsconformancecheckingforbpmn

## Overview

##### 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]

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Integration Layer
    subgraph "Integration Layer"
        direction TB
        PluginExtension["ProM Plugin Extension"]:::integration
        UIDialog["ProM UI Dialogs"]:::integration
        HelpIntegration["ProM Help Integration"]:::integration
        ConsoleRunners["Console Runners (CLI)"]:::integration
    end

    %% Input Adapters & Converters
    subgraph "Input Adapters & Converters"
        direction TB
        SBPMN2RG["SBPMN → Reachability Graph Converter"]:::adapters
        RG2Trace["Reachability Graph → PO Path/Trace Converter"]:::adapters
        XESSimplifier["XES Event Log Simplifier"]:::adapters
        StochasticConverter["Stochastic Trace Language Converter"]:::adapters
    end

    %% Data Model Layer
    subgraph "Data Model Layer"
        direction TB
        BPMNModel["BPMN Model (Executable Diagram)"]:::model
        TransitionSystem["Transition System Model"]:::model
        TraceModels["Trace Representations (Partial & Total Orders)"]:::model
        StochasticModels["Stochastic Language & Sample Classes"]:::model
        ResultModels["Conformance Checking Result Models"]:::model
    end

    %% Core Engine
    subgraph "Core Engine"
        direction TB
        SamplingModule["Sampling Module (Strategies & Stopping Criteria)"]:::core
        ConformanceModule["ConformanceChecking Module (POEMS)"]:::core
    end

    %% Utilities & Shared Services
    subgraph "Utilities & Shared Services"
        direction TB
        GraphUtils["Graph Utilities"]:::util
        CartesianProduct["Cartesian Product Utility"]:::util
        XESReader["XES Reader Utility"]:::util
    end

    %% Build & Packaging
    subgraph "Build & Packaging"
        direction TB
        BuildAntIvy["Ant & Ivy Build Scripts & CI"]:::build
    end

    %% Connections
    PluginExtension -->|invokes| SBPMN2RG
    PluginExtension -->|invokes| XESSimplifier
    UIDialog -->|configures| SBPMN2RG
    ConsoleRunners -->|runs| SBPMN2RG
    ConsoleRunners -->|runs| XESSimplifier

    SBPMN2RG -->|produces| BPMNModel
    SBPMN2RG -->|produces| TransitionSystem
    RG2Trace -->|converts| TraceModels
    XESSimplifier -->|simplifies| TraceModels
    StochasticConverter -->|converts| StochasticModels

    BPMNModel -->|input| SamplingModule
    TransitionSystem -->|input| SamplingModule
    TraceModels -->|input| SamplingModule
    StochasticModels -->|input| SamplingModule

    SamplingModule -->|generates| StochasticModels
    SamplingModule -->|feeds| ConformanceModule
    TraceModels -->|feeds| ConformanceModule

    ConformanceModule -->|outputs| ResultModels

    ResultModels -->|display| UIDialog
    ResultModels -->|export| ConsoleRunners

    %% Utilities usage
    GraphUtils -->|used by| SBPMN2RG
    GraphUtils -->|used by| SamplingModule
    CartesianProduct -->|used by| SamplingModule
    XESReader -->|used by| XESSimplifier

    %% Build
    BuildAntIvy

    %% Click Events
    click PluginExtension "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/plugins/POEMStochasticConformanceCheckingPlugin.java"
    click UIDialog "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/dialogs/SBPMNSamplingConfigurationDialog.java"
    click HelpIntegration "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/help/YourHelp.java"
    click ConsoleRunners "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/console"
    click SBPMN2RG "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/bpmn/statespace/Bpmn2POReachabilityGraphConverter.java"
    click SBPMN2RG "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/bpmn/statespace/Bpmn2POReachabilityGraphConverterImpl.java"
    click RG2Trace "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/bpmn/execution/BpmnPOPath2TraceConverter.java"
    click RG2Trace "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/bpmn/execution/BpmnPOPath2TraceConverterImpl.java"
    click XESSimplifier "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/log/simplifier/XLogSimplifier.java"
    click XESSimplifier "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/log/simplifier/impl/BasicXLogSimplifier.java"
    click StochasticConverter "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/log/stohastic_language/simplified/SimplifiedLog2StochasticLanguageConverter.java"
    click StochasticConverter "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/inputs/log/stohastic_language/simplified/SimplifiedLog2StochasticLanguageConverterImpl.java"
    click SamplingModule "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/utils/stochastics/sampling/strategy"
    click SamplingModule "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/utils/stochastics/sampling/stopping"
    click ConformanceModule "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/conformance_checking/ConformanceChecking.java"
    click ConformanceModule "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/conformance_checking/poems/POEMSConformanceChecking.java"
    click ConformanceModule "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/conformance_checking/poems/POEMSConformanceCheckingEMSC24Adapter.java"
    click BPMNModel "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/models/bpmn/execution/ExecutableBpmnDiagram.java"
    click TransitionSystem "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/models/transition_system"
    click TraceModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/models/trace/partial_order"
    click TraceModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/models/trace/total_order"
    click StochasticModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/models/stochastic/Sample.java"
    click StochasticModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/tree/main/src/org/processmining/poemsconformancecheckingforbpmn/models/stochastic/language"
    click ResultModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/models/bpmn/conformance/result/POEMSConformanceCheckingResult.java"
    click ResultModels "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/models/bpmn/conformance/result/BpmnPoemsPOEMSConformanceCheckingResult.java"
    click GraphUtils "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/utils/directedGraph/DirectedGraphUtils.java"
    click CartesianProduct "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/algorithms/utils/cartesianproduct/CartesianProductCalculator.java"
    click XESReader "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/utils/log/XLogReader.java"
    click XESReader "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/src/org/processmining/poemsconformancecheckingforbpmn/utils/log/XLogReaderImpl.java"
    click BuildAntIvy "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/build.xml"
    click BuildAntIvy "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/ivy.xml"
    click BuildAntIvy "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/ivysettings.xml"
    click BuildAntIvy "https://github.com/promworkbench/poemsconformancecheckingforbpmn/blob/main/.github/workflows/ant.yml"

    %% Styles
    classDef integration fill:#D0E8FF,stroke:#0366D6
    classDef adapters fill:#D6F5D6,stroke:#28A745
    classDef core fill:#FFE5B4,stroke:#D9822B
    classDef model fill:#FFF5BA,stroke:#E3B23C
    classDef util fill:#E0E0E0,stroke:#565656
    classDef build fill:#F7F7F7,stroke:#A0A0A0
```
