Skip to content

Commit 8298b09

Browse files
authored
Merge pull request #7 from pythonhealthdatascience/env
Updated template README
2 parents 6c34f88 + eb0791e commit 8298b09

File tree

5 files changed

+23
-4
lines changed

5 files changed

+23
-4
lines changed

README.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,14 +36,33 @@ In summary, we adapt a textbook example from Nelson (2013): a terminating discre
3636

3737
> *Nelson. B.L. (2013). [Foundations and methods of stochastic simulation](https://www.amazon.co.uk/Foundations-Methods-Stochastic-Simulation-International/dp/1461461596/ref=sr_1_1?dchild=1&keywords=foundations+and+methods+of+stochastic+simulation&qid=1617050801&sr=8-1). Springer.*
3838
39-
## 3. Try it in your browser
39+
## 3. Try the example DES in your browser
4040

41-
* Classic notebook: https://pythonhealthdatascience.github.io/stars-simpy-jupterlite/notebooks/?path=01_urgent_care_model.ipynb
4241
* Jupyterlab: https://pythonhealthdatascience.github.io/stars-simpy-jupterlite
42+
* Classic notebook: https://pythonhealthdatascience.github.io/stars-simpy-jupterlite/notebooks/?path=01_urgent_care_model.ipynb
43+
44+
## 4. Using the template to create a new repo.
45+
46+
> There are three steps: i.) create a new repo form the template; ii.) modify you repo settings so that GitHub pages are built from Actions. iii.) Commit changes and trigger the GitHub Action and deployment. We recommend reading all instructions first.
47+
48+
Let's assume you wanted to create a new discrete-event simulation model of cancer services.
49+
50+
1. The first step is to copy the template. Click on the green "use this template" button in the top right and select "create a new repository"
51+
2. You will be prompted to enter a name of the repository - e.g. `cancer_model` - and a short description
52+
3. Click on "Create Repository"
53+
54+
![Deploy your own](img/use_template_1.gif)
55+
56+
The JuypterLite interactive website is built from GitHub actions. **In the newly created repo for your model** do the following
57+
58+
4. Navigate to "Settings->Pages"
59+
5. Under "Build and Deployment" set the "Source" to "GitHub actions".
60+
61+
![Deploy your own](img/actions.gif)
4362

44-
## 4. Customise your simulation environment
63+
By default the build is trigged on any commit to the `main` branch. Push a small commit and it will trigger the build. This will take a few minutes. Your site will be published under https://{USERNAME}.github.io/{DEMO_REPO_NAME}
4564

46-
## 📦 How to install extra packages for your DES model.
65+
## 5. How to install extra packages supporting your DES model. 📦
4766

4867
The repo contains two environment files. To install more dependencies for your DES model and analysis you need to edit the ``environment.yml`` file.
4968

deploy.gif

-1.81 MB
Binary file not shown.

img/actions.gif

939 KB
Loading

img/use_template_1.gif

813 KB
Loading

noarch.png

-52.3 KB
Binary file not shown.

0 commit comments

Comments
 (0)