Introduction | Requirements | How to use | How to contribute | Contact
The dashboard provides users with an opportunity to investigate pupil absence at national, regional and local authority geographic levels in 5% bandings for overall absence. Data is available across state-funded primary, secondary and special schools and can also be broken down by individual school type, and pupils year group, Special Educational Needs status, Free school Meal status and sex.
Live version of the dashboard can be accessed at https://department-for-education.shinyapps.io/absence-distributions-dashboard/
The dashboard is split across multiple tabs:
- Pupil Enrolments shows the number of pupil enrolments in each year group and 5% overall absence band for the selections chosen.
- Proportions shows the proportion of enrolments in each year group falling in each banding 5% overall absence band for the selections chosen
The dashboard also includes further information on the data itself on the technical notes tab, alongside accessibility and information on where to find further support.
-
Installation of R Studio 1.2.5033 or higher
-
Installation of R 3.6.2 or higher
-
Installation of RTools40 or higher
-
R at an intermediate level, DfE R training guide
-
Particularly R Shiny
-
Clone or download the repo.
-
Open the R project in R Studio.
-
Run
renv::restore()to install dependencies. -
Run
shiny::runApp()to run the app locally.
Package control is handled using renv. As in the steps above, you will need to run renv::restore() if this is your first time using the project.
UI tests have been created using shinytest2 that test the app loads. More should be added over time as extra features are added.
GitHub Actions provide CI by running the automated tests and checks for code styling. The yaml files for these workflows can be found in the .github/workflows folder.
The function run_tests_locally() is created in the Rprofile script and is available in the RStudio console at all times to run both the unit and ui tests.
- The app is deployed to the department's shinyapps.io subscription using GitHub actions. The yaml file for this can be found in the .github/workflows folder.
In general all .r files will have a usable outline, so make use of that for navigation if in RStudio: Ctrl-Shift-O.
The function tidy_code() is created in the Rprofile script and therefore is always available in the RStudio console to tidy code according to tidyverse styling using the styler package. This function also helps to test the running of the code and for basic syntax errors such as missing commas and brackets.
If you spot any issues with the application, please flag it in the "Issues" tab of this repository, and label as a bug.
Only members of the Statistics Development team can merge pull requests. Add cjrace as requested reviewers, and the team will review before merging.
If you have any questions about the dashboard please contact schools.statistics@education.gov.uk.