pm4py.algo.discovery.batches.utils.detection 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

class pm4py.algo.discovery.batches.utils.detection.Parameters(*values)[source]#

Bases: Enum

MERGE_DISTANCE = 'merge_distance'#
MIN_BATCH_SIZE = 'min_batch_size'#
class pm4py.algo.discovery.batches.utils.detection.BatchType(*values)[source]#

Bases: Enum

SIMULTANEOUS = 'Simultaneous'#
BATCHING_START = 'Batching on Start'#
BATCHING_END = 'Batching on End'#
SEQ_BATCHING = 'Sequential batching'#
CONC_BATCHING = 'Concurrent batching'#
pm4py.algo.discovery.batches.utils.detection.detect(actres_grouping: Dict[Tuple[str, str], List[Tuple[float, float, str]]], parameters: Dict[str | Parameters, Any] | None = None) → List[Tuple[Tuple[str, str], int, Dict[str, Any]]][source]#

Provided an activity-resource grouping of the events of the event log, returns.

a list having as elements the activity-resources with the batches that are detected, divided in:

  • Simultaneous (all the events in the batch have identical start and end timestamps)

  • Batching at start (all the events in the batch have identical start timestamp)

  • Batching at end (all the events in the batch have identical end timestamp)

  • Sequential batching (for all the consecutive events, the end of the first is equal to the start of the second)

  • Concurrent batching (for all the consecutive events that are not sequentially matched)

The approach has been described in the following paper: Martin, N., Swennen, M., Depaire, B., Jans, M., Caris, A., & Vanhoof, K. (2015, December). Batch Processing: Definition and Event Log Identification. In SIMPDA (pp. 137-140).

Parameters:

  • actres_grouping – Activity-resource grouping of events

  • parameters – Parameters of the algorithm

Returns:

A (sorted) list containing tuples. Each tuple contain:

  • Index 0: the activity-resource for which at least one batch has been detected

  • Index 1: the number of batches for the given activity-resource

  • Index 2: a list containing all the batches. Each batch is described by:

    • The start timestamp of the batch

    • The complete timestamp of the batch

    • The list of events that are executed in the batch

Return type:

list_batches