From d31df9c9432ea9ecda9dc20e47dcfd3f7484f727 Mon Sep 17 00:00:00 2001 From: Brian Gow Date: Wed, 8 Apr 2026 11:46:40 -0400 Subject: [PATCH] add guidance for entering sample units --- rmd/waveform-extension.Rmd | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/rmd/waveform-extension.Rmd b/rmd/waveform-extension.Rmd index 9c64691..4b9f258 100644 --- a/rmd/waveform-extension.Rmd +++ b/rmd/waveform-extension.Rmd @@ -153,7 +153,11 @@ Iterate over each file's signal channels and extract per-channel metadata. | 12 | unit_concept_id | int | Recommended | Populate for physical values (e.g., Hz, mmHg, mV) using OMOP standard units. Use unit lookup table or join against raw units found in header. | | 13 | unit_source_value | string | Recommended | Raw unit string as it appeared in the source (e.g., "Hz", "mmHg", "uV"). Helps track unusual or non-standard units and improves auditability. | -### 6.3 Handling Conflicts +### 6.3 Common Issues & Solutions + +- **Sample Amplitude Units** -> Set `metadata_source_value` = 'AMPLITUDE' (and use the corresponding `metadata_concept_id` from [WAVEFORM](https://github.com/TuftsCTSI/CVB/tree/main/WAVEFORM)), and all `value_as` fields to NULL. Fill in the unit columns with the unit for the sample amplitude for the channel. + +### 6.4 Handling Conflicts - **Multiple labels per channel** → Standardize via channel index - **Conflicting sampling rates** → Default to most frequent or highest resolution