An app to input the parameters needed to run scenarios through the New Hospital Programme (NHP) demand model.
The app is deployed to Posit Connect. You must have an account and sufficient permissions to view it.
You can find more information on the NHP model project information site, including a diagram of how the components of the modelling process fit together.
The app is built and maintained by members of the Strategy Unit’s Data Science team.
The app is built primarily with Shiny and
the {golem} package. Server and
UI modules can be found in R/, configuration in
inst/golem-config.yml and supporting data and text in inst/app/.
Packages used in the app are listed in DESCRIPTION, and can be
installed with devtools::install_deps(dependencies = TRUE).
Add an .Renviron file to the project root that contains the required
environment variables. You can get these from a member of the Data
Science team.
The inputs app is on the main branch, but the selection app (where
users start or edit a scenario) is in the inputs_selection_app branch.
Use Git’s worktree function to add that branch to its own folder in
your development branch:
git fetch origin inputs_selection_app
git worktree add inputs_selection_app inputs_selection_app
To run the app from RStudio, start up the selection app by opening the
dev/watch.R script, go to the ‘Background Jobs’ tab of the console
pane and click the ‘Start Background Job’ button. In the ‘Run Script as
Background Job’ dialog box select the project root as the ‘Working
Directory’, then hit ‘Start’. When ready, the app will tell you to visit
http://127.0.0.1:9081/ in your browser. Note that your selections in
the app remain local to you.
If you need to remove the selection-app folder at any point, you can do that with:
git worktree remove inputs_selection_app
The app displays trust-specific data to users. The data is processed via Databricks scripts in the nhp_data repository and stored in Azure storage.
Deployment is controlled by GitHub Actions, where:
- pushes to the
mainbranch redeploy the app to /nhp/dev/inputs/ for purposes of quality assurance - tagged releases trigger a new deployment to /nhp/vX-Y/inputs/, where ‘vX-Y’ is the current version (note the hyphen)