Sharing Tools and Artefacts for Reusable Simulation (STARS) Discrete Event Simulation Reusability Examples – The Healthcare Service Analytics & Decision Intelligence Atlas

Summary

Three examples of discrete-event simulation models implementing the STARS Reusability Framework. This includes simulation models (SimPy, ciw), web apps (streamlit, shiny) and documentation.

Rating: Silver

Scripts and packages with limited documentation, tests and maintenance.

STARS Reusability Framework

The Sharing Tools and Artefacts for Reusable Simulation (STARS) framework is described in:

Monks, T., Harper, A., & Mustafee, N. (2024). Towards sharing tools and artefacts for reusable simulations in healthcare. Journal of Simulation, 1–20. https://doi.org/10.1080/17477778.2024.2347882

It contains recommendations on how to make shared healthcare DES models for reusable - i.e., code/model can be adapted and used in next contexts.

Within the paper describing this framework, three example models are provided demonstrating compliance to the STARS recommendations.

Implementation of the framework across the three examples

Table from Monks et al. 2024:

STARS Components	Item	Applied example 1	Applied example 2	Applied example 3
Essential	Open Licence	MIT	MIT	GNU Public Licence 3
Essential	Dependency mgt	conda	conda	conda
Essential	DES software	simpy	simpy	ciw
Essential	Code repository	GitHub	GitHub	GitHub
Essential	Meta-data	citation.cff + ORCID	citation.cff + ORCID	citation.cff + ORCID
Essential	Minimum documentation	README.md	README.md	README.md
Essential	Open science repository	Zenodo	Zenodo	Zenodo
Optional	Online coding environment	Binder	Binder	Binder
Optional	Enhanced documentation	Electronic Notebook	Jupyter Book + STRESS	Quarto + STRESS
Optional	Documentation hosting		GitHub pages	GitHub pages
Optional	Model interface		streamlit	Shiny for python
Optional	Web app hosting		streamlit community cloud	shinyapps.io

Example 1

Code repository: https://github.com/pythonhealthdatascience/stars-treat-sim

DOI: https://doi.org/10.5281/zenodo.10026327

Example 2

Code repository (app): https://github.com/pythonhealthdatascience/stars-streamlit-example

Code repository (documentation): https://github.com/pythonhealthdatascience/stars-simpy-example-docs

Web app: https://stars-simpy-example.streamlit.app/

Documentation: https://pythonhealthdatascience.github.io/stars-simpy-example-docs

DOIs: https://doi.org/10.5281/zenodo.10055169 and https://doi.org/10.5281/zenodo.10054063

Example 3

Code repository: https://github.com/pythonhealthdatascience/stars-ciw-example

Web app: https://pythonhealthdatascience.shinyapps.io/stars-ciw-examplar

Documentation: https://pythonhealthdatascience.github.io/stars-ciw-example

DOI: https://doi.org/10.5281/zenodo.10051495