FAQ
Is this a clinical diagnostic tool?
No. Cardiology in Gradient Biotech is a research and exploratory analysis workspace. Outputs must not be used for clinical decision-making. Interpretations include explicit disclaimers.
Do I need MATLAB or WFDB installed locally?
No.
Preprocessing failed — what should I check?
- WFDB uploads include both
.heaand.dat - CSV time column is numeric and strictly increasing
- Recording is long enough (minimum row count enforced)
- EDF channel index is valid for the file
Open the failed run's Logs tab for the specific error.
HRV button is disabled — why?
For ECG datasets, complete Preprocess ECG first. For RR CSV uploads, HRV should be available immediately after upload.
Interpret returns an error
Confirm Ollama credentials in backend-analysis/.env and that a completed metrics run exists as input. See repo root ai.md.
How do I compare treatment vs control?
- Import subjects with a
treatment_groupcolumn - Link datasets to subjects
- Run HRV (batch from cohort page if needed)
- Open Cohort → group by
treatment_group→ compare
Can I upload WFDB and CSV in the same batch?
No — one format per upload action. Create separate datasets for each recording.
Where are files stored locally?
Uploads: data/uploads/
Artifacts: data/artifacts/{run_id}/
Metadata: Supabase PostgreSQL (biochem_cardio_* tables) via the metadata API
These paths are gitignored.
How do I add a new pipeline?
Implement in backend-analysis/app/pipelines/, register in app/pipeline_registry.py, and expose via the existing job endpoints. See products/cardiology/plan.md and repo root claude.md for conventions.
What's the difference between descriptive and mechanistic interpret?
Descriptive summarizes metrics from one run or cohort comparison. Mechanistic proposes cross-domain physiological hypotheses when a subject has metrics from multiple modalities (for example HRV + BP + baroreflex).
Is cloud deployment supported?
Production deployment is supported on Google Cloud Run with Supabase for metadata. See deploy.sh and repo root README.md.