Heuristics development: Upload

From MASH Wiki

Here you will find information about the upload of your heuristics on the MASH platform, and what you can do with those heuristics.

Contents 1 Upload of your heuristic 2 Your private space 3 The public space 4 The contests

Upload of your heuristic

Important: Before uploading heuristics, or using them in experiments, you must be logged in.

Go to the heuristics page. At the top, in the Upload a new heuristic file box, select your source file and click on Upload. You will be asked to give the right to compile and execute it to the MASH project. Your heuristic will be uploaded, compiled and tested.

If one step of the testing of your heuristic fail, the details of the failure are shown (like the compilation errors for instance). You can then upload another file that fix the problem.

Your private space

When the test is done, your heuristic is in your private space. In your private space:

1. You are the only one who can see your private heuristics
2. Your private heuristics are not used in the public experiments
3. You can use your private heuristics in your own private experiments
4. You can delete your private heuristics at any time
5. You can upload a new version of one of your heuristics (to fix a bug for instance)

To learn about scheduling your own private experiments, see the Experiments: Scheduling page.

The public space

Once you are happy with one of your heuristics, you can publish it (put it in the public space, where everyone can see it). Before doing so, you are encouraged to enter some informations about it, in order to help other users to find your heuristic, and understand it.

To publish your heuristic, go on its page and click on the icon. You will need to confirm that you really want to publish it, under the GPLv2 license. Nevertheless, you can choose to keep the source code of your heuristic hidden for a maximum of 4 weeks.

In the public space:

1. Everybody can see your public heuristics (even if the source code is still hidden)
2. Your public heuristics will be automatically used in the public experiments
3. You can still use your public heuristics in your own private experiments
4. Other contributors can use your public heuristics in their own private experiments
5. You can choose to participate in one of the open contests with your public heuristics

Note: Only the latest public version of a heuristic is used in the public experiments.

The contests

Each public heuristic can participate in the open contest(s). See the documentation about the contests for more details.