Skip to content

Commit 9b37834

Browse files
authored
Merge pull request #9 from pythonhealthdatascience/env
README: added citation
2 parents bb727d4 + 2072e03 commit 9b37834

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
[![lite-badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://pythonhealthdatascience.github.io/stars-simpy-jupterlite/notebooks/?path=01_urgent_care_model.ipynb)
22
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
3+
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10987817.svg)](https://doi.org/10.5281/zenodo.10987817)
34
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/release/python-3100/)
45
[![License: MIT](https://img.shields.io/badge/ORCID-0000--0001--5274--5037-brightgreen)](https://orcid.org/0000-0001-5274-5037)
56
[![License: MIT](https://img.shields.io/badge/ORCID-0000--0003--2631--4481-brightgreen)](https://orcid.org/0000-0003-2631-4481)
@@ -12,6 +13,8 @@ The materials and methods in this repository support work towards developing the
1213

1314
The model will run on a users browser without the need to install any components. This is achieved using Web Assembly technology i.e. [JupterLite](https://github.com/jupyterlite/jupyterlite) and [xeus-python](https://github.com/jupyter-xeus/xeus-python). A model notebook is downloaded to the users local machine and all dependencies are pre-installed via conda-forge. The model then lives in the browsers cache. The user can make changes to the model or create new files and these are persisted (until the browser cache is cleared).
1415

16+
> Try it in your browser now: https://pythonhealthdatascience.github.io/stars-simpy-jupterlite
17+
1518
### 1.1. Use case
1619

1720
* A researcher wishes to share a runnable version of a simulation model with their publication (e.g. written in `simpy`). The code allows others to replicate the simulation results, tables and charts in a paper and allows others to reuse the model.
@@ -24,6 +27,27 @@ The model will run on a users browser without the need to install any components
2427

2528
> We would like to thank the [JupterLite](https://github.com/jupyterlite/jupyterlite) and [xeus-python](https://github.com/jupyter-xeus/xeus-python) developers for making this work possible. This discrete-event simulation focussed repository was based on the learning materials and template provided by [Jupyterlite xeus-python demo](https://github.com/jupyterlite/xeus-python-demo) and [tutorial given at PyData 2023](https://www.youtube.com/watch?v=WXRslU9D3bo) by Jeremy Tuloup.
2629
30+
### 1.3. Citation
31+
32+
If you use the template in your work we would greatly appreciate a citation when you publish your work.
33+
34+
> Monks, T., & Harper, A. (2024). Simpy JupyterLite Template (v0.1.0). Zenodo. https://doi.org/10.5281/zenodo.10987817
35+
36+
```
37+
@software{monks_harper_jupyterlite_template,
38+
author = {Monks, Thomas and
39+
Harper, Alison},
40+
title = {Simpy JupyterLite Template},
41+
month = apr,
42+
year = 2024,
43+
publisher = {Zenodo},
44+
version = {v0.1.0},
45+
doi = {10.5281/zenodo.10987817},
46+
url = {https://doi.org/10.5281/zenodo.10987817}
47+
}
48+
```
49+
50+
2751
## 2. The example model included
2852

2953
The `simpy` model is adapted from [Monks and Harper (2023)](https://github.com/pythonhealthdatascience/stars-simpy-example-docs)

0 commit comments

Comments
 (0)