pm4py.algo.merging.case_relations.algorithm 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.merging.case_relations.algorithm.Variants(*values)[source]#

Bases: Enum

PANDAS = <module 'pm4py.algo.merging.case_relations.variants.pandas' from '/home/javert/ALE/pm4py/pm4py/algo/merging/case_relations/variants/pandas.py'>#
pm4py.algo.merging.case_relations.algorithm.apply(dataframe1: DataFrame, dataframe2: DataFrame, case_relations: DataFrame, variant=Variants.PANDAS, parameters: Dict[Any, Any] | None = None) → DataFrame[source]#

Merges the two dataframes (dataframe1 and dataframe2), inserting the events of the second dataframe inside the cases of the first dataframe. This is done using a background knowledge provided in the case_relations dataframe, where the cases of the two dataframes are put in relations. E.g., if in dataframe1 and dataframe2 there are two case ID columns (case:concept:name), they are put in relations by case_relations having two columns case:concept:name_LEFT and case:concept:name_RIGHT

Parameters:

  • dataframe1 – Reference dataframe (in which the events of the other dataframe are inserted)

  • dataframe2 – Second dataframe (to insert in the cases of the first)

  • case_relations – Case relations dataframe

  • variant –

    Variant of the algorithm to use, available ones:

    • Variants.PANDAS

  • parameters – Variant-specific parameters

Returns:

Merged dataframe

Return type:

merged_dataframe