pm4py.objects.log.util.log module#

PM4Py – A Process Mining Library for Python Copyright (C) 2026 Process Intelligence Solutions GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see this software project’s root or visit <https://www.gnu.org/licenses/>.

Website: https://processintelligence.solutions Contact: info@processintelligence.solutions

pm4py.objects.log.util.log.get_event_labels(event_log, key)[source]#

Fetches the labels present in a log, given a key to use within the events.

Parameters:

  • param event_log: log to use

  • param key: to use for event identification, can for example be “concept:name”

Return type:

return: a list of labels

pm4py.objects.log.util.log.get_event_labels_counted(event_log, key)[source]#

Fetches the labels (and their frequency) present in a log, given a key to use within the events.

Parameters:

  • param event_log: log to use

  • param key: to use for event identification, can for example be “concept:name”

Return type:

return: a list of labels

pm4py.objects.log.util.log.get_trace_variants(event_log, key='concept:name')[source]#

Returns a pair of a list of (variants, dict[index -> trace]) where the index of a variant maps to all traces describing that variant, with that key.

Parameters:

  • param event_log: log

  • param key: key to use to identify the label of an event

Return type:

return:

pm4py.objects.log.util.log.project_traces(event_log, keys='concept:name')[source]#

projects traces on a (set of) event attribute key(s). If the key provided is of type string, each trace is converted into a list of strings. If the key provided is a collection, each trace is converted into a list of (smaller) dicts of key value pairs

Parameters:

  • event_log

  • keys

Returns:

pm4py.objects.log.util.log.derive_and_lift_trace_attributes_from_event_attributes(trlog, ignore=None, retain_on_event_level=False, verbose=False)[source]#
pm4py.objects.log.util.log.add_artficial_start_and_end(event_log, start='[start>', end='[end]', activity_key='concept:name')[source]#