Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.medera.info/llms.txt

Use this file to discover all available pages before exploring further.

RDoCConstructComputer.compute_all_constructs(facial_features, vocal_features, assessments, context) returns an RDoCActivationProfile containing 15 ConstructActivation objects — one per construct — across 5 RDoC domains.

​
The 15 constructs

Negative Valence

acute_threat_fear, potential_threat_anxiety, sustained_threat

Positive Valence

reward_responsiveness, reward_anticipation, reward_satiation

Cognitive Systems

attention, working_memory, executive_function

Social Processes

social_communication, affiliation_attachment

Arousal & Regulatory

arousal, arousal_regulation, circadian_rhythms, sleep_wakefulness

​
ConstructActivation

@dataclass
class ConstructActivation:
    name: str                      # e.g. "potential_threat_anxiety"
    score: float                   # 0–1 activation
    confidence: float              # 0–1 calibrated
    contributors: List[Dict]       # [{feature, value, contribution}]
    interpretation: str            # clinical text
    domain: str                    # RDoC domain
    low_threshold: float = 0.3
    high_threshold: float = 0.7

    def get_severity(self) -> str: # "low" | "moderate" | "high"
Severity bands:
  • score < 0.3 → low
  • 0.3 ≤ score < 0.7 → moderate
  • score ≥ 0.7 → high

​
Profile schema

{
  "constructs": [
    {
      "name": "potential_threat_anxiety",
      "domain": "negative_valence",
      "score": 0.74,
      "confidence": 0.81,
      "severity": "high",
      "interpretation": "Elevated anxiety markers ...",
      "contributors": [
        {"feature": "f0_mean", "value": 218.0, "contribution": 0.31},
        {"feature": "jitter", "value": 1.4, "contribution": 0.22},
        {"feature": "vocal_anxiety_index", "value": 0.66, "contribution": 0.18}
      ]
    }
    // ... 14 more
  ]
}

​
Endpoint

POST /api/multimodal-therapy/analyze-session
The RDoC profile is included in the canonical payload at payload.rdoc.constructs.