# pm4py
pm4py is a python library that supports (state-of-the-art) process mining algorithms in python.
It is open source (licensed under GPL) and intended to be used in both academia and industry projects.
pm4py is a product of the Fraunhofer Institute for Applied Information Technology.
## Documentation / API
The full documentation of pm4py can be found at https://pm4py.fit.fraunhofer.de
## First Example
A very simple example, to whet your appetite:
import pm4py
if __name__ == "__main__":
log = pm4py.read_xes('<path-to-xes-log-file.xes>')
net, initial_marking, final_marking = pm4py.discover_petri_net_inductive(log)
pm4py.view_petri_net(net, initial_marking, final_marking, format="svg")
## Installation
pm4py can be installed on Python 3.9.x / 3.10.x / 3.11.x / 3.12.x by invoking:
*pip install -U pm4py*
pm4py is also running on older Python environments with different requirements sets, including:
- Python 3.8 (3.8.10): third_party/old_python_deps/requirements_py38.txt
## Requirements
pm4py depends on some other Python packages, with different levels of importance:
* *Essential requirements*: numpy, pandas, deprecation, networkx
* *Normal requirements* (installed by default with the pm4py package, important for mainstream usage): graphviz, intervaltree, lxml, matplotlib, pydotplus, pytz, scipy, stringdist, tqdm
* *Optional requirements* (not installed by default): scikit-learn, pyemd, pyvis, jsonschema, polars, openai, pywin32, python-dateutil, requests, workalendar, pygetwindow, pynput
## Release Notes
To track the incremental updates, please refer to the *CHANGELOG* file.
## Third Party Dependencies
As scientific library in the Python ecosystem, we rely on external libraries to offer our features.
In the */third_party* folder, we list all the licenses of our direct dependencies.
Please check the */third_party/LICENSES_TRANSITIVE* file to get a full list of all transitive dependencies and the corresponding license.
## Citing pm4py
If you are using pm4py in your scientific work, please cite pm4py as follows:
**Alessandro Berti, Sebastiaan van Zelst, Daniel Schuster**. (2023). *PM4Py: A process mining library for Python*. Software Impacts, 17, 100556. [DOI](https://doi.org/10.1016/j.simpa.2023.100556) | [Article Link](https://www.sciencedirect.com/science/article/pii/S2665963823000933)
BiBTeX:
@article{pm4py,
title = {PM4Py: A process mining library for Python},
journal = {Software Impacts},
volume = {17},
pages = {100556},
year = {2023},
issn = {2665-9638},
doi = {https://doi.org/10.1016/j.simpa.2023.100556},
url = {https://www.sciencedirect.com/science/article/pii/S2665963823000933},
author = {Alessandro Berti and Sebastiaan van Zelst and Daniel Schuster},
}
Raw data
{
"_id": null,
"home_page": "https://pm4py.fit.fraunhofer.de",
"name": "pm4py",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Fraunhofer Institute for Applied Information Technology FIT",
"author_email": "pm4py@fit.fraunhofer.de",
"download_url": "https://files.pythonhosted.org/packages/37/6c/2778b0eaa837e251f1c4cc06cc207cd38ec59fb4e3e792fa0b5c04327ba7/pm4py-2.7.11.6.tar.gz",
"platform": null,
"description": "# pm4py\r\npm4py is a python library that supports (state-of-the-art) process mining algorithms in python. \r\nIt is open source (licensed under GPL) and intended to be used in both academia and industry projects.\r\npm4py is a product of the Fraunhofer Institute for Applied Information Technology.\r\n\r\n## Documentation / API\r\nThe full documentation of pm4py can be found at https://pm4py.fit.fraunhofer.de\r\n\r\n## First Example\r\nA very simple example, to whet your appetite:\r\n\r\nimport pm4py\r\n\r\nif __name__ == \"__main__\":\r\n log = pm4py.read_xes('<path-to-xes-log-file.xes>')\r\n net, initial_marking, final_marking = pm4py.discover_petri_net_inductive(log)\r\n pm4py.view_petri_net(net, initial_marking, final_marking, format=\"svg\")\r\n\r\n## Installation\r\npm4py can be installed on Python 3.9.x / 3.10.x / 3.11.x / 3.12.x by invoking:\r\n*pip install -U pm4py*\r\n\r\npm4py is also running on older Python environments with different requirements sets, including:\r\n- Python 3.8 (3.8.10): third_party/old_python_deps/requirements_py38.txt\r\n\r\n## Requirements\r\npm4py depends on some other Python packages, with different levels of importance:\r\n* *Essential requirements*: numpy, pandas, deprecation, networkx\r\n* *Normal requirements* (installed by default with the pm4py package, important for mainstream usage): graphviz, intervaltree, lxml, matplotlib, pydotplus, pytz, scipy, stringdist, tqdm\r\n* *Optional requirements* (not installed by default): scikit-learn, pyemd, pyvis, jsonschema, polars, openai, pywin32, python-dateutil, requests, workalendar, pygetwindow, pynput\r\n\r\n## Release Notes\r\nTo track the incremental updates, please refer to the *CHANGELOG* file.\r\n\r\n## Third Party Dependencies\r\nAs scientific library in the Python ecosystem, we rely on external libraries to offer our features.\r\nIn the */third_party* folder, we list all the licenses of our direct dependencies.\r\nPlease check the */third_party/LICENSES_TRANSITIVE* file to get a full list of all transitive dependencies and the corresponding license.\r\n\r\n## Citing pm4py\r\nIf you are using pm4py in your scientific work, please cite pm4py as follows:\r\n\r\n**Alessandro Berti, Sebastiaan van Zelst, Daniel Schuster**. (2023). *PM4Py: A process mining library for Python*. Software Impacts, 17, 100556. [DOI](https://doi.org/10.1016/j.simpa.2023.100556) | [Article Link](https://www.sciencedirect.com/science/article/pii/S2665963823000933)\r\n\r\nBiBTeX:\r\n\r\n@article{pm4py, \r\ntitle = {PM4Py: A process mining library for Python}, \r\njournal = {Software Impacts}, \r\nvolume = {17}, \r\npages = {100556}, \r\nyear = {2023}, \r\nissn = {2665-9638}, \r\ndoi = {https://doi.org/10.1016/j.simpa.2023.100556}, \r\nurl = {https://www.sciencedirect.com/science/article/pii/S2665963823000933}, \r\nauthor = {Alessandro Berti and Sebastiaan van Zelst and Daniel Schuster}, \r\n}\r\n\r\n",
"bugtrack_url": null,
"license": "GPL 3.0",
"summary": "Process mining for Python",
"version": "2.7.11.6",
"project_urls": {
"Documentation": "https://pm4py.fit.fraunhofer.de",
"Homepage": "https://pm4py.fit.fraunhofer.de",
"Source": "https://github.com/pm4py/pm4py-source",
"Tracker": "https://github.com/pm4py/pm4py-source/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "63ff50229fd9801fcff8791dd46b4c9f626533b8248042a53bfb12c667ef9d9d",
"md5": "ccd979a061cbe6e35d68c0739762db67",
"sha256": "9fb8e088873282b3b809807e74b25bbef3745267b6e6531c512b84bd013377d0"
},
"downloads": -1,
"filename": "pm4py-2.7.11.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccd979a061cbe6e35d68c0739762db67",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1871743,
"upload_time": "2024-04-11T05:58:11",
"upload_time_iso_8601": "2024-04-11T05:58:11.518988Z",
"url": "https://files.pythonhosted.org/packages/63/ff/50229fd9801fcff8791dd46b4c9f626533b8248042a53bfb12c667ef9d9d/pm4py-2.7.11.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "376c2778b0eaa837e251f1c4cc06cc207cd38ec59fb4e3e792fa0b5c04327ba7",
"md5": "d2bf3847ef6941081465ec7f0bad0d01",
"sha256": "fee6996518c60f69d2a43065977424c041dc6ca4533572edea0cbc686c83b418"
},
"downloads": -1,
"filename": "pm4py-2.7.11.6.tar.gz",
"has_sig": false,
"md5_digest": "d2bf3847ef6941081465ec7f0bad0d01",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 793191,
"upload_time": "2024-04-11T05:58:16",
"upload_time_iso_8601": "2024-04-11T05:58:16.834533Z",
"url": "https://files.pythonhosted.org/packages/37/6c/2778b0eaa837e251f1c4cc06cc207cd38ec59fb4e3e792fa0b5c04327ba7/pm4py-2.7.11.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-11 05:58:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pm4py",
"github_project": "pm4py-source",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pm4py"
}
JSON
