scope-pm4py 0.1.0

PM4Py loaders for Scope OCPT and OCPN JSON exports

scope-pm4py

Small Python adapter package for loading Scope OCPT and OCPN JSON exports into PM4Py runtime objects.

Install locally

From this directory:

python -m pip install -e .

Usage

from scope_pm4py import load_ocpt, load_ocpn
import pm4py

tree = load_ocpt(r"C:\Users\Postb\Downloads\scope_ocpt_example_pm4py.json")
pm4py.view_process_tree(tree)

ocpn = load_ocpn(r"C:\Users\Postb\Downloads\scope_ocpn_example_pm4py.json")
pm4py.view_ocpn(ocpn, format="svg")

Expected JSON

The loader accepts files with a top-level payload object or files where the payload is the top-level object.

OCPT exports should contain:

{
  "schema": "scope.pm4py.ocpt",
  "schema_version": "1.0.0",
  "payload": {
    "tree": {
      "type": "operator",
      "operator": "sequence",
      "children": [
        { "type": "activity", "label": "Create Order" },
        { "type": "tau" }
      ]
    }
  }
}

OCPN exports should contain:

{
  "schema": "scope.pm4py.ocpn",
  "schema_version": "1.0.0",
  "payload": {
    "object_types": ["order"],
    "activities": ["Create Order"],
    "petri_nets": {
      "order": {
        "places": [
          { "id": "p1", "name": "source", "initial": true },
          { "id": "p2", "name": "sink", "final": true }
        ],
        "transitions": [
          { "id": "t1", "name": "Create Order", "label": "Create Order" }
        ],
        "arcs": [
          { "source": "p1", "target": "t1" },
          { "source": "t1", "target": "p2" }
        ]
      }
    }
  }
}

The OCPN loader reconstructs PM4Py PetriNet and Marking objects. A plain json.load() result is not enough for PM4Py visualization and analysis.

Build

From this directory:

python -m pip install build
python -m build

This creates:

dist/
  scope_pm4py-0.1.0-py3-none-any.whl
  scope_pm4py-0.1.0.tar.gz

Publish to PyPI

Create accounts on:

• TestPyPI: https://test.pypi.org/
• PyPI: https://pypi.org/

Create an API token in the account settings. Then install Twine:

python -m pip install twine

Validate the build artifacts:

python -m twine check dist/*

Upload to TestPyPI first:

python -m twine upload --repository testpypi dist/*

Install from TestPyPI in a clean environment:

python -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ scope-pm4py

If that works, upload to the real PyPI:

python -m twine upload dist/*

After publishing, users install it with:

python -m pip install scope-pm4py