The data input file name is passed to the solver as an input parameter, typically of the form scenario_nnn.json.
The output solution file MUST be named solution.json.
Reading the JSON input files
All of the input JSON files have been checked for consistency with the Challenge 3 Data Format document by a Python code called check_data.py. Entrants may want to use this code as an example of how to read and parse the input. The code uses two Github repositories:
https://github.com/GOCompetition/C3DataUtilities, which has the check_data.py source, and
https://github.com/Smart-DS/GO-3-data-model, which invokes the Pydantic model.
Installation instructions may be found in C3DataUtilities/READM.md. Please check frequently for updates. Use commits from April 25, 2023, or later, for consistency with 5/15/23 version of Problem Formulation.
Reading the JSON solution files
The Competition uses datautilities/evaluation.py in C3DataUtilities to check the feasibility and calculate the objective for scoring. We recommend that Entrants also use this code to check their solution files for proper syntax and correctness.