Health Data

Loop Health’s health data packages form a clinical analysis pipeline — from raw lab PDFs to health scores, qualification assessments, and personalized recommendations.

Pipeline Overview


Lab PDF Upload
      │
      ▼
┌──────────────────┐
│ Biomarker Parser │  @loop/biomarker-parser
│ AI extraction    │  PDF → structured biomarkers
│ Unit normalization│
│ Code matching    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Reference Data   │  @loop/health-data
│ Ranges, panels   │  Sex-specific reference ranges
│ Synonyms         │  Biomarker synonym resolution
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Health Engine    │  @loop/health-engine
│ Qualification    │  Peptide qualification assessment
│ Contraindications│  Safety checking
│ Panel checks     │  Lab panel completeness
│ Health scoring   │  0-100 biomarker score
│ Risk flags       │  Clinical risk identification
│ Recommendations  │  Lifestyle & testing suggestions
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Health Score     │  @loop/health-score
│ Composite score  │  Wearables (40%) + Check-ins (30%) + Labs (30%)
└──────────────────┘

Packages

Package	Purpose	Key Functions
`@loop/biomarker-parser`	Parse lab PDFs into structured data	`parseLabReport()`, `normalizeValue()`, `matchBiomarkerCode()`
`@loop/health-data`	Static reference data (ranges, panels, synonyms)	`getBiomarkerById()`, `resolveSynonym()`, `getPanelById()`
`@loop/health-engine`	Clinical analysis engine	`assessQualification()`, `computeHealthScore()`, `deriveRiskFlags()`
`@loop/health-score`	Composite health score from all data sources	`calculateHealthScore()`, `calculateTrend()`
`@loop/contraindications`	Peptide safety validation	`checkContraindications()`, `filterAllowedPeptides()`

Quick Links

Biomarker Parser — Lab PDF parsing and extraction
Health Engine — Qualification, scoring, and recommendations
Health Score — Composite scoring from all data sources
Reference Data — Biomarker ranges, panels, synonyms
Contraindications — Peptide safety validation