Your Rhythm Studio — Help & Reference

📱 Phone App

1. Quick Start Guide

New to Your Rhythm Studio? Here's how to record your first session in 6 steps:

1. Put on the Polar H10 chest strap — moisten the electrode contacts and position it just below your chest muscles.
2. Open the YourRhythm app — if you've previously paired a sensor and auto-connect is on (Settings → Sensor Configuration, on by default), it connects automatically and shows your live heart rate. On first launch, tap Scan for Sensors in Settings, select your Polar H10, and it will auto-connect from then on.
3. Select an activity — tap the Activity dropdown (e.g. Resting, Walking, Running).
4. Press START SESSION — the app begins recording ECG, heart rate, and detecting arrhythmias in real time.
5. Press STOP when done — choose your export scope (Full Data or Events Only). The session is saved and ready to sync to the dashboard.
6. Exit the app when finished — tap the ⋮ (three-dot) menu in the top-right corner and select Exit App. This properly disconnects the Polar H10 sensor and closes the app cleanly, so the next launch can reconnect without issues.

2. Recording a Session

The Monitor tab is where you start, stop, and manage live recordings.

Starting a Session

1. Ensure the Polar H10 is connected (heart rate displayed on screen).
2. Tap the Activity dropdown to select your activity type (e.g. Resting, Walking, Running, Gym).
3. Press START SESSION. The ECG waveform and live metrics appear.
4. Optional: Tap Flag Event to log a symptom or feeling. You can also double-tap the sensor to mark an event when getting your phone out isn't easy, such as while riding a bike.

Stopping a Session

1. Press STOP SESSION. A confirmation dialog appears.
2. Choose your export scope:
   • Full Data — raw ECG + HR + all events (larger file, full analysis).
   • Events Only — just detected anomalies with ECG snippets (compact, fast to load).
3. Tap Confirm. The session is saved to the database and auto-exported.

Special Activity Modes

Certain activities trigger specialised measurement overlays automatically:

• HRV & RHR — starts a 60-second controlled measurement for resting HR and HRV. See Section 3.
• Cool Down — starts a 60-second heart rate recovery measurement. See Section 4.
• Meditation — opens the meditation duration and sound type picker. See Section 5.
• Sleeping — activates the sleep analysis pipeline (motion + HRV + respiratory rate).

3. Taking an HRV & RHR Measurement

Your morning HRV and resting heart rate are the most important baselines for tracking your cardiovascular health over time.

How to measure

1. Put on the chest strap and open the app first thing in the morning, before getting out of bed or having coffee.
2. Select the HRV & RHR activity from the Activity dropdown.
3. A 60-second overlay appears with a countdown timer. Stay still and breathe normally.
4. When the timer completes, your Resting HR and RMSSD (HRV) are saved automatically.
5. These values are written to the [SECTION:HEALTH_METRICS] section of every subsequent session export and displayed in the dashboard's Physiology card on the Summary tab.

For the science behind HRV, RMSSD, and why morning measurements matter, see The Science → HRV & RHR Baselines.

4. Measuring Heart Rate Recovery (Cool Down)

Heart Rate Recovery (HRR) shows how quickly your heart returns to baseline after exertion — a key indicator of cardiovascular fitness.

How to measure

1. During or immediately after a hard effort (e.g. running, cycling), select the Cool Down activity from the Activity dropdown.
2. The app records your current heart rate as your peak HR.
3. A 60-second overlay appears with a countdown timer and live BPM display. Keep moving gently or stand still.
4. When the timer completes, your recovery HR is recorded and the HRR percentage is calculated automatically.
5. The result is saved in the session metadata and displayed in the dashboard's Spot Measurements card.

Auto Cool Down Detect (optional)

Enable Auto Cool Down Detect in Settings → Event Recording to start the HRR measurement without reaching for your phone. When enabled, two independent triggers are armed during a recording in an exertion activity (Cardio, Gym, Running, Walking, Vo2Max, Other):

1. Double-tap (immediate) — tap your chest strap twice to signal intent, then:

1. Movement stops — the strap's accelerometer detects a dramatic drop in movement within ~10 seconds of the tap.
2. Heart rate falls — your HR drops by ≥5 bpm within the same window, confirming physiological recovery has begun.

2. Passive (no tap needed) — if you simply stop moving during an exertion activity for about 10 seconds, the activity switches to Cool Down immediately. The trigger is self-correcting: if you start moving again within the confirmation window (a traffic-light stop or a rest between sets) the activity automatically reverts to what it was, and the trigger re-arms. If you stay still but your heart rate never falls by ≥15% of your heart-rate reserve (minimum 10 bpm) within ~75 seconds, it reverts too — so the feature assumes stopping during vigorous exercise means the effort is over. If your session is intentionally stop-and-start, switch to Cool Down manually instead.

If the tap-path conditions are met, or the passive path qualifies, the activity switches to Cool Down automatically and the 60-second HRR overlay starts immediately. You can still abort via the overlay's Abort button. If the movement or HR conditions aren't met (e.g. you tapped but kept moving), the tap is logged as a normal event instead.

Only one auto-trigger fires per session, so interval-training rest periods won't produce repeated prompts. The peak HR is captured from your live heart rate at the moment movement stops — close enough to your actual exercise cessation that the HRR percentage remains clinically faithful.

For the HRR formula and interpretation ranges, see The Science → Heart Rate Recovery.

5. Starting a Meditation Session

The Android app includes a physiology-driven soundscape engine: your chest strap's accelerometer tracks your breathing, your heart rate and beat-to-beat (RR) intervals measure heart–breath coupling, and a spatial audio renderer answers in real time. The goal is to actively improve your HRV by guiding your breathing toward a resonance frequency of about 6 breaths per minute — and the sound tells you when you get there.

How to start

1. Open the Android app and select the Meditation activity from the Activity dropdown.
2. A duration picker appears with a grouped soundscape dropdown. Choose a duration (1, 5, 15 minutes, or open-ended).
3. Pick a soundscape — grouped by what drives the sound:
   • Guided breathing — Resonance I–III (a shimmer that blooms when your heart & breath synchronise, at three difficulty levels) and Breath Shepherd (a guide tone that meets your breath and slows it toward ~6/min).
   • Breath-reactive — Ocean Breath, Moonlit Shore, Expanding Space — the sound expands through space as you inhale and contracts as you exhale.
   • Your heartbeat — Inner Pulse, Lub-Dub Heart, Endless Descent, Heart Keys — your pulse as taps, lub-dub pairs, a descending tone staircase, or an HRV melody.
   • Brainwave tones — Theta Drift, Alpha Calm, Sleep Drift — binaural entrainment carriers (headphones recommended).
4. Put on headphones if you have them — every soundscape is rendered on a 3D soundstage around your head, and the spatial effect (sound starting close in front of you and expanding outward with each breath) is mostly lost on the phone speaker.
5. Press Start. The timer appears with live breathing rate feedback.
6. During the session, use the sound dropdown to switch soundscapes at any time.
7. Press Stop Session when done, or the abort control to cancel without saving.

For the science behind biofeedback and coherence training, see The Science → Biofeedback & Coherence.

How to Use Each Sound Mode

Mode	Sound follows	Your goal	Cue for success
Resonance I–III	Heart–breath coupling (per-breath HR range)	Sustain synchrony at ~6 br/min	The shimmer blooms — and stays while you stay coupled
Breath Shepherd	Your real breathing rate, then a decelerating guide	Follow the guide down toward ~6 br/min	The sound leads; you follow it slower
Ocean Breath / Moonlit Shore / Expanding Space	Your breath phase (ACC)	Smooth, rolling breath cycles	Sound expands with the inhale, contracts on exhale
Inner Pulse / Lub-Dub Heart	Your live beats (RR intervals)	Awareness of your own rhythm	Taps / lub-dub pairs timed to each real beat
Endless Descent	Heartbeat-stepped tone staircase	Settle toward stillness	The tone descends one step per heartbeat
Heart Keys	Your HRV (RR variability)	Smooth, healthy variability	A pentatonic melody drifts with your beat-to-beat changes
Theta / Alpha / Sleep Drift	Fixed binaural carriers	Brainwave entrainment (headphones)	Steady detuned tones; Sleep Drift fades as you settle

Resonance I–III — the flagship

A shimmer is hidden inside a quiet room ambience — and it only blooms when your heart and breath synchronise. The app measures the peak-to-peak swing of your heart rate within each breath (respiratory sinus arrhythmia, the same amplitude HRV biofeedback uses) and rewards coupling with sound: the stronger the synchrony, the brighter the shimmer. Three levels set how much coupling the reward demands — I is welcoming, II needs steady slow breathing, III only answers sustained resonance breathing around 6 br/min. Work your way up as the coupling becomes familiar.

Breath Shepherd

A guide tone that first meets your actual breathing rate, then gradually decelerates toward ~6 breaths per minute — it leads, you follow. If tracking is lost, the pacer waits for your breath to reappear rather than marching on without you.

Breath-reactive spaces

Ocean Breath, Moonlit Shore and Expanding Space put the soundscape in front of you: it starts close and narrow on the inhale, expands through 3D space as the breath peaks, then contracts and returns on the exhale. On headphones this reads as the world breathing with you.

Your heartbeat

Inner Pulse and Lub-Dub Heart play your real pulse — a tap or a lub-dub pair on every detected beat, preserving your true inter-beat timing. Endless Descent steps an endlessly falling tone one notch per heartbeat. Heart Keys turns your beat-to-beat variability into a pentatonic melody — the rises and falls you hear are literally your HRV.

Brainwave tones

Theta Drift, Alpha Calm and Sleep Drift are classic binaural entrainment — slightly detuned carriers per ear targeting theta/alpha/delta states (headphones recommended). Sleep Drift additionally fades itself to near-silence once your breathing settles into a sleep-like rhythm.

Reading the Meditation Tab Charts

The Meditation tab in the web dashboard shows several charts to help you understand your session:

• RMSSD / BPM / Breathing Rate chart (top) — Shows how your heart rate variability (RMSSD), heart rate (BPM), and breathing rate changed over the session. The dashed line at 6 br/min is the target breathing rate for resonance.
• RSA Amplitude chart (second) — Shows the amplitude of Respiratory Sinus Arrhythmia (the heart rate oscillation driven by breathing). Higher amplitude = stronger vagal tone = better coherence. The orange line shows cardio-respiratory coherence percentage (0–100%); aim for >50%.
• Breathing Waveform chart (third) — Shows the actual filtered respiratory signal at breath level. Each peak is the end of an inhale, each trough is the end of an exhale. Triangle markers show detected breath onsets. This lets you see individual breaths, breath-to-breath variability, and whether your breathing is smooth or irregular.
• Poincaré Plot (analytics card) — Plots each RR interval against the next one. SD1 (perpendicular spread) measures vagal tone — higher is better. SD2 (along the identity line) measures overall variability. The SD1/SD2 ratio indicates sympathovagal balance.
• Breathing Distribution (analytics card) — A histogram of your breathing rates during the session. The teal bars (5–7 br/min) are the resonance zone. The percentage shows how much time you spent in that zone.

Breathing Data: Epochs vs Waveform

The app records breathing data at two levels of detail:

• 30-second epochs — A summary breathing rate (breaths/min) computed every 30 seconds by fusing ECG-Derived Respiration (EDR) and accelerometer data. Used for trend lines, coherence scoring, and the breathing rate overlay on the main chart.
• Breathing waveform — The actual filtered respiratory signal sampled at 5 Hz, showing individual inhale/exhale cycles. Available in the Meditation and Sleep tabs, and as a "Breath Wave" overlay on the main chart (sleep/meditation sessions only). This lets you see breath-level detail: individual breaths, breath-to-breath variability, and phase timing.
• Breath cycles — Per-breath records with inhale duration, exhale duration, and amplitude. Shown as triangle markers on the breathing waveform chart.

Both levels are available for meditation and sleep activities. The waveform data is stored in the CSV export as [SECTION:BREATHING_WAVEFORM] and [SECTION:BREATH_CYCLES].

6. Running a VO2 Max Test

The Android app includes a guided submaximal VO2 max test for the treadmill. It pairs the Polar H10's precise heart rate and RR-interval data with the speed and incline you enter from the treadmill's console, then applies the ACSM metabolic equations to estimate your maximal oxygen uptake (VO2 max).

How to Run the Test

1. Put on the Polar H10 chest strap and connect it to the app.
2. Select the Vo2Max activity from the Activity dropdown (it's a protected activity, shown in cyan alongside Meditation and Sleeping).
3. The parameter page appears. Set:
   • Protocol — Walking, Running, or Auto (Auto picks the equation by speed: walking below 8 km/h, running at/above 8 km/h).
   • Treadmill Speed — the speed you'll set on the treadmill (km/h).
   • Incline — the treadmill grade (%).
   • Steady-State Duration — how long the countdown will run (seconds, minimum 120). 300 (5 min) is a good default.
   • Target HR Zone — the zone the coaching cues will guide you toward (Z1-Z5).
   Your profile (age, weight, resting HR, max HR, sex) is shown for reference and pulled from Settings.
4. Press Start Test. The guided page appears with a countdown timer.
5. Get on the treadmill, set it to your planned speed and incline, and walk/run at a constant pace.
6. Watch the coaching cue — it tells you to "Increase pace" or "Decrease pace" based on whether your live HR is below or above your target zone.
7. When you've been at a steady pace for the full duration, the countdown reaches zero and the app auto-captures. You can also tap Capture Now early if you feel you've reached steady state.
8. The machine values prompt appears. Confirm or adjust the speed and incline to match what the treadmill console actually showed (in case the knob was slightly off).
9. Press Confirm. The app calculates your VO2 max and shows a completion flash with the estimate, range, and test parameters.
10. Press Done. The session is saved and appears in History.

For the science behind the ACSM equations and estimation methods, see The Science → VO2 Max Metrics.

7. Phone App UI Reference

The interactive controls in the Your Rhythm Monitor Android app are grouped by screen below. The list is generated from phoneUiControls.json.

💻 Web Dashboard

7. Reviewing a Session on the Dashboard

Once you've loaded a session into the Cardio Dashboard, here's how to explore and interpret the results:

Loading a Session

1. Open the Sessions panel in the left sidebar.
2. Click any session card to load it into the dashboard.
3. The Summary tab opens first, showing key metrics: duration, event counts, HR stats, HRV, and the rhythm diagnosis.

Navigating the ECG

• Switch to the Charts tab to see the full ECG waveform.
• Use the segment toolbar at the top to jump between 10-minute segments (00:00, 10:00, 20:00…).
• Use the mouse wheel to zoom in and out on the chart. The chart auto-switches between envelope view (zoomed out) and individual samples (zoomed in). The segment toolbar has RESET and AUTO-Y buttons to reset the view and toggle automatic Y-axis scaling.
• Use the Event Navigation Bar on the right side to jump to detected events (see Section 9).

Reading the Summary

• The Narrative Summary card at the top provides a plain-language overview of the session's key findings.
• The Physiology card shows your Resting HR and Measured HRV with status indicators.
• The HR Spark card displays a mini heart-rate trend chart with average, min, and max BPM.
• The Zones card shows time spent in each heart-rate training zone.
• The Data Quality card reports signal quality, noise percentage, and coverage.
• The Insights card highlights notable patterns (e.g. high noise, ectopic burden, activity context).
• The Clinical Findings card lists each detected arrhythmia type with its event count.
• The Activity & Intensity card breaks down time spent in each activity label.

Exploring Other Tabs

After the Summary tab, switch between these tabs depending on what you want to see:

• Charts — the full interactive ECG waveform with overlays (see below).
• Metrics — all 99 health metrics with reliability grade badges (A–D). Each metric has a checkbox — check a metric to make it appear in the Trends tab, uncheck to hide it. Use Check All / Uncheck All to bulk-toggle. See Section 18 for the grading system.
• HRV — appears for sessions with HRV & RHR, Meditation, or Sleeping activities. Shows all three HRV domains (time domain, Poincaré plot, frequency domain) in one place with visual charts and good/bad reference range indicators on every metric. Thresholds are age-adjusted when age is available from session metadata.
• Sleep — appears automatically for sleep sessions. Shows sleep stage analysis, overnight HRV, breathing patterns, and movement detection.
• Meditation — appears automatically for meditation sessions. Shows meditation playback, RSA amplitude, breathing waveform, and Poincaré plot.

Using the Viz-Bar Toggles

The vertical button bar on the right side of the chart lets you toggle overlays and layout options. The left side shows data overlays (only available when the session contains that data type); the right side shows layout controls:

• ECG — the raw ECG electrical signal (green trace)
• BPM — heart rate trace (red)
• HRV — HRV (RMSSD) trend (green)
• Motion — accelerometer magnitude (orange)
• Events — vertical markers for detected arrhythmias (yellow)
• Activity — coloured background bands for activity types (purple)
• Breathing — breathing rate trend derived from RSA (red-orange)
• Smooth — apply smoothing filter to the ECG trace
• PQRST — PQRST annotation markers on the waveform (pink)
• Grid — clinical ECG calibration grid (orange)
• Split — switch between single and split-panel layouts
• HUD — floating heads-up display with real-time stats
• Hover — detailed hover labels with precise values and timestamps

For the full list of dashboard controls, see Section 12: UI Controls Reference.

8. Reading the ECG Chart

Trace Colours by Rhythm

Colour	Label	Meaning
■	Normal	Normal sinus rhythm
■	AFIB	Atrial fibrillation — irregular R-R, absent P-waves
■	VT	Ventricular tachycardia
■	PVC	Premature ventricular contraction — wide, bizarre QRS, arrives early
■	PAC	Premature atrial contraction — normal-shaped QRS but arrives early
■	Ectopic	Generic premature beat (low-confidence PVC/PAC classification)

Overview Envelope

When viewing a full session or a 10-minute segment at full zoom-out, the chart switches from individual samples to an envelope view — a shaded band showing the signal's min/max range per time bin. This preserves performance for long recordings while still showing overall signal quality and events.

The envelope automatically switches back to individual ECG samples when you zoom in to less than ~1 minute (60 seconds) of data.

9. Event Navigation

The Event Navigation Bar appears at the right side of the segment toolbar. Each button corresponds to a detected or user-marked event in the session.

• Click once — Jumps to the first occurrence and zooms in to ~10 seconds of ECG
• Click again — Cycles to the next occurrence of the same event type
• After the last occurrence it wraps back to the first

10. Activity Tracking

Activity labels are sourced from the activity column in your recording CSV. The default activity labels in the phone app are: Resting, Walking, Running, Cardio, Gym, HRV & RHR, Cool Down, Sitting, Sleeping, Driving, Meditation, Vo2Max, Other. You can customise this list in the phone app's Settings, though protected activities (HRV & RHR, Cool Down, Sleeping, Meditation, Vo2Max) cannot be removed.

Activity regions appear as labelled, coloured panels in the Activity bar at the bottom of the chart. Toggle with the Activity button in the viz-bar.

Activity context is also used internally by the HRV engine — periods where mean BPM exceeds 100 are detected as exercise and marked as unreliable in the HRV trend (excluded from resting HRV calculations), since elevated heart rate from exertion does not reflect true autonomic tone.

11. Exporting from Dashboard

The Export panel in the left sidebar lets you create two outputs for any loaded session: a formatted clinical PDF report and a lightweight raw CSV. Use the PDF when you want a professional, human-readable summary; use the CSV when you only need the basic session metadata.

Before You Export

1. Load a session from the Sessions panel.
2. Review the Session Summary on the Dashboard tab. The PDF pulls its clinical findings from the summary narrative, so make sure it reflects what you want to share.
3. If any events look wrong, use the Re-Classify option in the Analysis panel first. The PDF exports the current view, not a fresh analysis.

Export a Clinical PDF

1. Click the Export button in the left sidebar to open the Export panel.
2. Click Export as PDF. A new PDF Preview tab opens with the formatted report.
3. Review the report contents:
   • Section 1: Session Information - date, duration, detected event count, user event count
   • Section 2: Rhythm Diagnosis - overall rhythm classification (e.g. Normal Sinus Rhythm, AFIB)
   • Section 3: Heart Rate Statistics - average, minimum, and maximum BPM, plus ectopic count
   • Section 4: HRV Metrics - RMSSD, SDNN, and pNN50 values (when available)
   • Section 5: Event Type Breakdown - count of each detected event type (PVC, PAC, AFIB, etc.)
   • Section 6: Clinical Findings Summary - narrative summary and tally of detected arrhythmias
   • Section 7: ECG Event Segments - 10-second ECG strips (5 s before and 5 s after each event), labelled with event type, timestamp and RR interval
4. Click Save PDF to download the file, or Print to send it directly to a printer. The file is named <session-name>_clinical_report.pdf.
5. Click Discard or close the tab when you are done. No file is saved unless you choose Save PDF or Print.

Export Raw CSV Data

1. Click the Export button in the left sidebar.
2. Click Export Raw CSV. A small CSV file downloads immediately, named <session-name>_raw.csv.
3. The CSV contains one row per session: session name, date, duration in minutes, sample rate, patient ID, device and start time. It does not include the full raw ECG waveform.

Export Trends PDF

1. Click the Export button in the left sidebar to open the Export panel.
2. Click Export Trends PDF. If the Trends tab is not currently open, you'll be asked whether to open it now — choose OK to load the trends log (this also picks up any newly added sessions).
3. The currently visible page of the trends table is downloaded as trends_YYYY-MM-DD.pdf, with category headers, metric labels, grade badges and session date columns. Only metrics you've checked in the Metrics tab are included. The sparkline column is omitted from the PDF.
4. If the trends log is empty, you'll see a "No trends data to export." message. Add sessions to the trends log from the Trends tab first.

What Each Export Is Useful For

Export	Best for	Contains	Does not contain
Clinical PDF	Sharing with a clinician, coach or keeping a human-readable record	Session summary, narrative, ECG strips for every detected event	Full raw ECG data
Raw CSV	Importing into a spreadsheet or electronic record	Basic session metadata	Clinical narrative or ECG waveforms
Trends PDF (Export panel)	Long-term tracking across many sessions	Structured table with aggregated HR, HRV and event counts for the visible page	Individual ECG event strips, sparkline trend lines

12. UI Controls Reference

The interactive controls in the dashboard are grouped below. The list is generated from uiControls.json.

🔗 Shared / General

13. Getting Sessions into the Dashboard

The dashboard connects to your phone over Wi-Fi and lets you choose whether to transfer sessions to this PC or stream them directly from the phone. You configure this in the Setup panel in the left sidebar.

Connecting to the Phone

Use this when your recorded sessions are still on the YourRhythm phone app. The phone app serves the dashboard directly to a PC, tablet, or Chromebook on the same Wi-Fi and supplies the complete address to use.

1. Open YourRhythm on your phone.
2. Tap the More tab and switch Wi-Fi Server ON in the CONNECTIONS card.
3. Tap Dashboard URL, then tap Copy.
4. Paste the copied URL into the browser on your PC, tablet, or Chromebook.
5. Sessions appear automatically — the dashboard connects to the phone and lists your sessions in the sidebar. No setup panel configuration is needed.

Understanding the CSV File

Each exported session is a plain-text CSV file using Schema v7. It contains multiple sections with all your recording data:

Section	Contains
[SECTION:METADATA]	Session identity & device info: report title, date, start time, duration, event counts, patient ID, age, sex, height, device ID, firmware, HR zone boundaries, rhythm diagnosis, CSV schema version, export scope
[SECTION:HEALTH_METRICS]	All 99 health metrics with values, units, reliability grades (A–D), and category labels. Includes heart rate, HRV, rhythm events, HR zones, respiratory, sleep, meditation, user profile, training load, and longitudinal trends. See Section 18 for details.
[SECTION:ACTIVITY_REGIONS]	Activity type regions with start/end times (Resting, Walking, Running, etc.)
[SECTION:ANALYTICS]	Rhythm tally, activity tally, BPM statistics, and sample counts
[SECTION:EVENTS]	All detected cardiac events with timestamps, types, feelings, and RR intervals
[SECTION:BREATHING_EPOCHS]	30-second breathing rate epochs with confidence scores and EDR/ACC fusion weights
[SECTION:BREATHING_WAVEFORM]	Filtered respiratory signal at 5 Hz showing individual breath cycles (sleep & meditation sessions)
[SECTION:BREATH_CYCLES]	Per-breath records with inhalation/exhalation duration and amplitude (sleep & meditation sessions)
[SECTION:RAW_ECG]	Full raw recording: ECG signal (130 Hz), BPM, RR intervals, accelerometer, breathing rate, activity labels, event markers, and noise flags. In Events Only mode, contains high-resolution ECG strips around each event.
[SECTION:OVERVIEW_1HZ]	Downsampled 1 Hz overview for fast loading (optional, included in some export modes)

The exported file is a plain-text CSV — you can open it in any text editor (Notepad, TextEdit, VS Code, Excel) to see exactly what's inside. It contains no sensitive data: just your heart rate, ECG samples, activity labels, and detected events. There are no passwords, account details, or personal identifiers beyond the patient ID you set yourself. It's your data — keep it, share it, delete it, or analyse it in any tool you like.

Heart Rate Recovery in Exports

When you perform a Cool Down measurement on the phone, the result is written to the [SECTION:HEALTH_METRICS] section of the CSV:

• spot_hrr (%) — Relative recovery: ((peak HR − recovery HR) / peak HR) × 100.
• spot_hrr_start_bpm — The peak heart rate at the moment Cool Down was selected (or auto-triggered via Auto Cool Down Detect).
• spot_hrr_score — Composite score based on the raw BPM drop, age, fitness, and recovery velocity.

The dashboard reads these automatically and displays them in the Spot Measurements card on the Metrics tab.

Resting Heart Rate & HRV in Exports

When you perform an "HRV & RHR" measurement session on the phone, the resulting values are written to the [SECTION:HEALTH_METRICS] section of every subsequent export:

• spot_rhr (bpm) — Your baseline resting heart rate, used for Karvonen zone calculations.
• spot_hrv (ms) — Your RMSSD value from the 60-second measurement protocol.

The Cardio Dashboard reads these automatically and displays them in the Physiology card on the Summary tab. The status indicators show:

Colour	RHR Meaning	HRV Meaning
Green	<60 bpm — Athletic	>50 ms — Excellent
Blue	60-72 bpm — Good	30-50 ms — Good
Amber	73-80 bpm — Average	20-30 ms — Fair
Red	>80 bpm — Elevated	<20 ms — Low

Troubleshooting

Problem	Cause	Solution
"Connection Failed"	Phone and PC not on same network	Check both are on the same Wi-Fi (not mobile data, not guest network)
"No Sessions Found"	No exported CSVs on phone	Record a session and export it first, or check Documents/YourRhythm-Data folder exists
"No Wi-Fi connection" on phone	Phone on mobile data only	Connect phone to Wi-Fi. The server needs a local network to work.
Phone IP keeps changing	Router assigns dynamic IPs	Check the Dashboard URL in the phone app's More tab (CONNECTIONS card) each time, or set a static IP on your phone/router
Can't connect at all	Network blocks device-to-device traffic	Some corporate/guest Wi-Fi blocks this. Use your home network instead.
CSV loads but shows no data	File may be an older format	Re-export the session from the phone app to get the latest format

14. Heart Rate Zones

The dashboard and phone app divide your effort into 5 training zones based on your maximum heart rate. Zone data is sourced from the zone column in your CSV and displayed in the Zones card on the Summary tab, which shows the time spent in each zone as a proportion of the session.

Zone boundaries are calculated automatically from your age and resting HR using the Karvonen method, but can be manually adjusted in the phone app's Settings → Heart Rate Zones section.

For the full zone definitions, formula, and exercise physiology, see The Science → Training Zones.

15. Interpreting Your Results

Here's a plain-language guide to the terms you'll see in your session reports. For the full technical detail, see The Science page.

Common Arrhythmia Terms

Term	What it means	Should I worry?
Normal Sinus Rhythm	Your heart is beating in a normal, regular pattern.	No — this is the expected result.
PVC (Premature Ventricular Contraction)	A beat starts early from the ventricles instead of the sinus node. It looks wide and bizarre on the ECG.	Occasional PVCs are common and usually benign. Frequent PVCs (>10% of beats) should be discussed with a doctor.
PAC (Premature Atrial Contraction)	A beat starts early from the atria. It looks normal in shape but arrives too soon.	Similar to PVCs — occasional PACs are common and usually harmless.
AFIB (Atrial Fibrillation)	The atria quiver instead of contracting normally. Detected when 5 or more consecutive heartbeats have irregular R-R intervals with no alternating pattern — distinguishing it from isolated ectopic beats (1–3 irregular) or bigeminy (alternating pattern).	AFIB is a significant finding. If detected, consult your doctor for a formal evaluation.
Bigeminy	Every normal beat is followed by a premature beat (e.g. N-PVC-N-PVC pattern).	Can be bothersome but is usually benign. If persistent or symptomatic, seek medical advice.
Trigeminy	Every two normal beats are followed by a premature beat (e.g. N-N-PVC pattern).	Similar to bigeminy — usually benign but worth monitoring.
VT (Ventricular Tachycardia)	A rapid, wide-complex rhythm originating in the ventricles. A medical emergency if sustained.	Seek immediate medical attention if sustained (>30 seconds).
Pause	A gap between beats longer than expected, often following a premature beat (compensatory pause).	Usually benign in the context of ectopic beats. Isolated pauses >3 seconds should be evaluated.
Apnea	A detected pause in breathing during sleep, inferred from HRV and heart rate patterns.	If frequent, consider a sleep study evaluation.
NOISE / ARTIFACT	The signal was too noisy to classify — caused by movement, poor contact, or interference.	Not a cardiac event. Try adjusting the strap or reducing movement.

16. Help me make it better

The arrhythmia detection pipeline in Your Rhythm Studio is trained on open-access clinical ECG databases — but very little real-world ECG data exists for many arrhythmia types recorded from a Polar H10 chest strap. Most public datasets come from 12-lead clinical Holter monitors, not a single-lead consumer sensor. That gap matters: the more real Polar H10 recordings I can learn from, the better the detection gets for everyone.

If you felt something — a palpitation, a flutter, a missed beat — and the app didn't flag it, or if it flagged something you didn't feel, that's exactly the kind of case that helps me improve. You can submit a session for review directly from the phone app:

1. Open the session in History → Session Detail.
2. Tap the ⋮ menu → Submit for Review.
3. Choose Missed Event (you felt it, app didn't catch it), False Alarm (app flagged it, you didn't feel it), or General (just sharing a session with events).
4. Add an optional note and tap Submit.

The app generates a full CSV with your raw ECG and the detected events, and attaches it to an email pre-addressed to me. You can review the attachment before sending. No data is sent without your explicit action — nothing uploads automatically.

17. Contact

Email Address: YourRhythm101@gmail.com

Visit my website at YourRhythm.co.uk

18. Health Metrics & Reliability Grading

YourRhythm computes 99 health metrics across 15 categories. Each metric is assigned a reliability grade (A–D) so you know how much to trust each value. The Metrics tab (phone and web) shows every metric with its grade badge.

Using the Metrics Tab

The web dashboard's Metrics tab displays all 99 health metrics grouped by category, each with a coloured grade badge and a checkbox:

• Grade badge — the coloured circle (A green, B blue, C amber, D red) shows the reliability grade. Hover for the grade description.
• Checkbox — check a metric to make it appear in the Trends tab; uncheck to hide it. Unchecked metrics appear dimmed at 60% opacity.
• Check All / Uncheck All — bulk-toggle all 99 metrics at once. Useful for starting fresh or selecting everything.
• Value & unit — the right side of each card shows the metric's value with its unit (e.g. 62 bpm, 45.2 ms).

Your checkbox selections are saved automatically and persist across sessions. The Trends tab shows only the metrics you've checked here — see Section 12: Trends Tab for the full trends workflow.

The Grading System

Grade	Meaning	Examples
A	Direct measurement — exact inputs, validated formula, minimal error source. Trust the absolute value.	Session Duration, RHR, avg/min/max BPM, HR range, mean RR, RMSSD, SD1, SDNN, pNN50, CV, SD1/SD2 Ratio, %HRR, Total Heart Beats, spot RHR/HRV, HRR start BPM, bradycardia count, breathing confidence, samples, epochs, EDR/ACC weights, fusion stability, meditation duration/avg BPM/final RMSSD, breath pacing adherence, sleep HRV (RMSSD/SDNN/SD2/pNN50), BMI, BSA, BMI Category, RHR/HRV/HRR Trends
B	Validated estimation — derived from measured data with established algorithms. Absolute values are approximate; trends are reliable.	BMR, Frequency-domain HRV (Total/VLF/LF/HF Power, nLF, nHF, LF/HF Ratio), HRV Triangular Index, TINN, Baevsky SI, %HRmax, PVC Burden, PVC/hour, Ectopic Burden, Arrhythmia-Free Survival, ectopic/pause/bigeminy/trigeminy counts & burdens, HR Zones 1–5, TRIMP, ACWR, HRR %, HRR score, breathing rate (mean/min/max), Breathing Irregularity, I:E Ratio, Breathing Category, HRV Coherence, Resonance Frequency, sleep HRV trend slope, nocturnal HR dip, movement count
C	Trend-reliable only — the absolute value depends on assumptions or population averages. Track changes over time, not the number itself.	CTL, ATL, TSB (training load EWMA — sensitive to history window assumptions), AFIB/VT/apnea counts, AFIB burden %, AHI, apnea severity
D	Experimental — research-stage metric. Use with caution; interpretation may change as algorithms improve.	Sleep stage minutes (total, light, deep, REM, wake), sleep efficiency — estimated from HR/movement patterns, not polysomnography

Key Principle: Trends vs Absolute Values

Grade B and C metrics are more reliable for tracking trends than for absolute values. For example, your LF/HF ratio might not be an exact number (it depends on resampling and windowing choices), but if it consistently rises over weeks during stress, that trend is meaningful. Always compare apples to apples: same activity type, same time of day, same measurement protocol.

Metric Categories

• Session — Session Duration (total recording length)
• Heart Rate — RHR, avg/min/max BPM, HR range, mean RR (basic heart rate statistics)
• HRV — RMSSD, SD1 (session-level HRV from spot measurement or sleep fallback)
• HRV Time Domain — SDNN, RMSSD, pNN50, CV (statistical properties of RR intervals)
• HRV Poincaré — SD1, SD2, SD1/SD2 Ratio (geometric analysis of beat-to-beat variability)
• HRV Frequency Domain — Total/VLF/LF/HF Power, nLF, nHF, LF/HF Ratio, HRV Triangular Index, TINN, Baevsky SI (spectral analysis via Welch's method)
• Heart Rate Intensity — %HRmax, %HRR, Total Heart Beats (effort and cardiac cost)
• Spot Measures — spot RHR, spot HRV, HRR %, HRR start BPM, HRR score (dedicated measurement protocols)
• Rhythm Events — ectopic, AFIB, VT, pause, bigeminy, trigeminy, bradycardia, apnea counts; ectopic total, ectopic/AFIB burden %, total rhythm events, user events
• Arrhythmia Burden — PVC Burden, PVC/hour, Ectopic Burden, Arrhythmia-Free Survival (derived burden metrics)
• HR Zones — Zone 1–5 time in minutes (time spent in each heart rate zone)
• Training Load — TRIMP, ACWR, CTL, ATL, TSB (Banister training impulse model)
• Respiratory — mean/min/max breathing rate, Breathing Irregularity Index, I:E Ratio, Breathing Category (EDR/ACC fusion)
• Data Quality — breathing confidence, total samples, breathing rate variability, total/high-quality epochs, EDR/ACC weights, fusion stability
• Meditation — duration, avg BPM, final RMSSD, HRV Coherence Ratio, Breath Pacing Adherence, Resonance Frequency
• Sleep — sleep HRV (RMSSD/SDNN/SD2/pNN50/trend slope), total/light/deep/REM/wake minutes, sleep efficiency, nocturnal HR dip, movement count, AHI, apnea severity, nocturnal RMSSD, nocturnal HR dipping
• User Profile — BMI, BMI Category, BMR, BSA (derived from your height, weight, age, sex)
• Longitudinal Trends — RHR Trend, HRV Trend, HRR Trend (7-day regression slopes)

For the mathematical methodology behind each metric, see The Science → Health Metrics Methodology.

Troubleshooting

If you're experiencing issues, you can download your error logs to help me diagnose the problem:

Download Error Logs

Logs are stored locally in your browser and include the last 10 sessions. Sensitive data (file paths, IPs, emails) is automatically redacted.