Go to PGM-AUA V1.0 Data Types

Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment

Definition

Visual CXE Directive (PGM‑VCD) is a Directive issued by A‑User Control that specifies which visual properties shall be produced by Visual Context Enhancement SubAIMs by selecting, at property level, the required, optional, or non-requested attributes derived from Visual Scene Descriptors, together with associated metadata for identification, exchange, and description.

Functional Requirements

  1. Directive Identification and Traceability: The directive shall include a unique identifier (VisualCXEDirectiveID) and a timestamp (VisualCXEDirectiveTime) to ensure traceability and correlation with execution status.
  2. Environment Identification: The directive shall include identifiers for the M-Instance (MInstance) and U-Environment (UEnvironment) in which the directive applies.
  3. Property-Based Control: The directive shall specify property-level requests indicating which visual attributes must be produced.
  4. Visual Object Identification Control: The directive shall enable selection of object identification and spatial attributes such as ObjectIdentifiers and SpatialAttitudes.
  5. Depth and Occlusion Control: The directive shall enable selection of depth and occlusion properties including RelativeDepths and OcclusionFlags.
  6. Affordance Inference Control: The directive shall enable selection of affordance and interaction properties including AffordanceTags and InteractionPotential.
  7. Visual Salience Mapping Control: The directive shall enable selection of salience outputs such as RankedVisualObjects and SalientVisualObjects.
  8. Selective Property Activation: Each property shall be independently selectable with values indicating whether it is required, optional, or not requested.
  9. Directive Consistency: The directive shall define a complete property request structure covering all Visual CXE SubAIMs.
  10. Data Exchange Metadata: The directive shall include DataXMData to provide standardised metadata supporting interoperability, traceability, and data exchange control.
  11. Descriptive Metadata: The directive may include DescrMetadata to provide additional human-readable context.

Syntax

https://schemas.mpai.community/PGM1/V1.0/data/VisualCXEDirective.json

Semantics

Label Description
Header Directive header identifier matching pattern “PGM-VCD-Vx.y”.
MInstance Identifier of the M-Instance in which the directive applies.
UEnvironment Identifier of the U-Environment associated with the directive.
VisualCXEDirectiveID Unique identifier for this Visual CXE Directive instance.
VisualCXEDirectiveTime Timestamp indicating when the directive was produced.
PropertyRequests Container specifying requested properties for each Visual CXE SubAIM.
– VisualObjectIdentification Specifies requests for visual object identification and spatial attributes.
– ObjectIdentifiers Indicates whether visual object identifiers shall be produced.
– SpatialAttitudes Indicates whether spatial attitudes shall be produced.
– DepthOcclusion Specifies requests for depth and occlusion estimation.
– RelativeDepths Indicates whether relative depths shall be produced.
– OcclusionFlags Indicates whether occlusion flags shall be produced.
– AffordanceInference Specifies requests for affordance and interaction inference.
– AffordanceTags Indicates whether affordance tags shall be produced.
– InteractionPotential Indicates whether interaction potential shall be produced.
– VisualSalienceMapping Specifies requests for salience-based outputs.
– RankedVisualObjects Indicates whether visual objects shall be ranked.
– SalientVisualObjects Indicates whether salient visual objects shall be produced.
DataXMData Data Exchange Metadata compliant with MPAI-PTF V1.0.
DescrMetadata Optional descriptive metadata providing human-readable context.