event-log-converter's Introduction

Event Log Converter

CLI tool to convert event logs from one format to another fast and efficiently.

Supports the following conversions:

XES to CSV
CSV to XES

Usage

$ event-log-converter -i filename.xes xes-to-csv

More on usage:

Usage: event_log_converter [OPTIONS] --input-log <INPUT_LOG> <COMMAND>

Commands:
  xes-to-csv  
  csv-to-xes  
  help        Print this message or the help of the given subcommand(s)

Options:
  -i, --input-log <INPUT_LOG>    The input event log path
  -o, --output-dir <OUTPUT_DIR>  The output directory for the converted log [default: .]
  -n, --no-start-events          Filter out Start and End events if present in the log
  -c, --case <CASE>              Case ID column name [default: case]
  -a, --activity <ACTIVITY>      Activity column name [default: activity]
  -r, --resource <RESOURCE>      Resource column name [default: resource]
  -s, --start-time <START_TIME>  Start timestamp column name [default: start_time]
  -e, --end-time <END_TIME>      End timestamp column name [default: end_time]
  -v, --variant <VARIANT>        Variant column name [default: variant]
  -h, --help                     Print help information
  -V, --version                  Print version information

Runtime Performance

15x improvement over pm4py in runtime.

A simplistic comparison of running time for the conversion of a 175 MB XES file to CSV and back to XES:

Tool	Conversion Type	User Time	System Time	CPU Usage	Total Time
pm4py_wrapper	XES to CSV	15.20s	4.85s	111%	17.943s
pm4py_wrapper	CSV to XES	28.33s	5.28s	113%	29.682s
event_log_converter	XES to CSV	1.01s	0.11s	99%	1.129s
event_log_converter	CSV to XES	0.77s	0.19s	99%	0.966s