Skip to content
Merged

Dev #207

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 23 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,9 +72,14 @@ For more information on this project, check out the [STARS project website](http

## Citation

To cite this work, see the `CITATION.cff` file in this repository or use the "Cite this repository" button on GitHub.
If you this book supports your work, please **cite our paper**:

You can also cite the archived version of this work on Zenodo: https://doi.org/10.5281/zenodo.17094155.
> Heather A, Monks T, Harper A et al. Reproducible analytical pipelines for healthcare discrete‑event simulation: An open guide and worked examples [version 1; peer review: awaiting peer review]. NIHR Open Res 2026, 6:68 (https://doi.org/10.3310/nihropenres.14296.1)

You may choose to also cite the software repository or archived version:

* Repository details are also provided in the `CITATION.cff` file in this repository or via the "Cite this repository" button on GitHub.
* Archived version of this work on Zenodo: https://doi.org/10.5281/zenodo.17094155.

<br>

Expand Down Expand Up @@ -117,3 +122,19 @@ If you're interested in contributing (or just viewing this website locally), che
## Funding

This project is supported by the Medical Research Council [grant number [MR/Z503915/1](https://gtr.ukri.org/projects?ref=MR%2FZ503915%2F1)] from 1st May 2024 to 31st October 2026.

It is also supported by the National Institute for Health and Care Research (NIHR) under the NIHR Applied Research Collaboration South West Peninsula (Grant Reference Number NIHR200167). The views expressed are those of the author(s) and not necessarily those of the NIHR or the Department of Health and Social Care.

<br>

<p align="center">
<img alt="University of Exeter logo" src="images/exeter_logo.png" width="45%">
&nbsp; &nbsp; &nbsp; &nbsp;
<img alt="University of Bristol logo" src="images/bristol_logo.png" width="45%">
</p>

<p align="center">
<img alt="UKRI MRC logo" src="images/ukri_mrc_logo.png" width="45%">
&nbsp; &nbsp; &nbsp; &nbsp;
<img alt="NIHR logo" src="images/nihr_logo.png" width="45%">
</p>
4 changes: 2 additions & 2 deletions _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ website:
page-footer:
left:
- text: |
The STARS project is supported by the Medical Research Council [grant number MR/Z503915/1].
The STARS project is supported by the Medical Research Council [grant number MR/Z503915/1]. It is also supported by the National Institute for Health and Care Research (NIHR) under the NIHR Applied Research Collaboration South West Peninsula (Grant Reference Number NIHR200167). The views expressed are those of the author(s) and not necessarily those of the NIHR or the Department of Health and Social Care.
center:
- text: |
Part of the <a href="https://pythonhealthdatascience.github.io/stars/" target="_blank" rel="noopener">STARS research project</a>.<br>
Expand All @@ -129,7 +129,7 @@ website:
<a href="/pages/changelog.qmd">Changelog</a>
right:
- text: |
Heather, A., Monks, T., Mustafee, N., Harper, A., Alidoost, F., Challen, R., & Slater, T. (2025). DES RAP Book: Reproducible Discrete-Event Simulation in Python and R. https://github.com/pythonhealthdatascience/des_rap_book. https://doi.org/10.5281/zenodo.17094155.
Heather A, Monks T, Harper A et al. Reproducible analytical pipelines for healthcare discrete‑event simulation: An open guide and worked examples [version 1; peer review: awaiting peer review]. NIHR Open Res 2026, 6:68 (https://doi.org/10.3310/nihropenres.14296.1)

format:
html:
Expand Down
Binary file added images/bristol_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/exeter_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/nihr_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/ukri_mrc_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
23 changes: 19 additions & 4 deletions index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,10 @@ format:

This open book is a self-paced training resource that teaches you how to design, implement, and share discrete-event simulation (DES) models in Python and R as part of a reproducible analytical pipeline. It combines a **step-by-step guide** with **complete example repositories** that you can adapt for your own projects.

If you this book supports your work, please **cite our paper**:

> Heather A, Monks T, Harper A et al. Reproducible analytical pipelines for healthcare discrete‑event simulation: An open guide and worked examples [version 1; peer review: awaiting peer review]. NIHR Open Res 2026, 6:68 (<https://doi.org/10.3310/nihropenres.14296.1>)

The material is designed for analysts, researchers, and students in health and operations research who want to build transparent, trustworthy simulation models. To get the most from this resource, you should be comfortable with basic programming in either Python or R and have some familiarity with probability and basic statistics. **No prior DES experience is required**: short introductions to DES, reproducible analytical pipelines, and free and open source software are provided in the "Intros" section and linked below.

::: {.pale-blue}
Expand Down Expand Up @@ -130,15 +134,26 @@ The book is written by **Amy Heather** [![ORCID](images/orcid.png){fig-alt="ORCI
* Dr. **Rob Challen** [![ORCID](images/orcid.png){fig-alt="ORCID logo"}](https://orcid.org/0000-0002-5504-7768)
* **Tom Slater** [![ORCID](images/orcid.png){fig-alt="ORCID logo"}](https://orcid.org/0009-0007-0838-7499)

The STARS project is supported by the Medical Research Council [grant number MR/Z503915/1] from 1st May 2024 to 31st October 2026. The listed researchers are associated with the **University of Exeter** Medical and Business Schools, and the **University of Bristol** School of Engineering, Mathematics and Technology.
The STARS project is supported by the Medical Research Council [grant number MR/Z503915/1] from 1st May 2024 to 31st October 2026. It is also supported by the National Institute for Health and Care Research (NIHR) under the NIHR Applied Research Collaboration South West Peninsula (Grant Reference Number NIHR200167). The views expressed are those of the author(s) and not necessarily those of the NIHR or the Department of Health and Social Care.

You can find out more about our project on the [**STARS project website**](https://pythonhealthdatascience.github.io/stars/){target="_blank"}. If you use this resource, **please cite us:**
The listed researchers are associated with the **University of Exeter** Medical and Business Schools, and the **University of Bristol** School of Engineering, Mathematics and Technology. You can find out more about our project on the [**STARS project website**](https://pythonhealthdatascience.github.io/stars/){target="_blank"}.
<br>

> Heather, A., Monks, T., Mustafee, N., Harper, A., Alidoost, F., Challen, R., & Slater, T. (2025). DES RAP Book: Reproducible Discrete-Event Simulation in Python and R. https://github.com/pythonhealthdatascience/des_rap_book. https://doi.org/10.5281/zenodo.17094155.
<i><b>Keywords:</b> discrete-event simulation; reproducible analytical pipelines; health services research; Python; R; simulation modelling; research software engineering; open-source tools; SimPy; simmer.</i>

<br>

<i><b>Keywords:</b> discrete-event simulation; reproducible analytical pipelines; health services research; Python; R; simulation modelling; research software engineering; open-source tools; SimPy; simmer.</i>
<p align="center">
<img alt="University of Exeter logo" src="images/exeter_logo.png" width="45%">
&nbsp; &nbsp; &nbsp; &nbsp;
<img alt="University of Bristol logo" src="images/bristol_logo.png" width="45%">
</p>

<p align="center">
<img alt="UKRI MRC logo" src="images/ukri_mrc_logo.png" width="45%">
&nbsp; &nbsp; &nbsp; &nbsp;
<img alt="NIHR logo" src="images/nihr_logo.png" width="45%">
</p>

<script type="application/ld+json">
{
Expand Down
4 changes: 2 additions & 2 deletions pages/guide/further_info/conclusion.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -101,11 +101,11 @@ The code in this book is licensed under an **MIT License**, and the text is unde

Suggested citation:

> Heather, A., Monks, T., Mustafee, N., Harper, A., Alidoost, F., Challen, R., & Slater, T. (2025). DES RAP Book: Reproducible Discrete-Event Simulation in Python and R. https://github.com/pythonhealthdatascience/des_rap_book. https://doi.org/10.5281/zenodo.17094155.
> Heather A, Monks T, Harper A et al. Reproducible analytical pipelines for healthcare discrete‑event simulation: An open guide and worked examples [version 1; peer review: awaiting peer review]. NIHR Open Res 2026, 6:68 (<https://doi.org/10.3310/nihropenres.14296.1>)

## Find out more about STARS

This book is part of the **STARS (Sharing Tools and Artefacts for Reusable and Reproducible Simulations)** project, supported by the Medical Research Council [grant number MR/Z503915/1] from 1st May 2024 to 31st October 2026.
This book is part of the **STARS (Sharing Tools and Artefacts for Reusable and Reproducible Simulations)** project, supported by the Medical Research Council [grant number MR/Z503915/1] from 1st May 2024 to 31st October 2026. It is also supported by the National Institute for Health and Care Research (NIHR) under the NIHR Applied Research Collaboration South West Peninsula (Grant Reference Number NIHR200167). The views expressed are those of the author(s) and not necessarily those of the NIHR or the Department of Health and Social Care.

[![](/images/stars_banner.png)](https://pythonhealthdatascience.github.io/stars/)

Expand Down
2 changes: 1 addition & 1 deletion pages/guide/further_info/feedback.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,6 @@ Prefer email instead? Reach out to the STARS team - you can contact the followin
* Alison Harper: [a.l.harper@exeter.ac.uk](mailto:a.l.harper@exeter.ac.uk)
* Nav Mustafee: [n.mustafee@exeter.ac.uk](mailto:n.mustafee@exeter.ac.uk)

This book is part of the **STARS (Sharing Tools and Artefacts for Reusable and Reproducible Simulations)** project, supported by the Medical Research Council from 1st May 2024 to 31st October 2026.
This book is part of the **STARS (Sharing Tools and Artefacts for Reusable and Reproducible Simulations)** project.

<br><br>
11 changes: 8 additions & 3 deletions pages/guide/sharing/citation.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -111,15 +111,20 @@ To cite this work, see the `CITATION.cff` file in this repository or use the "Ci
```
:::

**2. Provide citation details directly**. Example for DES RAP Book (as of 6th January 2026):
**2. Provide citation details directly**. Example for DES RAP Book (as of 30th June 2026):

:::{.pale-grey}
```{.text}
## Citation

To cite this work, use:
If you this book supports your work, please **cite our paper**:

Heather, A., Monks, T., Mustafee, N., Harper, A., Alidoost, F., Challen, R., & Slater, T. (2025). DES RAP Book: Reproducible Discrete-Event Simulation in Python and R. https://github.com/pythonhealthdatascience/des_rap_book. https://doi.org/10.5281/zenodo.17094155.
> Heather A, Monks T, Harper A et al. Reproducible analytical pipelines for healthcare discrete‑event simulation: An open guide and worked examples [version 1; peer review: awaiting peer review]. NIHR Open Res 2026, 6:68 (<https://doi.org/10.3310/nihropenres.14296.1>)

You may choose to also cite the software repository or archived version:

* Repository details are also provided in the `CITATION.cff` file in this repository or via the "Cite this repository" button on GitHub.
* Archived version of this work on Zenodo: <https://doi.org/10.5281/zenodo.17094155>.
```
:::

Expand Down
Loading