r4pm 0.4.0__cp38-cp38-macosx_11_0_arm64.whl

r4pm/bindings/core/process_models/object_centric/__init__.pyi

@@ -0,0 +1,6 @@
+"""Type stubs."""
+from typing import List
+
+from . import ocdfg as ocdfg
+
+__all__: List[str]

r4pm/bindings/core/process_models/object_centric/ocdfg/__init__.py

@@ -0,0 +1,5 @@
+"""Auto-generated module."""
+
+from .object_centric_dfg_struct import *
+
+__all__ = []

r4pm/bindings/core/process_models/object_centric/ocdfg/__init__.pyi

@@ -0,0 +1,6 @@
+"""Type stubs."""
+from typing import List
+
+from .object_centric_dfg_struct import *
+
+__all__: List[str]

r4pm/bindings/core/process_models/object_centric/ocdfg/object_centric_dfg_struct.py

@@ -0,0 +1,27 @@
+"""
+Auto-generated bindings for core.process_models.object_centric.ocdfg.object_centric_dfg_struct
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_dfg_from_locel(locel: str) -> Dict[str, Any]:
+    """
+    Construct a [`OCDirectlyFollowsGraph`] from an [`IndexLinkedOCEL`]
+
+    Args:
+        locel: Registry ID for IndexLinkedOCEL
+
+    Returns:
+        Dict[str, Any]
+    """
+    import json
+    from ......r4pm import call_binding
+    args_dict = {}
+    args_dict["locel"] = locel
+    result = call_binding("process_mining::core::process_models::object_centric::ocdfg::object_centric_dfg_struct::discover_dfg_from_locel", json.dumps(args_dict))
+    return json.loads(result)
+
+__all__ = [
+    "discover_dfg_from_locel",
+]

r4pm/bindings/core/process_models/object_centric/ocdfg/object_centric_dfg_struct.pyi

@@ -0,0 +1,20 @@
+"""
+Type stubs for core.process_models.object_centric.ocdfg.object_centric_dfg_struct
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_dfg_from_locel(locel: str) -> Dict[str, Any]:
+    """
+    Construct a [`OCDirectlyFollowsGraph`] from an [`IndexLinkedOCEL`]
+
+    Args:
+        locel: Registry ID for IndexLinkedOCEL
+
+    Returns:
+        Dict[str, Any]
+    """
+    ...
+
+__all__: List[str]

r4pm/bindings/discovery/__init__.py

@@ -0,0 +1,6 @@
+"""Auto-generated module."""
+
+from . import case_centric
+from . import object_centric
+
+__all__ = ["case_centric", "object_centric"]

r4pm/bindings/discovery/__init__.pyi

@@ -0,0 +1,7 @@
+"""Type stubs."""
+from typing import List
+
+from . import case_centric as case_centric
+from . import object_centric as object_centric
+
+__all__: List[str]

r4pm/bindings/discovery/case_centric/__init__.py

@@ -0,0 +1,6 @@
+"""Auto-generated module."""
+
+from . import alphappp
+from .dfg import *
+
+__all__ = ["alphappp"]

r4pm/bindings/discovery/case_centric/__init__.pyi

@@ -0,0 +1,7 @@
+"""Type stubs."""
+from typing import List
+
+from . import alphappp as alphappp
+from .dfg import *
+
+__all__: List[str]

r4pm/bindings/discovery/case_centric/alphappp/__init__.py

@@ -0,0 +1,5 @@
+"""Auto-generated module."""
+
+from .full import *
+
+__all__ = []

r4pm/bindings/discovery/case_centric/alphappp/__init__.pyi

@@ -0,0 +1,6 @@
+"""Type stubs."""
+from typing import List
+
+from .full import *
+
+__all__: List[str]

r4pm/bindings/discovery/case_centric/alphappp/full.py

@@ -0,0 +1,30 @@
+"""
+Auto-generated bindings for discovery.case_centric.alphappp.full
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_alphaplusplusplus(log_proj: str, config: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """
+    Discover a [`PetriNet`] using the Alpha+++ Process Discovery algorithm
+
+    Args:
+        log_proj: Registry ID for EventLogActivityProjection
+        config: Algorithm parameters for Alpha+++
+
+    Returns:
+        Dict[str, Any]
+    """
+    import json
+    from .....r4pm import call_binding
+    args_dict = {}
+    args_dict["log_proj"] = log_proj
+    if config is not None:
+        args_dict["config"] = config
+    result = call_binding("process_mining::discovery::case_centric::alphappp::full::alphappp_discover_petri_net", json.dumps(args_dict))
+    return json.loads(result)
+
+__all__ = [
+    "discover_alphaplusplusplus",
+]

r4pm/bindings/discovery/case_centric/alphappp/full.pyi

@@ -0,0 +1,21 @@
+"""
+Type stubs for discovery.case_centric.alphappp.full
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_alphaplusplusplus(log_proj: str, config: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """
+    Discover a [`PetriNet`] using the Alpha+++ Process Discovery algorithm
+
+    Args:
+        log_proj: Registry ID for EventLogActivityProjection
+        config: Algorithm parameters for Alpha+++
+
+    Returns:
+        Dict[str, Any]
+    """
+    ...
+
+__all__: List[str]

r4pm/bindings/discovery/case_centric/dfg.py

@@ -0,0 +1,27 @@
+"""
+Auto-generated bindings for discovery.case_centric.dfg
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_dfg(event_log: str) -> Dict[str, Any]:
+    """
+    Discover [`DirectlyFollowsGraph`] with default classifier
+
+    Args:
+        event_log: Registry ID for EventLog
+
+    Returns:
+        Dict[str, Any]
+    """
+    import json
+    from ....r4pm import call_binding
+    args_dict = {}
+    args_dict["event_log"] = event_log
+    result = call_binding("process_mining::discovery::case_centric::dfg::discover_dfg", json.dumps(args_dict))
+    return json.loads(result)
+
+__all__ = [
+    "discover_dfg",
+]

r4pm/bindings/discovery/case_centric/dfg.pyi

@@ -0,0 +1,20 @@
+"""
+Type stubs for discovery.case_centric.dfg
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_dfg(event_log: str) -> Dict[str, Any]:
+    """
+    Discover [`DirectlyFollowsGraph`] with default classifier
+
+    Args:
+        event_log: Registry ID for EventLog
+
+    Returns:
+        Dict[str, Any]
+    """
+    ...
+
+__all__: List[str]

r4pm/bindings/discovery/object_centric/__init__.py

@@ -0,0 +1,5 @@
+"""Auto-generated module."""
+
+from .oc_declare import *
+
+__all__ = []

r4pm/bindings/discovery/object_centric/__init__.pyi

@@ -0,0 +1,6 @@
+"""Type stubs."""
+from typing import List
+
+from .oc_declare import *
+
+__all__: List[str]

r4pm/bindings/discovery/object_centric/oc_declare.py

@@ -0,0 +1,30 @@
+"""
+Auto-generated bindings for discovery.object_centric.oc_declare
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_oc_declare(locel: str, options: Optional[Dict[str, Any]] = None) -> List[Any]:
+    """
+    Discover behavioral OC-DECLARE constraints
+
+    Args:
+        locel: Registry ID for SlimLinkedOCEL
+        options: Options for the automatic discovery of OC-DECLARE constraints
+
+    Returns:
+        List[Any]
+    """
+    import json
+    from ....r4pm import call_binding
+    args_dict = {}
+    args_dict["locel"] = locel
+    if options is not None:
+        args_dict["options"] = options
+    result = call_binding("process_mining::discovery::object_centric::oc_declare::discover_behavior_constraints", json.dumps(args_dict))
+    return json.loads(result)
+
+__all__ = [
+    "discover_oc_declare",
+]

r4pm/bindings/discovery/object_centric/oc_declare.pyi

@@ -0,0 +1,21 @@
+"""
+Type stubs for discovery.object_centric.oc_declare
+
+DO NOT EDIT - Generated by build.rs
+"""
+from typing import Any, Dict, List, Optional
+
+def discover_oc_declare(locel: str, options: Optional[Dict[str, Any]] = None) -> List[Any]:
+    """
+    Discover behavioral OC-DECLARE constraints
+
+    Args:
+        locel: Registry ID for SlimLinkedOCEL
+        options: Options for the automatic discovery of OC-DECLARE constraints
+
+    Returns:
+        List[Any]
+    """
+    ...
+
+__all__: List[str]

r4pm/df/__init__.py

@@ -0,0 +1,20 @@
+"""
+Simple DataFrame API for r4pm
+
+Import/Export:
+    - import_xes, export_xes: XES event logs
+    - import_ocel, import_ocel_pm4py, ...: OCEL2 object-centric logs
+"""
+from .ocel_import import (
+    import_ocel,
+    import_ocel_pm4py,
+    import_ocel_xml, 
+    import_ocel_xml_pm4py, 
+    import_ocel_json, 
+    import_ocel_json_pm4py, 
+    rs_ocel_to_pm4py
+)
+from .ocel_export import export_ocel, export_ocel_pm4py
+
+from .xes_import import import_xes
+from .xes_export import export_xes

r4pm/df/__init__.pyi

@@ -0,0 +1,116 @@
+from typing import Any, Dict, Optional
+import polars as pl
+
+# ============================================================================
+# XES Import/Export
+# ============================================================================
+
+def import_xes(
+    path: str,
+    date_format: Optional[str] = None,
+    print_debug: Optional[bool] = None
+) -> tuple[pl.DataFrame, str]:
+    """
+    Import XES event log.
+    
+    Args:
+        path: Path to .xes or .xes.gz file
+        date_format: Optional date format for parsing (see chrono strftime)
+        print_debug: Enable debug output
+    
+    Returns:
+        Tuple of (DataFrame with events, JSON string with log metadata)
+    """
+    ...
+
+def export_xes(df: pl.DataFrame, path: str) -> None:
+    """
+    Export DataFrame as XES file.
+    
+    Args:
+        df: Polars DataFrame with event data
+        path: Output path (.xes or .xes.gz)
+    """
+    ...
+
+# ============================================================================
+# OCEL Import
+# ============================================================================
+
+def rs_ocel_to_pm4py(ocel_rs: Dict[str, pl.DataFrame]) -> Any:
+    """
+    Convert Polars OCEL DataFrames to PM4PY OCEL object.
+    
+    Args:
+        ocel_rs: Dict of DataFrames from import_ocel_xml/json
+    
+    Returns:
+        PM4PY OCEL object
+    """
+    ...
+
+def import_ocel_xml(path: str) -> Dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from XML.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    ...
+
+def import_ocel_xml_pm4py(path: str) -> Any:
+    """
+    Import OCEL2 XML and convert to PM4PY format.
+    """
+    ...
+
+def import_ocel_json(path: str) -> Dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from JSON.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    ...
+
+def import_ocel_json_pm4py(path: str) -> Any:
+    """
+    Import OCEL2 JSON and convert to PM4PY format.
+    """
+    ...
+
+def import_ocel(path: str) -> dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from File.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    ...
+
+def import_ocel_pm4py(path: str):
+    """Import OCEL2 JSON and convert to PM4PY format."""
+    ...
+
+
+def export_ocel(ocel: dict[str, pl.DataFrame], path: str):
+    """
+    Export Polars OCEL DataFrames to File
+    
+    Args:
+        ocel: Dict of DataFrames from import_ocel_xml/json
+        path: Output path (e.g., .ocel.xml or .ocel.json)
+    
+    """
+    ...
+
+def export_ocel_pm4py(ocel, path: str):
+    """
+    Export PM4Py OCEL to File
+    
+    Args:
+        ocel: PM4Py OCEL object
+        path: Output path (e.g., .ocel.xml or .ocel.json)
+    
+    """
+    ...

r4pm/df/ocel_export.py

@@ -0,0 +1,33 @@
+import polars
+
+from ..r4pm import export_ocel_rs
+
+def export_ocel(ocel: dict[str, polars.DataFrame], path: str):
+    """
+    Export Polars OCEL DataFrames to File
+    
+    Args:
+        ocel: Dict of DataFrames from import_ocel_xml/json
+        path: Output path (e.g., .ocel.xml or .ocel.json)
+    
+    """
+    export_ocel_rs(ocel, path)
+
+
+def export_ocel_pm4py(ocel, path: str):
+    """
+    Export PM4Py OCEL to File
+    
+    Args:
+        ocel: PM4Py OCEL object
+        path: Output path (e.g., .ocel.xml or .ocel.json)
+    
+    """
+    ocel = {
+        "events": polars.from_pandas(ocel.events),
+        "objects": polars.from_pandas(ocel.objects),
+        "relations": polars.from_pandas(ocel.relations),
+        "object_changes": polars.from_pandas(ocel.object_changes),
+        "o2o": polars.from_pandas(ocel.o2o),
+    }
+    export_ocel_rs(ocel, path)

r4pm/df/ocel_import.py

@@ -0,0 +1,72 @@
+import polars as pl
+
+from ..r4pm import import_ocel_xml_rs, import_ocel_json_rs, import_ocel_rs
+
+def rs_ocel_to_pm4py(ocel_rs: dict[str, pl.DataFrame]):
+    """
+    Convert Polars OCEL DataFrames to PM4PY OCEL object.
+    
+    Args:
+        ocel_rs: Dict of DataFrames from import_ocel_xml/json
+    
+    Returns:
+        PM4PY OCEL object
+    """
+    import pm4py
+    ocel_pm4py = pm4py.ocel.OCEL(
+        events=ocel_rs["events"].to_pandas().convert_dtypes(),
+        objects=ocel_rs["objects"].to_pandas().convert_dtypes(),
+        relations=ocel_rs["relations"].to_pandas().convert_dtypes(),
+        object_changes=ocel_rs["object_changes"].to_pandas().convert_dtypes(),
+        globals={},
+        o2o=ocel_rs["o2o"].to_pandas().convert_dtypes(),
+        parameters={
+            pm4py.objects.ocel.obj.Parameters.EVENT_ID: "ocel:eid",
+            pm4py.objects.ocel.obj.Parameters.EVENT_ACTIVITY: "ocel:activity",
+            pm4py.objects.ocel.obj.Parameters.EVENT_TIMESTAMP: "ocel:timestamp",
+            pm4py.objects.ocel.obj.Parameters.OBJECT_ID: "ocel:oid",
+            pm4py.objects.ocel.obj.Parameters.OBJECT_TYPE: "ocel:type",
+            pm4py.objects.ocel.obj.Parameters.QUALIFIER: "ocel:qualifier",
+            pm4py.objects.ocel.obj.Parameters.CHANGED_FIELD: "ocel:field",
+        },
+    )
+    return ocel_pm4py
+
+def import_ocel_xml(path: str) -> dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from XML.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    return import_ocel_xml_rs(path)
+
+def import_ocel_xml_pm4py(path: str):
+    """Import OCEL2 XML and convert to PM4PY format."""
+    return rs_ocel_to_pm4py(import_ocel_xml(path))
+
+def import_ocel_json(path: str) -> dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from JSON.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    return import_ocel_json_rs(path)
+
+def import_ocel_json_pm4py(path: str):
+    """Import OCEL2 JSON and convert to PM4PY format."""
+    return rs_ocel_to_pm4py(import_ocel_json(path))
+
+def import_ocel(path: str) -> dict[str, pl.DataFrame]:
+    """
+    Import OCEL2 from File.
+    
+    Returns:
+        Dict with DataFrames: 'events', 'objects', 'relations', 'o2o', 'object_changes'
+    """
+    return import_ocel_rs(path)
+
+def import_ocel_pm4py(path: str):
+    """Import OCEL2 JSON and convert to PM4PY format."""
+    return rs_ocel_to_pm4py(import_ocel(path))

r4pm/df/xes_export.py

@@ -0,0 +1,13 @@
+import polars
+
+from ..r4pm import export_xes_rs
+
+def export_xes(df: polars.DataFrame, path: str):
+    """
+    Export DataFrame as XES file.
+    
+    Args:
+        df: Polars DataFrame with event data
+        path: Output path (.xes or .xes.gz)
+    """
+    return export_xes_rs(df, path)

r4pm/df/xes_import.py

@@ -0,0 +1,18 @@
+from typing import Optional
+import polars
+
+from ..r4pm import import_xes_rs
+
+def import_xes(path: str, date_format: Optional[str] = None, print_debug: Optional[bool] = None) -> tuple[polars.DataFrame, str]:
+    """
+    Import XES event log.
+    
+    Args:
+        path: Path to .xes or .xes.gz file
+        date_format: Optional date format for parsing (see chrono strftime)
+        print_debug: Enable debug output
+    
+    Returns:
+        Tuple of (DataFrame with events, JSON string with log metadata)
+    """
+    return import_xes_rs(path, date_format, print_debug)