← All message topics · schema Utility/victim_type_communication.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:40:28.088641Z", "message_type": "agent", "version": "0.1"}, 
"msg": {"sub_type": "AC:victim_type_communication", "version": 
0.2, "source": "AC_Rutgers_TA2_Utility", "timestamp": "2022-03-14T02:40:28.088641Z", "experiment_id": "934c548a-54ef-4e1e-bdbb-613bd395764b", "trial_id": "add1aeef-a1c0-4621-b7d6-51efe129c99c"}, 
"data": {
    "player_placed": ["RED_ASIST2", "RED_ASIST2", "BLUE_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "RED_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2"], 
    "time_placed": [107.141, 182.34, 199.992, 210.591, 342.542, 368.59, 406.491, 422.141, 533.991, 546.84, 598.891, 711.64, 716.341], 
    "marker_block_type": ["A", "B", "A", "B", "B", "A", "B", "B", "B", "B", "B", "B", "A"], 
    "victim_type_in_vicinity": ["A,C", "B", "B", "", "B", "A,B", "", "B", "B", "B", "B", "A,B", "A,B"], 
    "victims_match_marker_block": ["24", "15", "", "", "28", "29", "", "6", "28", "21", "28", "14", "12"],
    "vicinity_threshold_in_blocks": 2, 
    "time_in_seconds": 716.341}
}

Raw JSON Schema (resolved)

{
  "$id": "http://asist.aptima.com/schemas/victim_type_communication.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "data": {
    "$id": "#/properties/data",
    "properties": {
      "marker_block_type": {
        "$id": "#/properties/data/properties/marker_block_type",
        "items": {
          "examples": [
            "A",
            "B",
            "A",
            "B",
            "B",
            "A",
            "B",
            "B",
            "B",
            "B",
            "B",
            "B",
            "A"
          ],
          "type": "string"
        },
        "title": "What type of victim marker block is placed.",
        "type": "array"
      },
      "player_placed": {
        "$id": "#/properties/data/properties/player_placed",
        "items": {
          "examples": [
            "RED_ASIST2",
            "RED_ASIST2",
            "BLUE_ASIST2",
            "GREEN_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "GREEN_ASIST2",
            "RED_ASIST2",
            "GREEN_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2",
            "RED_ASIST2"
          ],
          "type": "string"
        },
        "title": "The ID of the player who placed the marker block",
        "type": "array"
      },
      "time_in_seconds": {
        "$id": "#/properties/data/properties/time_in_seconds",
        "examples": 716.341,
        "title": "The mission time relative to mission start.",
        "type": "number"
      },
      "time_placed": {
        "$id": "#/properties/data/properties/time_placed",
        "items": {
          "examples": [
            107.141,
            182.34,
            199.992,
            210.591,
            342.542,
            368.59,
            406.491,
            422.141,
            533.991,
            546.84,
            598.891,
            711.64,
            716.341
          ],
          "type": "number"
        },
        "title": "The time the marker block is placed in seconds, relative to mission start.",
        "type": "array"
      },
      "vicinity_threshold_in_blocks": {
        "$id": "#/properties/data/properties/vicinity_threshold_in_blocks",
        "examples": 2,
        "title": "integer that indicated what counts as \u0027vicinity\u0027 for the purpose of this AC.",
        "type": "number"
      },
      "victim_type_in_vicinity": {
        "$id": "#/properties/data/properties/victim_type_in_vicinity",
        "items": {
          "examples": [
            "A,C",
            "B",
            "B",
            "",
            "B",
            "A,B",
            "",
            "B",
            "B",
            "B",
            "B",
            "A,B",
            "A,B"
          ],
          "type": "string"
        },
        "title": "String of the victim_ids(separated by comma) in the vicinity that matches the type of the marker block.",
        "type": "array"
      },
      "victims_match_marker_block": {
        "$id": "#/properties/data/properties/victims_match_marker_block",
        "items": {
          "examples": [
            "24",
            "15",
            "",
            "",
            "28",
            "29",
            "",
            "6",
            "28",
            "21",
            "28",
            "14",
            "12"
          ],
          "type": "string"
        },
        "title": "List of the victim_ids(separated by comma) in the vicinity that matches the type of the marker block.",
        "type": "array"
      }
    },
    "title": "The Victim Type Communication 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": "Victim Type Communication",
  "type": "object",
  "version": "0.1"
}

Upstream spec documentation

Data Subtype: Victim Type Communication Event Message Format

This data message subtype is used to measures whether victim type marker blocks are placed near victims of the appropriate types. This is intended to capture whether the team use the marker blocks to effectively communicate about victim types.

agent/ac/victim_type_communication

Message Fields

Field Name	Type	Description
header	object	From Common Message Format Section
msg	object	From the Common Event Message Format Section
data.player_placed	list of string	List of ID of the player who placed the marker block.
data.time_placed	list of float	List of time(sec) the marker block is placed in seconds, relative to mission start
data.marker_block_type	list of string	List of what type of victim marker block is placed.
data.victim_type_in_vicinity	list of string	List of tuple: what types of victims are within the vicinity_threshold_in_blocks of the marker block (can contain multiple entries.
data.victims_match_marker_block	list of string	List of tuple of the victim_ids in the vicinity that matches the type of the marker block.
data.vicinity_threshold_in_blocks	float	Time(sec) that indicated what counts as "vicinity" for the purpose of this AC.## Message Example
data.time_in_seconds	float	The mission time relative to mission start

{
"header": {"timestamp": "2022-03-14T02:40:28.088641Z", "message_type": "agent", "version": "0.1"}, 
"msg": {"sub_type": "AC:victim_type_communication", "version": 
0.2, "source": "AC_Rutgers_TA2_Utility", "timestamp": "2022-03-14T02:40:28.088641Z", "experiment_id": "934c548a-54ef-4e1e-bdbb-613bd395764b", "trial_id": "add1aeef-a1c0-4621-b7d6-51efe129c99c"}, 
"data": {
    "player_placed": ["RED_ASIST2", "RED_ASIST2", "BLUE_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "RED_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "GREEN_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2", "RED_ASIST2"], 
    "time_placed": [107.141, 182.34, 199.992, 210.591, 342.542, 368.59, 406.491, 422.141, 533.991, 546.84, 598.891, 711.64, 716.341], 
    "marker_block_type": ["A", "B", "A", "B", "B", "A", "B", "B", "B", "B", "B", "B", "A"], 
    "victim_type_in_vicinity": ["A,C", "B", "B", "", "B", "A,B", "", "B", "B", "B", "B", "A,B", "A,B"], 
    "victims_match_marker_block": ["24", "15", "", "", "28", "29", "", "6", "28", "21", "28", "14", "12"],
    "vicinity_threshold_in_blocks": 2, 
    "time_in_seconds": 716.341}
}

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