pm4py.convert.convert_log_to_ocel

pm4py.convert.convert_log_to_ocel(log: EventLog | EventStream | DataFrame, activity_column: str = 'concept:name', timestamp_column: str = 'time:timestamp', object_types: Collection[str] | None = None, obj_separator: str = ' AND ', additional_event_attributes: Collection[str] | None = None, additional_object_attributes: Dict[str, Collection[str]] | None = None) → OCEL

Converts an event log to an object-centric event log (OCEL) with one or more object types.

Return type:

OCEL

Parameters:

• log – The log object to convert.

• activity_column (str) – The name of the column representing activities.

• timestamp_column (str) – The name of the column representing timestamps.

• object_types – A collection of column names to consider as object types. If None, defaults are used.

• obj_separator (str) – The separator used between different objects in the same column. Defaults to “ AND “.

• additional_event_attributes – Additional attribute names to include as event attributes in the OCEL.

• additional_object_attributes – Additional attributes per object type to include as object attributes in the OCEL. Should be a dictionary mapping object types to lists of attribute names.

Returns:

An OCEL object.