The STARS framework is a set of open practices, tools and learning materials to produce enhanced versions of research artefacts that intend to increase accessibility for others to (re)use, adapt and build on work.
Essential components of STARS framework (shaded in green below):
- Open license
- Dependency management
- Model created using free and open-source software (FOSS)
- Minimum documentation
- Research artefact meta data (ORCID ID + citation information)
- Remote code repository
- Open science archive
Optional components of STARS framework (shaded in blue below):
- Enhanced documentation
- Documentation hosting
- Online coding environment
- Model interface
- Web app hosting
Several repositories are related to our recent paper 'Towards sharing tools and artefacts for reusable simulations in healthcare', which includes three examples of the implemented STARS framework in Python:
| Repositories | Description |
|---|---|
| stars-treat-sim | STARS paper example 1. Implements essential components + annotated notebook to run code executable online with Binder |
| stars-simpy-example-docs stars-streamlit-example |
STARS paper example 2. Fully implements essential + optional components including enhanced documentation hosted online and web app |
| stars-ciw-example | STARS paper example 3. Fully implements essential + optional components, but with different licence, documentation publishing software, web app framework and web app hosting |
Subsequently, we have been developing similar examples in R, as well as looking at webassembly:
| Repositories | Description |
|---|---|
| stars-treat-simmer | R simmer implementation of treatment simulation model |
| stars-shiny-simmer | Template for shiny interface to simmer DES model |
| stars-stlite-example | stlite template for SimPy models |
| stars-simpy-jupterlite | JupyterLite template for SimPy models |
As part of STARS, we are assessing the reproducibility of six published simualation models, with related repositories as follows:
| Repositories | Description |
|---|---|
| stars-reproduction-protocol | Latex files for reproduction protocol |
| stars-reproduce-allen-2020 | Test run of reproducibility protocol on Allen et al. 2020 |
| stars-reproduction-template | Template for assessment of computational reproducibility |
| stars-reproduce-shoaib-2022 | Reproduction study 1: Shoaib and Ramamohan 2022 (Python) |
| stars-reproduce-huang-2019 | Reproduction study 2: Huang et al. 2019 (R) |
| stars-reproduce-lim-2020 | Reproduction study 3: Lim et al. 2020 (Python) |
| stars-reproduce-kim-2021 | Reproduction study 4: Kim et al. 2021 (R) |
| stars-reproduce-anagnostou-2022 | Reproduction study 5: Anagnostou et al. 2022 (Python) |
| stars-reproduce-johnson-2021 | Reproduction study 6: Johnson et al. 2021 (R) |
Other repositories are:
| Repositories | Description |
|---|---|
| stars-publications | List of all STARS publications |
| stars-logo | SVG and PNG files with logo |
| stress_update | A review and update of the Strengthening the Reporting of Empirical Simulation Studies guidelines for DES, SD, and ABS. |
| stars-eom-rcc | Modifications to the "Exeter Oncology Model: Renal Cell Carcinoma edition (EOM-RCC)" as part of STARS work package 3. |
| Member | ORCID | GitHub |
|---|---|---|
| Thomas Monks |  |
https://github.com/TomMonks |
| Alison Harper |  |
https://github.com/AliHarp |
| Navonil Mustafee |  |
https://github.com/NavonilNM |
| Andrew Mayne |  |
https://github.com/andy-mayne |
| Amy Heather |  |
https://github.com/amyheather |
