{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://vault1.magland.org/challenges/string/schema/solution.schema.json",
  "title": "Challenge solution submission",
  "description": "One submission file: a set of solutions to one challenge from one submitter, with an optional accuracy partial order among them.",
  "type": "object",
  "required": [
    "schema_version",
    "submission_id",
    "challenge_id",
    "submitter",
    "solutions"
  ],
  "additionalProperties": false,
  "properties": {
    "schema_version": {
      "const": 1
    },
    "submission_id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "description": "Identifier of this submission. Must equal the file name without .json."
    },
    "challenge_id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "description": "The challenge this submission solves. Must equal the name of the directory containing the file."
    },
    "submitter": {
      "type": "object",
      "required": [
        "name"
      ],
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "date": {
      "type": "string",
      "format": "date"
    },
    "description": {
      "type": "string"
    },
    "code_url": {
      "type": "string",
      "format": "uri",
      "description": "Source code for the method, applying to every solution unless overridden."
    },
    "viz_url": {
      "type": "string",
      "format": "uri",
      "description": "A web application visualizing the solutions."
    },
    "solutions": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "solution_id",
          "output"
        ],
        "additionalProperties": false,
        "properties": {
          "solution_id": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]*$",
            "description": "Unique within the submission."
          },
          "output": {
            "type": "string",
            "description": "Path to the wav file relative to the directory containing this JSON file, or an http(s) URL."
          },
          "method": {
            "type": "string",
            "description": "Short name of the numerical method."
          },
          "parameters": {
            "type": "object",
            "description": "Discretization parameters, free form."
          },
          "timing_seconds": {
            "type": "number",
            "minimum": 0,
            "description": "Self-reported wall-clock time to produce the output, excluding file I/O."
          },
          "hardware": {
            "type": "string"
          },
          "code_url": {
            "type": "string",
            "format": "uri"
          },
          "viz_url": {
            "type": "string",
            "format": "uri"
          },
          "more_accurate_than": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "solution_ids in this same file that the submitter asserts are less accurate than this one."
          },
          "notes": {
            "type": "string"
          },
          "fields": {
            "type": "object",
            "required": [
              "path"
            ],
            "additionalProperties": false,
            "description": "Optional export of the solution field on the grid recommended by the challenge, for visualization. Not scored.",
            "properties": {
              "path": {
                "type": "string",
                "description": "Path relative to the directory containing this JSON file, or an http(s) URL."
              },
              "format": {
                "const": "hdf5"
              },
              "description": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}