New Filter Notebook plugin

How to start a Filter Notebook?

Make sure you have the latest version of the FilterBook package installed. Select an event log (we use the BPI Challenge 2012 log here), open a visualizer, and then select the “Start Filter Notebook” visualizer:

What do I see in a Filter Notebook?

  1. A button bar that may contain the following buttons:
    • Recompute notebook: Recompute the entire notebook by recomputing all computation cells from top to bottom
    • Create notebook template: Create a notebook template for the notebook and exports this template into the workspace. This template can be exported and imported.
    • Add computation cell here: Add a computation cell at this position.
    • Add text cell here: Add a text cell at this position.
    • Swap cells: Swap the cell above with the cell below. If the cell below uses the output log of the cell above as input log, it will be set to the input log of the computation cell.
    • Remove cell below: Remove the cell below. If any of the following cells use the output log of this cell as input log, they will be set to the input log of the computation cell.
  2. If the computation cell needs to be recomputed and can be recomputed, a button will appear here to do so. A computation cell cannot be recomputed if its input log is not yet available.
  3. The name of the computation cell. Click the name to start editing it.
  4. A button to export the output log of the computation cell into the workspace.
  5. The current stack of filters. The last option in this stack is always the option to add a filter to the stack. If there are any preceding computation cells, the top part of this area is used to allow the user to select an input log from the output logs of these preceding computation cells and the input log of the computation cell.
  6. A button to show or hide the filter stack. By default, the filter stack is shown.
  7. The visualization of the output log of the computation cell.
  8. A button to show or hide the visualizers list. By default, the visualizers list is shown.
  9. The list of possible visualizers. By default, the “Explore Event Log” visualizer is selected.

How can I add a filter?

Select the “Add filter…” item in the filter stack. This replaces the visualization of the output log with the list of filters:

This list only shows the filters that can accept the input log. For example, if there are no timestamps in the event log, then the “Select on date” filter will not show.

Select the filter that you would like to add. This replaces the filter list with the configuration panel for that filter:

At the top left, three buttons are shown that can be used to move the filer up or down in the stack, or to remove the filter from the stack. To the right of these buttons, the name of the filter is shown. Below, the filter can be configured. For this particular filter, we can select:

  1. the global attribute to use (left hand side),
  2. the selected values for the global attribute (right hand side), and
  3. whether the selected values are filtered in (leaving only those traces that start with a selected value) or filtered out (leaving only those traces that do not start with a selected value).

Also note that the “Recompute cell” button has now appeared, and that the background color of the cell name has changed to yellow. This indicates that the output log of the computation cell needs to be recomputed, and that it can be recomputed. If it cannot be recomputed, the button will not show and the background color will be blue.

Select the “Recompute cell” button to recompute the output log. This replaces the filter configuration panel with the visualization of the new output log:


Leave a Reply