Sander Leemans

The FilterTree Editor offers an advanced, fast and repeatable way to prepare event logs for analysis. Simply provide the name of the event log (CSV, XES or compressed XES) and type in the filters you'd like to apply.

screenshot of the FilterTree Editor

The filters work on a disk-to-disk basis by avoiding to load the log in memory where possible, thus are able to handle large logs that would not fit in memory. Event classifiers, XES extensions, global trace and event attributes, and log attributes are supported. Furthermore, if two different sets of filters are to be applied (for instance, to split the log in two parts), simply indent one of the branches, as shown in the last two lines of the screenshot above.

Once the log is ready, optionally a window with log views will pop up for debugging and quality control purposes:

screenshot of the FilterTree Editor

Demonstration Video

Getting Started

FilterTree requires no installation: simply download the JAR file, and run it using java -jar [downloaded file]. Java 17 is required to run FilterTree.

  1. Type the name of the input event log (that is, a path relative to the location of the FilterTree file) in the first text box.
  2. In the main text field, type the name of a filter (as shown below), followed by a space, a vertical bar (|) and another space. Then, type the parameters of the filter. If the parameters contain spaces, then put them in "double quotes". Alternatively, press ctrl+space to get a list of available filters (autocomplete). If you start with a CSV file, the filter you'll need first is "CSV to XES", as all other filters only work on XES files.
  3. Each filter goes on its own row; lines that start with % are comments. The indentation determines which intermediate event log the filter applies to.
  4. Once you stop typing, the FilterTree Editor will apply the filters in the background. Once completed, the last log is (optionally) loaded in memory and a summary visualisation will pop up.
Please note: OneDrive, Dropbox, etc. may interfere with file access on Windows. If you experience file locking issues, please use FilterTree outside of their folders.

Privacy, Security & License

The FilterTree Editor does not use internet connectivity, does not set cookies and does not track you. It does set log properties (1) "log creator" with value "FilterTree by Sander Leemans", (2) "FilterTree:last applied filter", (3) "FilterTree:last applied filter parameters" and (4) as "concept:name" the name of the initial log input file. All of these can be removed by applying the "set log attribute" filter.

The FilterTree Editor will write all results in a folder next to the FilterTree file, with the name of the FilterTree file, appended with "-filterTree result". This folder will be emptied by the FilterTree Editor on each run. The input log file must be in a directory that is a sub-directory of the directory in which the FilterTree file resides.

The source code is available on svn, with the same licence(s) as ProM itself. That is, FilterTree is licensed with the GNU General Public License ("GPL"), version 2. In a nutshell, this means that you can use the FilterTree software at no charge; you can distribute copies of the software in source or binary form; and you can sell copies of the software and sell support for the software. What this license does not allow you to do is make changes or add features and then sell a binary distribution without source code. You must provide source for any changes or additions to the software, and all code must be provided under the GPL.

Included filters

Latest updates: