Skip to content

model

model ¤

The :class:EventLog dataclass — the OCEL 2.0 relational tables.

EventLog dataclass ¤

EventLog(
    events: DataFrame = schema.empty_events(),
    objects: DataFrame = schema.empty_objects(),
    relations: DataFrame = schema.empty_relations(),
    o2o: DataFrame = schema.empty_o2o(),
    object_changes: DataFrame = schema.empty_object_changes(),
)

Canonical ts-shape event log in OCEL 2.0 shape.

Five relational tables, mirroring the OCEL 2.0 standard:

  • events — one row per detected event (+ event attributes),
  • objects — the objects events refer to (ocel:oid / ocel:type),
  • relations — event-to-object (E2O) relations with qualifiers,
  • o2o — object-to-object relations with qualifiers,
  • object_changes — time-varying object attribute values.

objects / relations are empty when the source detector has no natural object association (e.g. a global cross-signal correlation statistic); o2o / object_changes are empty unless supplied. Use :attr:has_objects to check before calling :func:to_event_log_xes.