1 Definition 2 Functional Requirements 3 Syntax 4 Semantics

1 Definition

Common Definitions specify the reusable structural elements shared across all AIH Data Processing Types (ECG, EEG, Medical Imaging, and Genomics).
They provide standardised constructs for Header, FeatureClass, Features, Algorithm, and Algorithms.

2 Functional Requirements

The Common Definitions:

  • Define Header as a versioned identifier following the pattern
    AIH‑CDF‑V<major>.<minor>.
  • Enable FeatureClass to specify the category/class of features (e.g., waveform, spectral, morphology, temporal).
  • Represent Features as a non‑empty array of unique string items.
  • Support Algorithm as either:
    – a string identifier, or
    – an AlgorithmObject.
  • Support Algorithms as an array whose items are either a string identifier or an AlgorithmObject.
  • Define AlgorithmObject with fields:
    Name (required), Version, Params (arbitrary object).
  • Allow Params to contain any structure required by implementations (free‑form object).
  • Capture descriptions via the schema structure (Name, Version, Params), but without imposing domain semantics.

3 Syntax

https://schemas.mpai.community/AIH1/V1.0/data/CommonDefinitions.json

4 Semantics

Label Description
Header Common Definitions Header
– Standard-CommonDefinitions The characters AIH-CMD-V
– Version Major version – 1 or 2 characters
– Dot-separator The character .
– Subversion Minor version – 1 or 2 characters
FeatureClass Human‑readable category of feature types (e.g., morphological, temporal, frequency, spectral).
Features A non‑empty, unique list of strings representing the names/IDs of features.
AlgorithmObject Structure containing algorithm metadata.
• Name: required identifier.
• Version: optional string.
• Params: free‑form configuration object.
Algorithm Either a string ID or an AlgorithmObject.
Algorithms An array whose items are each an Algorithm.