Soft Conformance Model Miner

Dependency

To use these algorithms in your Java Maven project it is necessary to include, in the pom.xml file, the dependency:

<dependency>
    <groupId>com.github.beamline</groupId>
    <artifactId>soft-conformance</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

Usage

This miner can be used to extract a model to be used with the Soft Conformance technique. These models are not necessarily referring to the control-flow (e.g., they can be based on the social network of handover of work).

This miner extracts just a dependency map leveraging the directly follows relations observed in the stream. Once a XesSource is available, the miner can be configured and used as follows:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

PDFAMiner miner = new PDFAMiner();
miner.setModelRefreshRate(1); // configure how ofter the mining algorithm should emit a new model

StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();
env
    .addSource(new StringTestSource("AABC", "ABC", "ABC", "ABC"))
    .keyBy(BEvent::getProcessName)
    .flatMap(miner)
    .addSink(new SinkFunction<PDFA>(){
        public void invoke(PDFA value, Context context) throws Exception {
            PDFAVisualizer.getDot(value).exportToSvg(new File("output.svg"));
        };
    });
env.execute();

This code will produce the following model:

Scientific literature

The techniques implemented in this package are described in:

• Online Soft Conformance Checking: Any Perspective Can Indicate Deviations
  A. Burattin
  In arXiv:2201.09222, Jan. 2022.