Overview
AFib Tracker supports importing and exporting your episode data in CSV format. This allows you to:
- Backup your data
- Share information with healthcare providers
- Migrate data between devices
- Analyze your data in other tools
Regular CSV Format
The regular CSV format contains episode data with basic tracking information. This is the standard format exported when you use the "Export Episodes" option in Settings.
CSV Columns
| Column | Required | Description | Format | Example |
|---|---|---|---|---|
| Date | Required | The date the episode started | YYYY-MM-DD | 2024-01-15 |
| Start Time | Required | Time when episode began (24-hour format) | HH:mm | 09:30 |
| End Time | Optional | Time when episode ended (leave empty if ongoing) | HH:mm | 10:45 |
| Duration (minutes) | Optional | Total duration in minutes (calculated if End Time provided) | Number | 75 |
| Intensity | Optional | Severity level of the episode | Mild, Moderate, Severe | Moderate |
| Triggers | Optional | Possible triggers that may have contributed | Text (semicolon separated) | "Caffeine; Stress" |
| Medications | Optional | Medications taken during the episode | Text (semicolon separated) | "Metoprolol; Aspirin" |
| Notes | Optional | Additional observations or symptoms | Text (in quotes) | "Chest tightness, irregular heartbeat" |
Important Notes
- Date and Time: All times are in 24-hour format (HH:mm)
- Empty Fields: For ongoing episodes, leave End Time and Duration empty
- Quoting: Fields containing commas must be enclosed in double quotes
- Escaping: Double quotes within fields should be doubled (e.g.,
""Hello"") - Semicolons: Use semicolons to separate multiple values in Triggers and Medications fields
Sample CSV
Here's a sample CSV file with realistic data:
Date,Start Time,End Time,Duration (minutes),Intensity,Triggers,Medications,Notes
2024-01-15,09:30,10:45,75,Moderate,"Caffeine; Stress","Metoprolol; Aspirin","Chest tightness, irregular heartbeat"
2024-01-16,14:20,,,"Severe","Alcohol","","Palpitations, dizziness"
2024-01-17,08:15,09:00,45,Mild,"Sleep deprivation","","Mild fluttering sensation"
2024-01-18,11:30,12:15,45,Moderate,"","Ibuprofen","Better after rest"
2024-01-19,16:45,17:30,45,Severe,"Exercise; Dehydration","","Worst episode this week"
2024-01-20,10:00,11:15,75,Mild,"","","Good sleep last night"Extended CSV Format (Timeline)
The app also supports an extended CSV format that includes both episodes and notes in a timeline view. This format includes:
- Type: "Episode" or "Note"
- Category: For notes (e.g., "Symptom", "Observation", "Concern")
- All other fields: Same as regular format for episodes
Importing CSV Data
To import your CSV data:
- Go to Settings in the app
- Tap on Import Data
- Choose your CSV file from your device
- The app will automatically detect the format and preview the data
- Review the preview and tap Import to confirm
Warning
Importing CSV data will add to your existing episodes. To start fresh, consider exporting your current data first, then use Settings → Manage Data → Delete All Episodes.
Tips for Best Results
- Keep it Consistent: Use the same format for all imports
- Backup First: Always export your data before importing new data
- Use Clear Notes: Write specific, descriptive notes for better pattern recognition
- Track Everything: Even small episodes can reveal important patterns
- Regular Exports: Export your data weekly as a backup