Submitting using GitHub Command Line - european-modelling-hubs/RespiCast-SyndromicIndicators GitHub Wiki
New forecast data has to be submitted using pull requests from a forked version of this repository. This will trigger all the validation checks to ensure a successful acquisition of the forecasts. Using the command line requires some technical expertise and some knowledge of the git framework. If you are not confident you shall submit using GitHub Website.
-
Install the GitHub cli.
-
Authenticate your user using the GitHub cli:
gh auth login
To do so you need first to create a Personal access token (info here) with at least the repo, workflow and admin:org scopes enabled.
-
Fork and clone the
RespiCast-SyndromicIndicators
repository using the GitHub cli:gh repo fork european-modelling-hubs/RespiCast-SyndromicIndicators --clone=true
-
Set default repository to use when querying the GitHub API for local clone to
RespiCast-SyndromicIndicators
using:gh repo set-default european-modelling-hubs/RespiCast-SyndromicIndicators
-
Be sure your local fork is up to date with the original repo, syncing it:
git checkout main
gh repo sync <your_github_handle>/RespiCast-SyndromicIndicators -b main
git pull
-
Create a new branch for the submission and switch to it:
git checkout -b <submit_branch>
(The name of the branch should be new, for example "submit_branch_YYYYMMDD").
-
Navigate to the
model-output
folder (where all the forecasts are stored).ONLY BEFORE THE FIRST SUBMISSION: Create and name your own forecasts folder in the format
<team>-<model>
(where and correspond to theteam_abbr
andmodel_abbr
fields of the metadata file). -
Copy your forecasts/changes file to your forecasts folder (the
<team>-<model>
folder above). -
Commit your changes via the standard git commands:
git add --all
git commit -m "Commit comment"
-
Submit a pull request to the main branch of the RespiCast-SyndromicIndicators repository. Please use your team name, model name and submission date as the title of the pull request.
gh pr create
-
Wait for validation and merge.
FOR SUBSEQUENT SUBMISSIONS REPEAT FROM POINT 5.