OCEL Generic Feature Extraction

Various tools and structures in order to extract the most explicit and implicit data from the OCEL event log format.

Table of Contents

1. About The Project
   • Built With
2. Installation and Usage
3. Roadmap
4. License
5. Contact

About The Project

This repository belongs to a master thesis project titled "A generic approach towards feature extraction from object-centric event logs" hosted by the PADS group at RWTH Aachen. Various methods are used in order to make extracting information from object-centric event logs simple and useful. Anyone with a valid object-centric event log should be able to use all the functions and methods defined in the repository to gather more information about their processes. Please check out some examples and if you have any questions or additional ideas, feel free to send me a message.

(back to top)

Built With

• Python 3.6+
• ocel-support
• networkx
• numpy
• pandas
• flake8

(back to top)

Installation and Usage

As this is a master thesis project, not too much effort is being put into streamlining the installation process for the code. This will perhaps be done if there is interest/I have the time after the actual graded thesis is completed. For some manual installation instructions, please see below:

1. Clone the repo

   git clone https://github.com/DerAndereJohannes/ocel-features

2. Create a new venv and install any requirements

   pip install -r requirements.txt

3. Add the ocel-features package into your PYTHONPATH environment variable (Optional: add this to your .bashrc file)

   export PYTHONPATH="/path/to/ocel-features:"$PYTHONPATH

4. Finished! Check out some examples and enjoy! :-)

(back to top)

Roadmap

The overall roadmap is far too large to be written down in this section. I have listed below the parts that I am actively working on in this repository or am planning to tackle in the near future.

• Object Features
  • Point
  • Global/Group
• Event Features
  • Point
  • Global/Group
• Situation Features
  • Based on different time perspectives
  • Based on different relations
• OCEL Structures
  • Object-Object Graphs
  • OCEL Graphs
  • Event Graphs
• Feature Series
  • Based on Log
  • Based on Graphs
• OCEL Decomposition for Local Feature Extractions
  • Decompose Log
  • Decompose General OCEL graphs
  • Decompose Time Concious Graphs

See the open issues for a full list of proposed features (and known issues). Feel free to also leave some extra ideas too!

(back to top)

License

Distributed under the GPL-3.0 License. See LICENSE.txt for more information.

(back to top)

Contact

Johannes Herforth - Website/Contact

Project Link: https://github.com/DerAndereJohannes/ocel-features

(back to top)