Normalize units & ranges
normalize_seriesRead-onlyIdempotent
Converts a health signal's readings to a common unit and adds a reference position, enabling direct comparison of measurements taken with different units or reference ranges.
Instructions
Reconcile mixed units and reference ranges within one signal.
Pulls a signal's readings, converts every value (and its reference range, for labs/biomarkers) to a single common unit, and adds a unitless 'reference position' so readings taken with different units or reference ranges become directly comparable.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | the signal name, e.g. 'glucose' or 'a1c_percent'. | |
| user | No | which person; defaults to the primary user. | |
| limit | No | max readings to return. | |
| since | No | ||
| until | No | ||
| source | No | 'lab' | 'biomarker' | 'metric' | 'wearable' | 'substance'. | lab |
| analyte | No | analyte hint (e.g. 'glucose', 'cholesterol', 'creatinine') that unlocks mass<->molar conversions like mg/dL<->mmol/L; defaults to the signal name. | |
| to_unit | No | target unit for all values; omit to use the most common unit already present in the series. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||