Health Vocabulary v1.4

Overview

Namespace URI:

https://ns.cascadeprotocol.org/health/v1#

Preferred Prefix:

health:

Version:

1.4

Status:

Stable

Imports:

cascade: (Core Vocabulary v1)

Schema File:

health.ttl (Turtle/RDF)

The Health Vocabulary provides a comprehensive schema for representing consumer-generated wellness observations from wearable devices and Apple HealthKit. It maps Cascade wellness properties to established SNOMED CT and LOINC codes following the three-layer ontology architecture.

All vital sign properties use fhir:Observation as their domain, aligning with HL7 FHIR observation resources. Activity and sleep metrics use composite snapshot classes (ActivitySnapshot, SleepSnapshot) that subclass prov:Entity.

Composite Classes

Aggregate snapshot classes for activity and sleep data collected over a measurement period.

Cardiac Properties

Heart rate and heart rate variability observations from wearable devices.

Cardiovascular Properties

Blood pressure observations with systolic and diastolic components.

Respiratory & Fitness Properties

Walking Steadiness

Activity Properties

Properties for the health:ActivitySnapshot class.

Sleep Properties

Properties for the health:SleepSnapshot class.

Annotation Properties

Metadata annotations linking wellness properties to established standard codes.

Standard Code Mappings

Complete mapping of all health vocabulary properties to established clinical terminologies.

Usage Example

@prefix health: <https://ns.cascadeprotocol.org/health/v1#> .
@prefix cascade: <https://ns.cascadeprotocol.org/core/v1#> .
@prefix fhir: <http://hl7.org/fhir/> .
@prefix loinc: <https://loinc.org/rdf/> .
@prefix prov: <http://www.w3.org/ns/prov#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# Resting heart rate observation
<#rhr-reading-001> a fhir:Observation ;
    cascade:schemaVersion "1.4" ;
    cascade:dataProvenance cascade:ConsumerGenerated ;
    health:restingHeartRate "68.0"^^xsd:double ;
    cascade:loincCode loinc:40443-4 ;
    prov:wasAttributedTo <https://id.cascadeprotocol.org/users/abc123> .

# Activity snapshot
<#activity-2026-01> a health:ActivitySnapshot ;
    cascade:schemaVersion "1.4" ;
    cascade:dataProvenance cascade:ConsumerGenerated ;
    health:averageDailySteps "8500"^^xsd:integer ;
    health:activeEnergyBurnedKcal "450.0"^^xsd:decimal ;
    health:exerciseMinutesWeekly "185"^^xsd:integer ;
    health:standHoursDaily "11"^^xsd:integer .

# Sleep snapshot
<#sleep-2026-01> a health:SleepSnapshot ;
    cascade:schemaVersion "1.4" ;
    health:averageDurationHours "7.5"^^xsd:decimal ;
    health:sleepQuality "good" .

Data Provenance

All health vocabulary observations use cascade:ConsumerGenerated provenance to indicate device-generated wellness data:

• Source: Apple HealthKit HKQuantityType / HKStatistics APIs
• Origin: Apple Watch, iPhone, and compatible third-party devices
• Classification: Consumer-generated, non-diagnostic
• Privacy: Encrypted storage required, local-first architecture

Changelog

Version 1.4 (2026-01-29)

• Initial release of the Health Vocabulary with SNOMED CT and LOINC mappings for all wellness metrics
• 2 composite classes: ActivitySnapshot, SleepSnapshot
• 14 wellness observation properties organized by category:
  • Cardiac: restingHeartRate, walkingHeartRate, heartRateVariability
  • Cardiovascular: bloodPressure, systolicBP, diastolicBP
  • Respiratory & Fitness: respiratoryRate, vo2Max
  • Walking Steadiness: walkingSteadiness
  • Activity: averageDailySteps, activeEnergyBurnedKcal, exerciseMinutesWeekly, standHoursDaily
  • Sleep: averageDurationHours, sleepQuality
• 4 annotation properties: snomedCode, loincCode, unit, ucumCode
• Three-layer ontology architecture documented (Layer 1: SNOMED/LOINC, Layer 2: health:, Layer 3: checkup:)
• Walking Steadiness mapped to sct:364832000 (Balance finding) with documentation of alternative considerations
• Stand Hours documented as Cascade-proprietary (no SNOMED CT or LOINC equivalent exists)