<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.0 20120330//EN" "JATS-archivearticle1.dtd">
<article xmlns:xlink="http://www.w3.org/1999/xlink">
  <front>
    <journal-meta>
      <journal-title-group>
        <journal-title>Corresponding author.
$ martin.kabierski@hu-berlin.de (M. Kabierski); christian.imenkamp@uni-bayreuth.de (C. Imenkamp);
agnes.koschmider@uni-bayreuth.de (A. Koschmider); matthias.weidlich@hu-berlin.de (M. Weidlich)</journal-title>
      </journal-title-group>
    </journal-meta>
    <article-meta>
      <title-group>
        <article-title>SpeciAL4PM: Species Analysis of Event Logs for Process Mining</article-title>
      </title-group>
      <contrib-group>
        <contrib contrib-type="author">
          <string-name>Martin Kabierski</string-name>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Christian Imenkamp</string-name>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Agnes Koschmider</string-name>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Matthias Weidlich</string-name>
        </contrib>
      </contrib-group>
      <pub-date>
        <year>2024</year>
      </pub-date>
      <volume>000</volume>
      <fpage>0</fpage>
      <lpage>0002</lpage>
      <abstract>
        <p>We present SpeciAL4PM (Species Analysis of Event Logs for Process Mining), a Python library for the analysis and visualization of event logs that incorporates notions of biodiversity research. Under this view, SpeciAL4PM enables the quantification of the completeness of event logs and the estimation of the diversity of the system from which the log originates. We supplement SpeciAL4PM with a web-based implementation, named SpeciAL4PM-live , that facilitates the use of the library without the need for programming, thereby supporting users in the exploration of their event data.</p>
      </abstract>
      <kwd-group>
        <kwd>eol&gt;Event Log Analysis</kwd>
        <kwd>Log Completeness</kwd>
        <kwd>Log Diversity</kwd>
        <kwd>Process Mining</kwd>
      </kwd-group>
    </article-meta>
  </front>
  <body>
    <sec id="sec-1">
      <title>1. Introduction</title>
      <p>
        Event logs, whether they are created by the execution of process-centric information systems
or by simulation of process models, build the foundation of process analysis [
        <xref ref-type="bibr" rid="ref1">1</xref>
        ]. Yet, these
event logs are only samples of the underlying (information) system that generated them. Hence,
they cannot be assumed to be complete with respect to the recorded behavioural characteristics
a-priori. This incompleteness, influenced by the size of the event log and the diversity of the
behavioural characteristics of interest, may skew any analysis proportional to the diversity of
these characteristics, i.e., incomplete logs may yield false insights. Thus, to draw trustworthy
conclusions, one shall quantify (i) the completeness of an event log with respect to the relevant
characteristics and (ii) the expected diversity of them, independent of the given log.
      </p>
      <p>
        In recent work [
        <xref ref-type="bibr" rid="ref2 ref3">2, 3</xref>
        ], we showed how to quantify both completeness and diversity by
employing biodiversity estimators. Those treat event logs as samples of observed species that are
obtained under appropriate sampling models, and estimate properties of the species population
therefrom. In particular, we considered diversity under diferent behavioural abstractions, i.e.,
      </p>
      <p>Event
Log</p>
      <p>Species
Retrieval</p>
      <p>Rank
Abundance</p>
      <p>Curve
Completeness Profile</p>
      <p>Completeness</p>
      <p>
        Coverage
Expected Sampling Effort
log species, using a diversity profile based on asymptotic Hill numbers [
        <xref ref-type="bibr" rid="ref4">4</xref>
        ]. It captures properties
of the observed distribution of species, based on their occurrence frequencies in the log. We also
presented a completeness profile to quantify log completeness in absolute and relative terms.
      </p>
      <p>To facilitate the analysis of event logs when considering them as samples of some population
of species, in this work, we propose SpeciAL4PM (Species Analysis of Event Logs for Process
Mining), a Python library for quantifying and visualizing the completeness profile and the
diversity profile of an event log. We complement the library with SpeciAL4PM-live , a web-based
tool for the main functions of SpeciAL4PM , which allows a user to upload an event log and
explore the completeness and diversity estimates, thus enabling an easy-to-use, coding-free
application of the respective measures. With SpeciAL4PM , a user can assess the completeness
and diversity of an event log, incorporate these factors in their event log analysis, and be
confident that obtained insights are supported by suficiently complete data.</p>
      <p>In the remainder, in Section 2, we discuss the features of SpeciAL4PM and explain how the
library is used. Then, in Section 3 we discuss SpeciAL4PM-live , before discussing the availability
and maturity of the tool in Section 4. Lastly, we conclude in Section 5.</p>
    </sec>
    <sec id="sec-2">
      <title>2. SpeciAL4PM</title>
      <p>
        SpeciAL4PM enables the calculation and visualization of species abundance curves, completeness
profiles and diversity profiles for diferent species definitions, as illustrated in Figure 1 and
proposed in [
        <xref ref-type="bibr" rid="ref3">3</xref>
        ]. Currently, SpeciAL4PM supports the analysis of event logs in .xes-format.
Below, we outline the functionality in more detail.
      </p>
      <p>Species Retrieval A species retrieval function captures the behavioral properties of interest
of the event log per trace. These properties serve as the basis for the following species-based
analysis tasks. Currently, SpeciAL4PM supports observed activities, directly-follows relations,
n-grams and trace variants, but users can provide their own species definitions as well.
Furthermore, users can specify multiple species definitions per log, facilitating the eficient computation
and comparison of diferent behavioural properties.</p>
      <p>
        Rank Abundance Curves A rank abundance curve visualizes the distribution of retrieved
species in the event log and provides a graphical representation of distribution characteristics
and the diversity of the event log. It serves as the basis for following species analysis tasks.
Diversity Profile A diversity profile summarizes the diversity of an event log and the
estimated diversity of the complete system. Currently, SpeciAL4PM captures the diversity profile
of an event log using observed Hill numbers and estimated asymptotic Hill numbers [
        <xref ref-type="bibr" rid="ref4">4</xref>
        ]. Hill
numbers are a set of measures parameterized by a diversity order , that quantifies diferent
aspects of an event log’s diversity. Intuitively, the larger , the more emphasis is put on the
most frequent species. The Hill number of order  = 0 equals species richness, i.e. the number
of observed distinct species in the event log and the number of estimated distinct species in
the system. Hill numbers of order  = 1 and  = 2 correspond to the exponential of Shannon
Entropy and the Inverse of Simpsons Diversity Index, two commonly used diversity measures.
These can also be quantified for the observed event log and for the complete system correcting
the estimate for unobserved species.
      </p>
      <p>
        Completeness Profile Based on the rank abundance curve, a completeness profile quantifies
the completeness of the event log for diferent dimensions. In particular, SpeciAL4PM allows
for the quantification of the event log’s completeness, coverage and expected sampling efort .
Completeness quantifies the fraction of expected species in the system, that are observed in the
event log, while coverage quantifies the probability space of all species, that the observed species
in the log take up. Both measures capture completeness in absolute and relative dimensions.
Lastly, SpeciAL4PM allows the estimation of the expected additional sampling efort needed
until the log reaches a target completeness. All measures, sample-based and estimated, are
implemented using the common sampling models, i.e. the abundance data model and the
incidence data model, as described in [
        <xref ref-type="bibr" rid="ref3">3</xref>
        ], and the expected diference between both models is
quantified.
      </p>
      <p>
        In Figure 2, we illustrate how to calculate and assess the profiles and curves for the publicly
available Sepsis Cases event log [
        <xref ref-type="bibr" rid="ref5">5</xref>
        ] using SpeciAL4PM . First, an estimator object is created
(line 9), specifying after how many traces the proposed metrics shall be updated. Then, two
species retrieval functions are registered (lines 12-13), one considering activities per trace, and
one considering directly-follows relations per trace, before the profiles and rank abundance
curves for both species retrieval functions are computed (lines 6 and 16). Finally, the obtained
measures can be printed (line 19), saved to a pandas data frame (line 21) or visualized (lines
23-25). The obtained profiles for the directly-follows species are illustrated in Figure 3.
Additionally, SpeciAL4PM supports the considerations of only a subset of the proposed measures
and additional visualization functions not shown here.
      </p>
    </sec>
    <sec id="sec-3">
      <title>3. SpeciAL Online</title>
      <p>Additionally, for ease of use, we present SpeciAL4PM-live , a web-based tool for the main
functionalities of SpeciAL4PM , which can be used for quantifying species information of an
event log without the need for programming. Users can upload an event log, for which then</p>
    </sec>
    <sec id="sec-4">
      <title>4. Availability</title>
      <p>SpeciAL4PM is distributed via the Python Package Index1 and can be installed from the command
line interface. SpeciAL4PM-live can be accessed using a web browser.2 Furthermore, the source
code for both versions is available on GitHub3 under the MIT license. Lastly, we provide a
screencast showcasing the usage of both SpeciAL4PM and SpeciAL4PM-live .4
We intend to
update both SpeciAL4PM and SpeciAL4PM-live as new use cases for the species-based analysis
of event logs and process data emerge.</p>
    </sec>
    <sec id="sec-5">
      <title>5. Conclusion</title>
      <p>In this demo, we propose SpeciAL4PM , a library for the analysis of event logs that adopts notions
from biodiversity research. The library enables the retrieval of species from an event log, the
subsequent calculation of diversity profiles and completeness profiles, and the visualization of
species distributions and profiles.</p>
    </sec>
    <sec id="sec-6">
      <title>Acknowledgments</title>
      <p>This work was partly supported by the German Federal Ministry of Education and Research
(BMBF), grant number 16DII133 (Weizenbaum-Institute). This work received funding by the
Deutsche Forschungsgemeinschaft (DFG), FOR 5495, grant 496119880. The responsibility for
the content of this publication remains with the authors.</p>
    </sec>
  </body>
  <back>
    <ref-list>
      <ref id="ref1">
        <mixed-citation>
          [1]
          <string-name>
            <given-names>W.</given-names>
            <surname>Van Der Aalst</surname>
          </string-name>
          , Process mining,
          <source>Communications of the ACM</source>
          <volume>55</volume>
          (
          <year>2012</year>
          )
          <fpage>76</fpage>
          -
          <lpage>83</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref2">
        <mixed-citation>
          [2]
          <string-name>
            <given-names>M.</given-names>
            <surname>Kabierski</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Richter</surname>
          </string-name>
          ,
          <string-name>
            <surname>M.</surname>
          </string-name>
          <article-title>Weidlich, Addressing the log representativeness problem using species discovery</article-title>
          ,
          <source>in: 2023 5th International Conference on Process Mining (ICPM)</source>
          , IEEE,
          <year>2023</year>
          , pp.
          <fpage>65</fpage>
          -
          <lpage>72</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref3">
        <mixed-citation>
          [3]
          <string-name>
            <given-names>M.</given-names>
            <surname>Kabierski</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Richter</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Weidlich</surname>
          </string-name>
          ,
          <article-title>Quantifying and relating the completeness and diversity of process representations using species estimation</article-title>
          ,
          <source>Available at SSRN</source>
          <volume>4790484</volume>
          (
          <year>2024</year>
          ).
        </mixed-citation>
      </ref>
      <ref id="ref4">
        <mixed-citation>
          [4]
          <string-name>
            <given-names>A.</given-names>
            <surname>Chao</surname>
          </string-name>
          ,
          <string-name>
            <given-names>N. J.</given-names>
            <surname>Gotelli</surname>
          </string-name>
          ,
          <string-name>
            <given-names>T.</given-names>
            <surname>Hsieh</surname>
          </string-name>
          ,
          <string-name>
            <given-names>E. L.</given-names>
            <surname>Sander</surname>
          </string-name>
          , K. Ma,
          <string-name>
            <given-names>R. K.</given-names>
            <surname>Colwell</surname>
          </string-name>
          ,
          <string-name>
            <given-names>A. M.</given-names>
            <surname>Ellison</surname>
          </string-name>
          ,
          <article-title>Rarefaction and extrapolation with hill numbers: a framework for sampling and estimation in species diversity studies</article-title>
          ,
          <source>Ecological monographs 84</source>
          (
          <year>2014</year>
          )
          <fpage>45</fpage>
          -
          <lpage>67</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref5">
        <mixed-citation>
          [5]
          <string-name>
            <given-names>F.</given-names>
            <surname>Mannhardt</surname>
          </string-name>
          , et al.,
          <string-name>
            <surname>Sepsis</surname>
          </string-name>
          cases-event log, Eindhoven university of technology 10 (
          <year>2016</year>
          ).
        </mixed-citation>
      </ref>
    </ref-list>
  </back>
</article>