Skip to content

A simulation framework for synthetic event-log data, based on theoretical processes.

License

Notifications You must be signed in to change notification settings

Mikeriess/SynBPS

Repository files navigation

SynBPS

Downloads Documentation Status

SynBPS is short for Synthetic Business Process Simulation, as it is intended for the simulation of synthetic business processes. Put simply, this framework lets you run experiments across multiple business processes, sampled from well-known parametric distributions.

Publication: Riess (2024)

How?

The intended usage of this software is to benchmark new methods within predictive process monitoring research. Rather than calibrating a simulation model from an existing process (as in existing frameworks), the aim is to simulate theoretical processes with varying degrees of noise in duration distributions and entropy in the control-flow. The framework uses algorithms (described in the publication), Higher-order Markov Chains (HOMC) and the Hypo-exponential distribution to represent temporal dependency (or its absence) in conditional duration distributions.

image

Why?

The benefit of SynBPS is in the transparency (and simplicity) of the data generating process, which can help further understand the influence of process characteristics on predictive performance. By e.g. changing the entropy of the process, SynBPS lets you compare the difference in predictive performance across everything between predictable to completely chaotic processes.

Getting Started

You can install SynBPS using pip:

pip install SynBPS

SynBPS requires pomegranate 0.14.8 and python 3.9 or higher.

Example usage

See the example notebook for a short demo of SynBPS.

Documentation

See the official documentation here.

Todos

  • Extend HOMC to include h > 4
  • Add functionality to specify sampling approach of HOMC
  • Add data pre-processing in more formats

Citation

If you use SynBPS, please cite the corresponding paper. The paper can be cited as:

@article{riess2024synbps,
	title={SynBPS: a parametric simulation framework for the generation of event-log data},
	author={Riess, Mike},
	journal={SIMULATION},
	pages={00375497241233326},
	year={2024},
	publisher={SAGE Publications Sage UK: London, England}
}

Contributing

If you would like to contribute to SynBPS, you are welcome to submit your suggestions, bug reports, or pull requests. Follow the guidelines below to ensure smooth collaboration:

  • Before submitting a new feature request or bug report, please check the existing issues to avoid duplicates.
  • If you have a new feature idea, open an issue to discuss it with the maintainers and get feedback.
  • For bug reports, provide a clear and concise description of the issue, including steps to reproduce it.
  • If your contribution requires documentation changes, please update the documentation accordingly.
  • Be respectful and considerate towards others in your interactions on the project.

About

A simulation framework for synthetic event-log data, based on theoretical processes.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published