/djprdashdata

Import, tidy, and store public data used in DJSIR labour market dashboard

Primary LanguageROtherNOASSERTION

djprdashdata

R-CMD-check refresh-data

Overview

This R package contains functions to download, tidy, and store data from the ABS and other public data sources.

The data-raw/refresh_data.R file contains code to download public data using the package’s functions. The data itself is saved in data-raw.

This public data is used in the DJPR Jobs Dashboard. See:

Last refresh date

The refresh_data.R script is executed on a schedule using GitHub Actions.

The last time the script was run to check for new data was 2023-06-29 12:14:20.

The last time new data was found was 2023-06-29 12:14:20.

Modifying the data stored in this repository

The file abs-lfs.qs in the data-raw/abs-ts sub-folder of this repository is the data loaded by the DJPR Jobs Dashboard.

This is a subset of the publicly-available ABS labour force survey data. The file is loaded by the dashboard using the djprlabourdash::load_dash_data() command.

The refresh_data.R script defines which series from the labour force survey are included in abs-lfs.qs and therefore available to the DJPR Jobs Dashboard. To add time series to this file, follow these steps:

  1. Ensure you have the djprdashdata repository on your local machine. You only need to do this step once. In RStudio, click File -> New Project -> Version Control -> Git. Then paste the GitHub repository URL for djprdashdata and choose a location for the project on your disk;

  2. Create a new branch on GitHub in the djprdashdata from the main branch;

  3. In RStudio, working in the djprdashdata project, click the Git pane, then Pull;

  4. In RStudio, in the Git pane, switch to your newly-created branch;

  5. Open the refresh_data.R file in the data-raw folder;

  6. At the top of the script, a vector of ABS time series IDs is defined. This is a complete list of all ABS time series IDs that are included in the dashboard data. Add any additional required IDs to this vector;

  7. Save the refresh_data.R file;

  8. With refresh_data.R open, click Source in RStudio. This should be at the top of the script window;

  9. R will now run the refresh_data.R script. If it does not encounter any errors, the data in the project will update. You should see console output that ends with something like this;

  10. In the Git pane of RStudio, stage and commit all modified files, then Push the changes;

  11. In GitHub initiate a pull request from your branch to main and request a review of this pull request.

Once the PR has been approved, your modifications to the data will be available to the DJPR Jobs Dashboard.