# Starter Kit

This starting kit provides a set of Jupyter notebooks helping the challenge participants to better understand the use case, the dataset and how to contribute to this competition.

The notebooks can be downloaded using this dedicated github repository (opens new window)

In the following, we describe briefly the content of the jupyter notebooks :

  • 0_Basic_Competition_Information: This notebook contains general information concerning the competition organization, phases, deadlines and terms. The content is the same as the one shared in the competition Codabench page. Open In Colab (opens new window)

  • 1-PowerGrid_basics: This notebook aims to familiarize the participants with the use case and to facilitate their comprehension. It allows the visualization of some simulation results. Open In Colab (opens new window)

  • 2-Datasets: Shows how the challenge datasets could be downloaded and imported using proper functions. These data will be used in the following notebook to train and evaluate an augmented simulator. Open In Colab (opens new window)

  • 3-Reproduce_baseline: This notebook shows how the baseline results could be reproduced. It includes the whole pipeline of training, evaluation and score calculation of an augmented simulator using LIPS platform (opens new window). Open In Colab (opens new window)

  • 4a-How_to_Contribute_Pytorch: This notebook shows 3 ways of contribution for beginner, intermediate and advanced users. The submissions should respect one of these forms to be valid and also to enable their proper evaluation through the LIPS platform which will be used for the final evaluation of the results. Open In Colab (opens new window)

     * Beginner Contributor: You only have to calibrate the parameters of existing augmented simulators
     * Intermediate Contributor: You can implement an augmented simulator respecting a given template (provided by the LIPS platform)
     * Advanced Contributor: you can implement your architecture independently from LIPS platform and use only the evaluation part of the framework to assess your model performance.
  • 4b-How_to_Contribute_Tensorflow: This notebook shows how to contribute using the existing augmen+ted simulators based on Tensorflow library. The procedure to customize the architecture is fairly the same as pytorch (shown in Notebook 4). Open In Colab (opens new window)

  • 5-Scoring: This notebook shows firstly how the score is computed by describing its different components. Next, it provides a script which can be used locally by the participants to obtain a score for their contributions. We encourage participants to evaluate their solutions via codabench (which uses the same scoring module as the one described in this notebook). Open In Colab (opens new window)

  • 6-Submission: This notebook presents the composition of a submission bundle for Codabench (opens new window) and usable parameters.

  • 7-Submission_examples: This notebook shows how to submit on Codabench (opens new window) and examples of submissions bundles.