1     Definition 2     Functional Requirements 3     Syntax
4     Semantics 5    Conformance Testing 6     Performance Assessment

1      Definition

Annotation is Data attached to an Object or a Scene. As opposed to Qualifier that describes intrinsic properties of an Object, an Annotation is spatially and temporally local and changeable.

2      Functional Requirements

Elements of an Annotation are:

  1. M-Instance ID
  2. Annotation ID
  3. Annotation Space-Time
  4. Annotation Data
    1. JSON Text Objects
    2. Annotation Space-Time in Object or Scene
    3. Permitted Actions on Annotated Data

Annotation Data is text containing the JSON code conforming to the JSON Schema of the Item intended as Annotation. Examples of such Items are Perceptible Entities, Intention, Meaning, and Personal Status and Its components.

3      Syntax

https://schemas.mpai.community/OSD/V1.4/data/Annotation.json

4      Semantics

Label Description
Header Annotation Header
– Standard-Annotation The characters “OSD-ANN-V”
– Version Major version – 1 or 2 Bytes
– Dot-separator The character “.”
– Subversion Minor version – 1 or 2 Bytes
MInstanceID The Virtual Space whose Object or Scene contains Annotations.
AnnotationID Identifier of Annotation.
Annotation[] The actual Annotation.
– AnnotationJSONText Text of the JSON representing the Data Type used in the Annotation.
– AnnotationSpaceTime Where/when Annotation is attached.
– ProcessActions[] What is possible to do with the Annotation
  – ProcessActionID List of possible Process Actions
DescrMetadata Descriptive Metadata

5     Conformance Testing

A Data instance Conforms with MPAI-OSD Annotation (OSD-ANN) if:

  1. The Data validates against the Annotation’s JSON Schema.
  2. All Data in the  Annotation’s JSON Schema
    1. Have the specified type
    2. Validate against their JSON Schemas
    3. Conform with their Data Qualifiers if present.

6     Performance Assessment