Challenge How To
Install GEval (recommended, but not obligatory)
In order to evaluate your work locally, you need the GEval tool. There are two ways to get it.
option A — just download the GEval fully static binary (simpler if you have a standard 64-bit Linux)
wget https://gonito.net/get/bin/geval chmod u+x geval ./geval --help
option B — install GEval with Haskell Stack (needs some time and a couple of gigabytes of hard disk space)
First, install Haskell Stack:
curl -sSL https://get.haskellstack.org/ | sh
and then install GEval itself:
git clone git://gonito.net/geval cd geval stack setup stack install ~/.local/bin/geval --help
For troubleshooting, see GEval readme.
(GEval will make your life easier, but is not obligatory, so if you have any trouble with installing/running GEval, you can skip this step, for the time being.)
Get your repo
You need to set up your ID and upload your SSH public key (see your account) if you want to have a repo hosted on this instance, then:
git clone --single-branch ssh://firstname.lastname@example.org/YOURID/challenging-america-geo-prediction # --single-branch was used to speed up the process, but now we need to fix remote branches git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
(Warning about empty repository is expected, don't worry about it.)
cd challenging-america-geo-prediction git pull git://gonito.net/challenging-america-geo-prediction
Using an external repository
Alternatively, you can use any other Git repo, e.g. GitLab, GitHub or your own repo.
Make sure Gonito.net has access to your repo (e.g. by making it public).
Work on your solution
You need to generate your solution for the test set as test-A/out.tsv. It is also recommended to generate the output for the dev set (dev-0/out.tsv).
You can evaluate results for the dev set locally:
cd challenging-america-geo-prediction geval --test-name dev-0
Push your solution to the git repo
Commit and push out.tsv files to your repo. It is also recommended to push your source codes along with out.tsv files.
cd challenging-america-geo-prediction git checkout -b my-brilliant-branch # switch to some other branch git add foo.py build.sh # add your source codes git add gonito.yaml # it's a good practice to add metadata file, see below
git add dev-0/out.tsv test-A/out.tsv # add your output files
git commit -m 'my brilliant solution'
git push origin my-brilliant-branch
Submit your solution to Gonito
Repos hosted on this instance
If you use a repo hosted here, a submission and evaluation is triggered automatically. You'll see the evaluation results in your console while pushing.
Integration with external repos
If you use an external repo (e.g. at your own of Gitolite or at GitLab/GitHub), you can configure a webhook.
In case other methods fail, you can submit your solution manually — go to the submit form.
Gonito can take the metadata (description, tags, parameters) of a submission from a number of sources (in order of precedence):
- the YAML files specified in the param-files field of the gonito.yaml file
- only applicable for parameters,
- gonito.yaml will be always skipped even if matches a mask given in the param-files field,
- parameters blacklisted in the unwanted-params field of the gonito.yaml file will be discarded;
- gonito.yaml file committed to the repository
- description given in the description field,
- tags given in tags field,
- parameters given in params field,
- names of output files (only for parameters)
- e.g. if the output file is out-epochs=10,learning-rate=0.01.tsv, then parameters epochs=10 and learning-rare=0.01 will be extracted;
- submission form (when submitting manually);
- git commit message
- description taken from the first paragraph
- tags taken from a line starting with tags:
Here is an example of gonito.yaml, in which all metadata could be given (note that you can also add links to external resources using the `links` section):
description: This my brilliant solution tags: - neural-network - left-to-right params: epochs: 10 learning-rate: 0.01 unwanted-params: - model-file - vocab-file param-files: - "*.yaml" - config/*.yaml links: - title: "Some external link" url: "https://example.com/foo-bar-baz-123" - title: "Yet another link" url: "https://example.org/xyz" - url: "https://example.net/bare-link-without-text"
It might seem a little bit complicated, but you could simply use the method which is the most convenient for you.