← All message topics · schema Utility/threat_room_coordination.json

header

Field	Type	Required	Allowed values	Description
timestamp	string	✓
message_type	string	✓	`control` `observation` `chat` `status` `trial` `event` `groundtruth` `experiment` `metadata` `agent`
version	string	✓		The message format version

Example message

{
"header": {"timestamp": "2022-03-14T02:39:21.862254Z", "message_type": "agent", "version": "0.1"}, 
"msg": {"sub_type": "AC:threat_room_coordination", "version": 0.2, "source": "AC_Rutgers_TA2_Utility", "timestamp": "2022-03-14T02:39:21.862254Z", "experiment_id": "934c548a-54ef-4e1e-bdbb-613bd395764b", "trial_id": "add1aeef-a1c0-4621-b7d6-51efe129c99c"}, 
"data": {
    "room_id": ["H1A", "J4", "H1A", "J4", "K2", "M3", "D3"], 
    "threat_activation_time": [80.745, 87.143, 120.742, 173.342, 310.041, 408.342, 539.691], 
    "threat_activation_player": ["RED_ASIST2", "BLUE_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2"], 
    "wait_time": [Infinity, 20.947000000000003, 14.897999999999982, 1.899000000000001, 29.25, 2.4530000000000314, Infinity], 
    "threshold:": 10,
    "time_in_seconds": 552.521}
}

Raw JSON Schema (resolved)

{
  "$id": "http://asist.aptima.com/schemas/threat_room_coordination.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "data": {
    "$id": "#/properties/data",
    "properties": {
      "room_id": {
        "$id": "#/properties/data/properties/room_id",
        "items": {
          "examples": [
            "H1A",
            "J4",
            "H1A",
            "J4",
            "K2",
            "M3",
            "D3"
          ],
          "type": "string"
        },
        "title": "Room id of activated threat plate",
        "type": "array"
      },
      "threat_activation_player": {
        "$id": "#/properties/data/properties/threat_activation_player",
        "items": {
          "examples": [
            "RED_ASIST2",
            "BLUE_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2"
          ],
          "type": "string"
        },
        "title": "Player id of the player who activated the threat plate",
        "type": "array"
      },
      "threat_activation_time": {
        "$id": "#/properties/data/properties/threat_activation_time",
        "items": {
          "examples": [
            80.745,
            87.143,
            120.742,
            173.342,
            310.041,
            408.342,
            539.691
          ],
          "type": "number"
        },
        "title": "Threat plate activation time in seconds from mission start",
        "type": "array"
      },
      "threshold": {
        "$id": "#/properties/data/properties/threshold",
        "examples": 10,
        "title": "Single entry giving the threshold for wait time for the AC to flag that a participant appears to be stuck. The threshold is set to 10 seconds, which corresponds to five seconds less than the median wait time in the pilot data.",
        "type": "number"
      },
      "time_in_seconds": {
        "$id": "#/properties/data/properties/time_in_seconds",
        "examples": 552.521,
        "title": "The mission time relative to mission start.",
        "type": "number"
      },
      "wait_time": {
        "$id": "#/properties/data/properties/wait_time",
        "items": {
          "examples": [
            "Infinity",
            20.947000000000003,
            14.897999999999982,
            1.899000000000001,
            29.25,
            2.4530000000000314,
            "Infinity"
          ],
          "type": "number"
        },
        "title": "Difference in seconds from threat_activation_time until the threat rubble is removed",
        "type": "array"
      }
    },
    "title": "The Threat Coordination Data Schema",
    "type": "object"
  },
  "definitions": {},
  "msg": {
    "$id": "http://asist.aptima.com/schemas/event_message.json",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "definitions": {},
    "properties": {
      "experiment_id": {
        "$id": "#/properties/experiment_id",
        "default": "",
        "examples": [
          "123e4567-e89b-12d3-a456-426655440000"
        ],
        "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|Null|null)",
        "title": "The Experiment Id Schema",
        "type": "string"
      },
      "replay_id": {
        "$id": "#/properties/replay_id",
        "default": "",
        "examples": [
          "123e4567-e89b-12d3-a456-426655440000"
        ],
        "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
        "title": "The Replay Id Schema",
        "type": [
          "string",
          "null"
        ]
      },
      "replay_parent_id": {
        "$id": "#/properties/replay_parent_id",
        "default": "",
        "examples": [
          "123e4567-e89b-12d3-a456-426655440000"
        ],
        "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
        "title": "The Replay Parent Id Schema",
        "type": [
          "string",
          "null"
        ]
      },
      "replay_parent_type": {
        "$id": "#/properties/replay_parent_type",
        "enum": [
          "TRIAL",
          "REPLAY",
          null
        ],
        "title": "The Replay Parent Type Schema",
        "type": [
          "string",
          "null"
        ]
      },
      "source": {
        "$id": "#/properties/source",
        "default": "",
        "examples": [
          "simulator"
        ],
        "pattern": "^(.*)$",
        "title": "The Source Schema",
        "type": "string"
      },
      "sub_type": {
        "$id": "#/properties/sub_type",
        "default": "",
        "examples": [
          "equip",
          "triage"
        ],
        "pattern": "^([a-zA-Z0-9_:]*?)$",
        "title": "The Sub Type Schema",
        "type": "string"
      },
      "timestamp": {
        "$id": "#/properties/timestamp",
        "default": "",
        "examples": [
          "2019-12-26T14:05:02.3412Z"
        ],
        "pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}[.]?[0-9]{0,}?Z",
        "title": "The Timestamp Schema",
        "type": "string"
      },
      "trial_id": {
        "$id": "#/properties/trial_id",
        "default": "",
        "examples": [
          "123e4567-e89b-12d3-a456-426655440000"
        ],
        "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
        "title": "The Trial Id Schema",
        "type": "string"
      },
      "version": {
        "$id": "#/properties/version",
        "default": "",
        "examples": [
          "0.1",
          "1.0.1"
        ],
        "pattern": "^([.]*)|(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
        "title": "The Version Schema",
        "type": "string"
      }
    },
    "required": [
      "experiment_id",
      "timestamp",
      "source",
      "sub_type",
      "version"
    ],
    "title": "The Event Message Schema",
    "type": "object",
    "version": "0.5"
  },
  "properties": {
    "header": {
      "$id": "http://asist.aptima.com/schemas/common_header.json",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "definitions": {},
      "properties": {
        "message_type": {
          "$id": "#/properties/message_type",
          "enum": [
            "control",
            "observation",
            "chat",
            "status",
            "trial",
            "event",
            "groundtruth",
            "experiment",
            "metadata",
            "agent"
          ],
          "examples": [
            "observation"
          ],
          "pattern": "^([a-z_]*?)$",
          "title": "The Message_type Schema",
          "type": "string"
        },
        "timestamp": {
          "$id": "#/properties/timestamp",
          "examples": [
            "2019-12-26T12:47:23.1234Z"
          ],
          "pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}[.]?[0-9]{0,}?Z",
          "title": "The Timestamp Schema",
          "type": "string"
        },
        "version": {
          "$id": "#/properties/version",
          "examples": [
            "1.0",
            "2.3.1"
          ],
          "pattern": "^([0-9]+\\.)?([0-9]+\\.)?([0-9]+)$",
          "title": "The message format version",
          "type": "string"
        }
      },
      "required": [
        "timestamp",
        "message_type",
        "version"
      ],
      "title": "ASIST message common header Schema",
      "type": "object",
      "version": "0.3"
    }
  },
  "required": [
    "header",
    "msg",
    "data"
  ],
  "title": "Threat Room Co-ordination",
  "type": "object",
  "version": "0.1"
}

Upstream spec documentation

Data Subtype: Threat Room Coordination Event Message Format

This data message subtype is used to measure time from threat plate activation until the associated threat rubble is removed, and which player activates the threat plate. This measure is intended to capture how efficiently the team coordinates to rescue team mates stuck in threat rooms.

TOPIC

agent/ac/threat_room_coordination

Message Fields

Field Name	Type	Description
header	object	From Common Message Format Section
msg	object	From the Common Event Message Format Section
data.room_id	list of string	List of room ids of activated threat plate
data.threat_activation_time	list of float	List of threat plate activation time in seconds from mission start
data.threat_activation_player	list of string	List of player id of the player who activated the threat plate
data.wait_time	list of float	List of difference in seconds from threat_activation_time until the threat rubble is removed
data.threshold_time	float	Single entry giving the threshold for wait time for the AC to flag that a participant appears to be stuck. The threshold is set to 10 seconds, which corresponds to five seconds less than the median wait time in the pilot data.
data.time_in_seconds	float	The mission time relative to mission start

Message Example

{
"header": {"timestamp": "2022-03-14T02:39:21.862254Z", "message_type": "agent", "version": "0.1"}, 
"msg": {"sub_type": "AC:threat_room_coordination", "version": 0.2, "source": "AC_Rutgers_TA2_Utility", "timestamp": "2022-03-14T02:39:21.862254Z", "experiment_id": "934c548a-54ef-4e1e-bdbb-613bd395764b", "trial_id": "add1aeef-a1c0-4621-b7d6-51efe129c99c"}, 
"data": {
    "room_id": ["H1A", "J4", "H1A", "J4", "K2", "M3", "D3"], 
    "threat_activation_time": [80.745, 87.143, 120.742, 173.342, 310.041, 408.342, 539.691], 
    "threat_activation_player": ["RED_ASIST2", "BLUE_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2"], 
    "wait_time": [Infinity, 20.947000000000003, 14.897999999999982, 1.899000000000001, 29.25, 2.4530000000000314, Infinity], 
    "threshold:": 10,
    "time_in_seconds": 552.521}
}

CHANGE HISTORY

VERSION | DATE | DETAILS | --- | --- | --- | 0.2 | 03/14/2022 | Update key names, description and add time_in_seconds key 0.1 | 03/01/2022 | Add an initial schema definition