Configuration data schema

About this page

On this page you'll be able to look up the meaning and opportunities of all the variables (potentially) contained in an MSP Challenge session configuration JSON file. Similar explanations can found in the Configuration Editor application that we ship with the full platform installer. Should some of the documentation on this page be wrong or incomplete, then we encourage you to update it yourself. Just make sure you're logged in and click on Edit Source to get started. Thank you!

This page follows the structure of the configuration file to the letter. This means that you should be able to recognize and find all of the headers on this page (e.g. 'metadata', 'datamodel') within any of the MSP Challenge JSON configuration files we ship.

Configuration schema version covered by this documentation: 1.1.x

metadata

The main object for all things metadata, i.e., data about this data.

Field	Type	Description
date_modified	string	Date with format dd/mm/yyyy representing the date the configuration file was last modified
data_model_hash	string	A string that's unique to the configuration content, auto-generated by the MSP Challenge Configuration Editor (shipped with the Windows full platform installer).
errors	int	Always 0. The idea was that this variable could store errors in the configuration content. Not implemented.
editor_version	string	Version number of the MSP Challenge Configuration Editor software by which the particular configuration file was generated.
config_version	string	Version number of the configuration schema adopted in the particular configuration file.

datamodel

The main object for everything that's *not* metadata, but just actual content.

Field	Type	Description
restrictions	object[], with keys	Documented on this separate restrictions page.
plans	object[]	Documented on this separate plans page.
CEL	object	Documented on this separate CEL page.
SEL	object	Documented on this separate SEL page.
MEL	object	Documented on this separate MEL page.
meta	object	Documented on this separate meta page.
expertise_definitions	object[]	Documented on this separate expertise_definitions page.
objectives	object[]	Documented on this separate objectives page.
edition_name	string	Name that the client should show when a session created with this configuration file has been created on the server, e.g. 'North Sea edition'
edition_colour	string	Colouring of the MSP Challenge logo/icon accompanying the edition name, as shown by the client.
edition_letter	string	Letter of to add into the MSP Challenge logo/icon accompanying the edition name, as shown by the client.
region	string	name of the region (must be the same as the name of the folder on geoserver
projection	string	PROJ.4 formatted string representing the projection system that should be used with the geodata referenced under meta and obtained from the GeoServer.
start	int	start year
end	int	end year
era_total_months	int	Total number of months in each era. There are always four eras between the start and end year.
era_planning_months	int	how many months of the era are taken up by the planning period
era_planning_realtime	int	duration (seconds) that the planning period takes
countries	string	what layer (referenced under meta) contains the planning regions?
minzoom	int	Minimum camera zoom-in level. At present believed to be not implemented. The minimum zoom-in level is determined by the _PLAY_AREA geometry provided under meta.
maxzoom	int	Maximum camera zoom-in level.
user_admin_name	string	Name of the administrator user in the game. This user has all rights, including the right to plan and (dis)approve plans on behalf of all countries/teams, and to manipulate the simulations.
user_region_manager_name	string	Name of the region manager user in the game. This user has the right to plan and (dis)approve plans on behalf of all countries/teams.
user_admin_color	string	Hexadecimal colour code of the administrator user (last two digits representing transparency).
user_region_manager_color	string	Hexadecimal colour code of the region manager user (last two digits representing transparency).
team_info_base_url	string	the base URL used by the logo button in the top-left corner to open the Knowledge Base on a specific page. This will bring the user to the info page about their country/team.
restriction_point_size	float	size of the restriction area around points
wiki_base_url	string	the base URL for all media and layer_media references under meta. Basically the base of the Knowledge Base website in use for this particular configuration.
windfarm_data_api_url	string	the base URL for communicating with the wind farm API as developed and maintained by Deltares, the Netherlands. Currently only in use in the North Sea Digitwin configuration.