Go to PGM-AUA V1.0 Data Types

Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment

Definition

CXC Status V1.0 is a data type representing the structured outcome of the execution of a Context Capture Directive (CXC), including operational state, modality outcomes, coverage, and metadata.

Functional Requirements

The CXC Status shall:

  1. Provide unique identification of the CXC Status instance
    • Include CXCStatusID and timestamps to ensure traceability of the status report.
  2. Maintain explicit linkage to the originating directive
    • Include the identifier of the CXC Directive (CXCDirectiveID) to enable correlation between instruction and execution.
  3. Report the overall outcome of the capture operation
    • Indicate the result of executing the directive as success, partial, or failure.
  4. Report the operational state of the acquisition process
    • Indicate the execution state (not_started, active, completed, interrupted, failed).
  5. Reflect the directive parameters under execution
    • Report the DirectiveType corresponding to the executed directive.
    • Report the ModalityFlags specifying the requested modalities (Text, Audio, Visual).
    • Report PriorityLevel as specified in the directive.
  6. Provide per-modality execution results
    • For each modality requested in ModalityFlags, report the capture outcome (not_requested, captured, partial, failed).
  7. Report spatial and entity targeting defined by the directive
    • Include MLocation to indicate the portion of the M-Instance targeted.
    • Include Objects[] to identify the objects of interest.
    • Include Users[] to identify the users of interest.
  8. Report perceptual framing applied during capture
    • Include PointOfView indicating the viewpoint used for acquisition.
  9. Report temporal realisation of the capture
    • Include Duration indicating the actual duration of the capture operation.
  10. Optionally provide execution quality and diagnostics
    • Include QualityMetrics to describe the quality of acquired data.
    • Include Issues to report anomalies or problems encountered during execution.
  11. Optionally summarise captured content
    • Include ContentSummary describing the amount and nature of captured data per modality.
  12. Provide Data Exchange Metadata
    • Include DataXMData compliant with MPAI-PTF V1.0 for interoperability and traceability.
  13. Allow additional descriptive information
    • Include DescrMetadata for optional human-readable context.

Syntax

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

Semantics

Element Description
Header Identifier of the data type. Format: PGM-CXS-Vx.y
MInstanceID Identifier of the M-Instance
UEnvironmentID Identifier of the U-Environment
CXCStatusID Unique identifier of the status instance
CXCStatusTime Time of status production
CXCStatusSpaceTime Space-Time at which the status is reported
CXCDirectiveID Identifier of the CXC Directive to which this status refers
CaptureOutcome Overall result of the execution: success | partial | failure
OperationalState State of acquisition execution: not_started | active | completed | interrupted | failed
DirectiveType Type of context operation executed, copied from the directive
ModalityFlags Modalities requested by the directive (Text, Audio, Visual)
ModalitiesStatus Per-modality outcome (Text, Audio, Visual): not_requested | captured | partial | failed
MLocation Portion of M-Instance targeted by the capture, as specified in the directive
Objects[] Objects of interest from the directive
Users[] Users of interest from the directive
PointOfView Viewpoint used for capture, derived from the directive
Duration Actual duration of the capture operation in milliseconds
PriorityLevel Priority level of the executed directive
QualityMetrics Optional indicators of acquisition quality for requested modalities
Issues List of issues encountered during execution
ContentSummary Quantitative summary of captured content per modality
DataXMData Data Exchange Metadata compliant with MPAI-PTF V1.0
DescrMetadata Optional descriptive metadata