Go to MPAI-OSD V1.5 Data Types

Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment

1      Definition

A region with Space‑Time attributes that is further subdivided into Locations down to Basic Locations.

2      Functional Requirements

A Location:

  1. Has an extension limited in Space and Time.
  2. Is composed of Locations, e.g.:
    1. A building is a Location containing apartments.
    2. An apartment is a Location.
    3. A room can be a Basic Location of the Location defined as an apartment.

3      Syntax

https://schemas.mpai.community/OSD/V1.5/data/LocationObject.json

4      Semantics

Table 1 – Semantics of the Location Object Data Type

Label
Description
Header Location Object Header – Standard “OSD‑LCO‑Vx.y”.
MInstanceID Identifier of the M-Instance (Virtual Space) where this Location Object is or is intended to be located.
UEnvironmentID Identifier of the U-Environment (Real Space) where this Location Object is or is intended to be located.
LocationObjectID Unique identifier of this Location Object.
LocationObjectTime Time this Location Object was produced.
LocationObjectSpaceTime Space/Time where/when this Location Object is located.
BasicLocationCount Number of Basic Locations contained in this Location Object.
BasicLocations[] Set of Basic Locations contained in this Location Object.
    – BasicLocationSpaceTime Space/Time where/when this Basic Location is located within the containing Location Object. If absent, the Space/Time of the containing object applies.
    – BasicLocIDOrBasicLoc Either the ID of a Basic Location or the Basic Location itself.
SubLocationCount Number of child Locations contained in this Location Object.
SubLocations[] Set of child Locations contained in this Location Object.
    – SubLocationSpaceTime Space/Time where/when this child Location is located within the containing Location Object. If absent, the Space/Time of the containing object applies.
    – SubLocIDOrSubLoc Either the ID of a child Location or the child Location itself.
LocationOrBasicLocation A mixed array of Basic Locations and child Locations contained in this Location Object.
DataXMData MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Location Object in a trusted data exchange context.
DescrMetadata Human-readable descriptive metadata of the Location Object (plain text, max 2048 characters).

5      Conformance Testing

A Data instance conforms with Location Object (OSD‑LCO) if:

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

6      Performance Assessment

Not part of this specification.

Go to MPAI-OSD V1.5 Data Types